Развёртывание

Установка в Google Cloud

Развёртывание ScanSuite Teams в собственном проекте Google Cloud на Cloud Run с помощью Terraform, с примерами установки.

Открыть в Markdown

ScanSuite Teams можно развернуть не на сервере, а в собственном проекте Google Cloud. Конфигурация Terraform из папки gcp репозитория установки создаёт всё одной командой и удаляет другой. Приложение работает в Cloud Run вместе с управляемыми сервисами, так что обслуживать виртуальную машину не нужно. Первое развёртывание занимает 20–30 минут.

Охват: статический анализ

В Cloud Run нет демона Docker, поэтому сканеры, которые запускаются отдельными контейнерами, — динамическое сканирование веб-приложений (DAST), сканирование инфраструктуры и AI-пентест — здесь не работают. Анализ кода (SAST), зависимостей (SCA), инфраструктуры как кода, поиск секретов и AI-анализ кода работают полностью. Для остальных видов сканирования установите ScanSuite на сервер: Установка ScanSuite Teams.

Что создаётся

Всё размещается в одном проекте. Пароли генерируются при первом развёртывании и хранятся в Secret Manager; у базы данных и Redis только внутренние адреса; образы читаются через Artifact Registry проекта и закреплены по точным дайджестам.

ЧастьКак работает
Веб-интерфейс и APIСервис Cloud Run за внешним HTTPS-балансировщиком с Cloud Armor, который пропускает только ваши диапазоны адресов.
Фоновые воркерыПулы воркеров Cloud Run: обслуживание и восстановление прерванных сканирований, планировщик и песочница для AI-проверок proof-of-concept.
СканированияОтдельный запуск задания Cloud Run на каждое сканирование, 4 vCPU и 16 ГиБ; после сканирования он завершается.
Миграция базы данныхЗадание Cloud Run, которое deploy.sh запускает до старта сервисов.
База данныхCloud SQL для PostgreSQL 16, внутренний IP, ежесуточные резервные копии (хранятся 14) и восстановление на момент времени в пределах 7 дней.
Очередь задачMemorystore для Redis, внутренний IP, TLS.
Артефакты сканированийБакет Cloud Storage; прежние версии хранятся 30 дней.
Исходящий трафикCloud NAT на постоянных адресах — для списков разрешённых адресов на git-сервере и у AI-провайдера.
МониторингПроверка доступности и оповещения об ошибках, сбоях загрузки, нагрузке на базу данных и Redis.

1. Перед началом

УсловиеПроверкаОжидаемый результат
Проект Google Cloud с подключённым биллингомgcloud billing projects describe <PROJECT_ID> --format='value(billingEnabled)'True
Ваша учётная запись — Owner или Editor вместе с Project IAM Admin (развёртывание создаёт сервисные аккаунты и выдаёт им роли)gcloud projects get-iam-policy <PROJECT_ID> --flatten=bindings --filter='bindings.members:user:<YOUR_ACCOUNT>' --format='value(bindings.role)'roles/owner или roles/editor и roles/resourcemanager.projectIamAdmin
Google Cloud CLIgcloud --versionGoogle Cloud SDK и номер версии
Terraform 1.6 или новееterraform versionTerraform v1.6.0 или новее
git, bash и curl (Linux, macOS или Windows с WSL или Git Bash)git --version; bash --version | head -1; curl --version | head -1по строке с версией для каждого
Файл лицензии, имя пользователя и токен доступа к реестру из заказа—См. шаг 2
Ваш публичный IPv4-адрес или диапазоны, с которых разрешено открывать веб-интерфейсcurl -4 -s https://ifconfig.meIPv4-адрес

Если проект ещё не создан, создайте его и привяжите к нему платёжный аккаунт в консоли Google Cloud (Billing). Проще всего отвести под ScanSuite отдельный проект.

Поручите агенту подготовить развёртывание
По инструкции https://scansuite.ru/documentation/installation/install-on-google-cloud проверь мои предварительные требования, напиши terraform.tfvars для <пробной|производственной> установки в проекте <PROJECT_ID> с моим IPv4-адресом в web_allowed_cidrs, выполни terraform init и terraform plan и покажи мне оба результата. Не запускай ./deploy.sh и ./destroy.sh, пока я не скажу. Вход в Google Cloud и экспорт токена реестра я выполню сам; никогда не спрашивай у меня токен.

Вставьте его в Claude Code или другой ИИ-агент для разработки. Подробнее — в разделе Работа с ИИ-агентами.

Обозначения на этой странице:

ОбозначениеОткуда взять
<PROJECT_ID>ID вашего проекта: gcloud projects list.
<YOUR_ACCOUNT>Учётная запись Google, под которой вы разворачиваете: gcloud config get-value account.
<LICENCE_CODE>Шесть символов после последнего подчёркивания в имени файла лицензии, <имя>_<LICENCE_CODE>.lic. Это же и тег образов.
<REGISTRY_USER>Имя пользователя реестра, присланное с заказом.
<YOUR_IPV4>Вывод curl -4 -s https://ifconfig.me или диапазоны вашего офиса и VPN.
<YOUR_DOMAIN>Необязательно: имя, по которому открывается интерфейс, например scansuite.example.com.

2. Загрузите файлы установки

Загрузите файлы, добавьте лицензию и перейдите в папку gcp:

bash
git clone https://github.com/cepxeo/scansuite.git
cp /path/to/<имя>_<LICENCE_CODE>.lic scansuite/key/
cd scansuite/gcp
ls ../key/*.lic

Ожидаемый результат: в списке ровно один файл .lic. Если их несколько, укажите в pyarmor_license_file тот, что соответствует image_tag.

3. Войдите в Google Cloud

Войдите дважды: один раз для gcloud, второй — для Terraform (Application Default Credentials). Каждая команда открывает браузер, где вы выбираете свою учётную запись:

bash
gcloud auth login
gcloud auth application-default login
gcloud config set project <PROJECT_ID>

Проверьте:

bash
gcloud config get-value account
gcloud auth application-default print-access-token >/dev/null && echo ADC ok

Ожидаемый результат: ваша учётная запись, затем ADC ok.

4. Задайте настройки

Скопируйте пример настроек и отредактируйте копию. Готовые примеры — в разделе 7, все параметры перечислены в справочнике параметров.

Терминал
cp terraform.tfvars.example terraform.tfvars
ПараметрЧто указатьПо умолчанию
project_idID вашего проекта.обязательно
regionРегион. Для другого региона задайте также zones и primary_zone (пример D).europe-west3
image_tagКод вашей лицензии.обязательно
dockerhub_usernameИмя пользователя реестра из заказа.обязательно
web_allowed_cidrsДиапазоны адресов, с которых открывается интерфейс, до 10, например ["203.0.113.10/32"]. Задайте до первого развёртывания: страница начальной настройки достаётся тому, кто первым её откроет.открыто для всего интернета
timezoneЧасовой пояс, по которому запускаются запланированные сканирования, например Europe/Moscow.Europe/Moscow
alert_emailАдрес для оповещений.нет

Предварительный просмотр, который ничего не меняет (необязательно):

Терминал
terraform init && terraform plan

Ожидаемый результат: Plan: N to add, 0 to change, 0 to destroy. Для просмотра токен реестра не нужен.

5. Разверните

./deploy.sh создаёт и изменяет ресурсы без дополнительных вопросов: запуск скрипта и есть согласие. Введите токен доступа к реестру в оболочку сами — он хранится в Secret Manager, читать его может только Artifact Registry, и в файл настроек он не попадает:

bash
read -rsp 'Registry access token: ' TF_VAR_dockerhub_token; echo; export TF_VAR_dockerhub_token
./deploy.sh

До того как что-либо создавать, скрипт проверяет вход в Google Cloud, биллинг проекта и лицензию. Затем он создаёт Artifact Registry проекта и находит точные образы для кода вашей лицензии; создаёт сеть, базу данных, Redis, хранилище и секреты и выполняет миграцию базы данных; после этого запускает сервисы, балансировщик и мониторинг. Повторный запуск безопасен на любом этапе.

Ожидаемый результат: вывод заканчивается строкой ==> Done, значениями выводов и списком Next. Проверьте, что страница начальной настройки отвечает:

bash
terraform output url
curl -sk -o /dev/null -w '%{http_code}\n' "$(terraform output -raw url)/setup"

Ожидаемый результат: адрес, затем 200. Новый балансировщик может начать отвечать только через 5–10 минут; до этого проверка может вывести 404 или завершиться ошибкой — подождите и повторите.

6. Войдите и подключите AI

Сразу откройте адрес из вывода url и создайте первую учётную запись на странице начальной настройки, придумав пароль сами, — так же, как на сервере, см. шаг «Создайте первую учётную запись» в разделе об установке ScanSuite Teams на сервер. Без доменного имени это IP-адрес балансировщика с самоподписанным сертификатом, поэтому браузер один раз выдаст предупреждение. Учётная запись достаётся тому, кто первым откроет страницу.

Поля и проверки те же, что на сервере: Установка ScanSuite Teams, шаг 5. Затем подключите AI-провайдера — без контейнеров сканеров анализ выполняет модель, так что этот шаг обязателен. В меню пользователя (справа вверху) откройте Настройки системы → Общие сервисы:

  1. AI-подключения → Добавить подключение. Для Vertex AI в этом проекте: Тип Vertex AI (Claude), ID проекта Google Cloud <PROJECT_ID>, Регион Vertex AI, где доступна модель (например, europe-west1 или global), и включите Использовать учётную запись самого развёртывания (без ключа): у сервисного аккаунта установки уже есть роль Vertex AI User. Подойдёт и любой интерфейс типа OpenAI-compatible; сканирования обращаются к нему с адресов из вывода scan_egress_ips. Нажмите Сохранить.
  2. AI-модели → Добавить модель: Название, Подключение, ID модели (ID модели Claude). Нажмите Сохранить.
  3. Маршрутизация задач → Изменение в строке По умолчанию → Первая модель → Сохранить.
  4. Системный ИИ → Проверить подключение. Ожидаемый результат: Ответ за N с: …

Перед проверкой включите модель Claude для проекта в консоли Google Cloud в разделе Vertex AI → Model Garden; так вы принимаете условия поставщика модели.

Все поля и маршрутизация по задачам описаны в разделе Поставщики ИИ и стоимость. Затем переходите к разделу Быстрый старт.

Собственный домен

Если задан domain_name, интерфейс получает сертификат, выпущенный Google, как только имя начинает указывать на балансировщик:

Направьте DNS-запись A для <YOUR_DOMAIN> на значение вывода load_balancer_ip. С manage_dns = true зону и запись создаст развёртывание, а вам останется делегировать зону у регистратора.

bash
dig +short <YOUR_DOMAIN>
terraform output -raw load_balancer_ip
gcloud compute ssl-certificates list --project <PROJECT_ID>

Ожидаемый результат: дважды один и тот же адрес и статус сертификата ACTIVE — он появляется в течение часа после того, как имя начнёт разрешаться.

7. Примеры установки

Примеры A, B и C — готовые файлы terraform.tfvars; D–G — строки, которые добавляются к одному из них. Токен реестра всегда передаётся через оболочку, как в шаге 5.

A. Пробная установка

Небольшие размеры без резервных копий, интерфейс открыт для одного адреса — примерно вдвое дешевле настроек по умолчанию:

terraform.tfvars
project_id  = "acme-scansuite-trial"
region      = "europe-west3"
environment = "dev"

image_tag          = "a1b2c3"
dockerhub_username = "<REGISTRY_USER>"

web_allowed_cidrs = ["203.0.113.10/32"]
timezone          = "Europe/Moscow"

# Меньше производственных размеров и без резервных копий.
cloudsql_ha      = false
cloudsql_tier    = "db-custom-1-3840"   # 1 vCPU, 3,75 ГБ
cloudsql_disk_gb = 20
redis_ha         = false
redis_memory_gb  = 1
poc_replicas     = 1

Когда пробный период закончится, ./destroy.sh --delete-artifacts удалит всё, включая сохранённые артефакты сканирований.

B. Производственная установка

Размеры по умолчанию (база данных и Redis с резервными копиями), собственный домен с сертификатом, выпущенным Google, оповещения и защита от случайного удаления:

terraform.tfvars
project_id  = "acme-scansuite"
region      = "europe-west3"
environment = "prod"

image_tag          = "a1b2c3"
dockerhub_username = "<REGISTRY_USER>"

domain_name       = "scansuite.acme.example"
web_allowed_cidrs = ["198.51.100.0/24", "203.0.113.10/32"]   # офис и VPN
timezone          = "Europe/Moscow"
alert_email       = "secops@acme.example"

deletion_protection = true

После первого развёртывания направьте домен на балансировщик, как описано выше в разделе Собственный домен. Прежде чем развёртыванием займётся кто-то ещё, перенесите состояние Terraform в бакет Cloud Storage, как описано в backend.tf.example.

C. Без доступа из интернета

Для корпоративной сети, связанной с VPC проекта через VPN, Interconnect или Network Connectivity Center. Балансировщика и маршрута в интернет нет: интерфейс доступен по адресу Cloud Run только изнутри сети, к API Google (Vertex AI, Cloud Storage) установка обращается через Private Google Access, а образы копируются из вашего собственного реестра. Начните с terraform.tfvars.internal.example, где все строки ниже приведены с комментариями:

terraform.tfvars
project_id          = "acme-scansuite"
region              = "europe-west3"
environment         = "prod"
deletion_protection = true

internal_only   = true
egress_mode     = "none"
google_apis_vip = "restricted"         # "private" вне периметра VPC Service Controls

# Из корпоративного адресного плана: не должны ни с чем там пересекаться.
subnet_cidr = "10.120.0.0/24"
psa_cidr    = "10.120.16.0/20"

# Внутренние имена, которые разрешают сканирования (ваши git-серверы), передаются корпоративным DNS-серверам.
dns_forwarding_zones   = { "corp.example." = ["10.0.0.53", "10.0.1.53"] }
dns_inbound_forwarding = true

image_tag       = "a1b2c3"
source_registry = "registry.corp.example/scansuite"

timezone    = "Europe/Moscow"
alert_email = "secops@acme.example"

Перед ./deploy.sh экспортируйте в оболочке SOURCE_REGISTRY_USERNAME и SOURCE_REGISTRY_TOKEN (робот-аккаунт вашего реестра) так же, как токен в шаге 5. После развёртывания ваша сетевая команда:

  • маршрутизирует диапазон из вывода google_apis_range из корпоративной сети в эту VPC;
  • настраивает корпоративные DNS-серверы так, чтобы они пересылали run.app на адреса, которые выводит команда из dns_inbound_forwarders_command, — тогда браузеры внутри сети смогут разрешить адрес из вывода url.

web_allowed_cidrs и domain_name не используются, а оповещение о недоступности не создаётся: зонды Google не могут достучаться до внутреннего адреса. Сканирования обращаются к внутренним узлам с адресов подсети, а вывод scan_egress_ips пуст.

D. Другой регион

Задавайте регион вместе с его зонами: от зон зависит размещение Redis и резервной копии базы данных:

terraform.tfvars
region       = "europe-west4"
zones        = ["europe-west4-a", "europe-west4-b", "europe-west4-c"]
primary_zone = "europe-west4-b"

E. Вторая установка в том же проекте

Например, тестовая рядом с производственной. Разворачивайте её из отдельной копии папки, чтобы у неё было своё состояние Terraform (cp -r scansuite/gcp scansuite/gcp-test), и задайте свой префикс, чтобы все ресурсы получили собственные имена:

terraform.tfvars
name_prefix = "scansuite-test"

Префикс лучше делать коротким: бакет артефактов называется <name_prefix>-artifacts-<project_id>, не длиннее 63 символов.

F. Образы из собственного реестра

Если установка вообще не должна обращаться к Docker Hub, раз в релиз скопируйте три образа в реестр проекта командой ./scripts/mirror-images.sh <PROJECT_ID> <LICENCE_CODE> [регион] [репозиторий] (регион по умолчанию — europe-west3, репозиторий — scansuite; нужен Docker с входом в Docker Hub под пользователем реестра). Скрипт выведет строки для добавления; image_tag и dockerhub_username тогда не нужны:

terraform.tfvars
image_web        = "europe-west3-docker.pkg.dev/acme-scansuite/scansuite/teams-web:a1b2c3"
image_worker     = "europe-west3-docker.pkg.dev/acme-scansuite/scansuite/teams-worker:a1b2c3"
image_worker_poc = "europe-west3-docker.pkg.dev/acme-scansuite/scansuite/teams-worker-poc:a1b2c3"

G. Повторное развёртывание вскоре после удаления

Cloud SQL резервирует имя удалённого экземпляра примерно на неделю. Чтобы развернуть установку заново в этот срок, задайте базе данных другое имя:

terraform.tfvars
cloudsql_name = "scansuite-pg-2"

8. Справочник параметров

Все параметры terraform.tfvars. Чтобы изменить параметр, отредактируйте файл и снова запустите ./deploy.sh.

Проект и размещение

ПараметрЧто делаетПо умолчаниюКогда менять
project_idПроект, в который выполняется развёртывание.обязательно—
regionРегион.europe-west3Другой регион; вместе с ним задайте zones и primary_zone.
zonesЗоны региона, в которых размещаются Redis и резервная копия базы данных.europe-west3-a, -b, -cВместе с region.
primary_zoneОсновная зона.europe-west3-bВместе с region.
name_prefixПрефикс имён всех ресурсов.scansuiteВторая установка в проекте (пример E).
environmentМетка всех ресурсов: dev, stage или prod; также влияет на некоторые размеры.proddev для пробной установки.
platformcloudrun или gke — для регионального кластера GKE Standard с теми же образами.cloudrunТолько если нужен контроль на уровне узлов или более долгий период завершения, чем позволяет Cloud Run; см. параметры GKE ниже.
timezoneЧасовой пояс контейнеров; по нему запускаются запланированные сканирования.Europe/MoscowВсегда: укажите свой.
alert_emailКуда отправляются оповещения.нет: оповещения без каналаПроизводственная установка.
deletion_protectionCloud SQL и сервисы нельзя удалить ничем, кроме destroy.sh.falsetrue для производственной установки.

Доступ

ПараметрЧто делаетПо умолчаниюКогда менять
web_allowed_cidrsДиапазоны, которые пропускает балансировщик, не больше 10.пусто: весь интернетВсегда, до первого развёртывания.
domain_nameИмя узла интерфейса, с сертификатом, выпущенным Google.нет: IP-адрес балансировщика с самоподписанным сертификатомПроизводственная установка.
manage_dnsСоздать зону Cloud DNS и запись A для domain_name; зону делегируете вы.falseВаш DNS находится в этом проекте.
internal_onlyБез балансировщика; интерфейс по адресу Cloud Run, только для внутренних клиентов.falseБез доступа из интернета (пример C). Только Cloud Run.

Образы и лицензия

ПараметрЧто делаетПо умолчаниюКогда менять
image_tagКод вашей лицензии: тег трёх образов.обязательно, если не заданы все три image_web, image_worker и image_worker_pocКаждый новый релиз.
dockerhub_usernameИмя пользователя реестра из заказа.нет—
dockerhub_tokenТокен доступа к реестру. Передавайте его в оболочке как TF_VAR_dockerhub_token, никогда не в файле.нет—
image_sourceПространство имён Docker Hub, из которого берутся образы.appsec4uНе меняйте.
image_repositoryОткуда читаются образы, вплоть до имени образа.удалённый репозиторий перед Docker HubЗадаёт deploy.sh при LOCAL_IMAGES=1.
source_registryВаш собственный реестр, из которого копируются образы, например registry.corp.example/scansuite.нетНет доступа к Docker Hub (пример C).
source_image_namesИмена образов в source_registry, если они отличаются.teams-web, teams-worker, teams-worker-pocВ вашем реестре они называются иначе.
image_web, image_worker, image_worker_pocПолные ссылки на образы, используются как есть.вычисляютсяЗеркалированные образы (пример F).
image_digestsЗаписывает deploy.sh в images.auto.tfvars.json.—Никогда вручную.
key_dirПапка с файлом лицензии.../keyЛицензия лежит в другом месте.
pyarmor_license_fileИмя файла лицензии в key_dir.единственный .lic тамВ key_dir их несколько.

Сеть

ПараметрЧто делаетПо умолчаниюКогда менять
egress_modenat: Cloud NAT на постоянных адресах. none: маршрута в интернет нет; API Google через Private Google Access.natnone для примера C (только Cloud Run).
nat_ip_countСколько постоянных исходящих адресов зарезервировать.2Не меняйте их: именно их разрешают git-серверы и AI-провайдеры.
google_apis_vipПри egress_mode = none: private (все API Google) или restricted (VPC Service Controls).privaterestricted внутри периметра.
subnet_cidrПодсеть.10.10.0.0/20Если VPC связана с корпоративной сетью.
psa_cidrДиапазон для Cloud SQL и Memorystore, не меньше /24.10.30.0.0/16Как subnet_cidr.
dns_forwarding_zonesВнутренние домены, запросы к которым передаются вашим DNS-серверам, например { "corp.example." = ["10.0.0.53"] }.нетСканированиям нужно разрешать имена внутренних git-серверов.
dns_inbound_forwardingВходящие DNS-серверы пересылки, на которые ваши DNS-серверы пересылают run.app.falseПример C.

База данных, Redis и хранилище

ПараметрЧто делаетПо умолчаниюКогда менять
cloudsql_nameИмя экземпляра Cloud SQL.<name_prefix>-pgПовторное развёртывание в течение недели после удаления (пример G).
cloudsql_tierТип машины Cloud SQL.db-custom-2-8192 (2 vCPU, 8 ГБ)Меньше для пробной установки, больше для множества команд.
cloudsql_disk_gbДиск базы данных в ГБ; растёт автоматически.100Меньше для пробной установки.
cloudsql_haРезервная база данных в другой зоне.truefalse для пробной установки: примерно вдвое дешевле.
redis_memory_gbОбъём Memorystore в ГБ.41 для пробной установки.
redis_haРеплика Redis с автоматическим переключением.truefalse для пробной установки.
redis_tlsШифрование трафика к Redis. Изменение пересоздаёт экземпляр и теряет задачи в очереди.trueТолько когда не идёт ни одно сканирование.
artifact_retention_daysСколько дней хранятся прежние версии сохранённых артефактов.30Ваша политика хранения.
artifact_bucket_force_destroyРазрешить удалению стирать бакет артефактов вместе с содержимым.falseНе трогайте: его задаёт destroy.sh --delete-artifacts.

Ресурсы Cloud Run

ПараметрЧто делаетПо умолчаниюКогда менять
scan_cpuvCPU на сканирование, не больше 8.4Очень большие репозитории.
scan_memoryПамять на сканирование, не больше 32Gi. Клон репозитория хранится в памяти и учитывается в ней.16GiОчень большие репозитории.
scan_task_timeout_secondsМаксимальная длительность сканирования.172800 (48 часов)Редко.
web_min_instancesПостоянно прогретые экземпляры веб-интерфейса.10 экономит деньги; первый вход после перерыва ждёт холодного старта.
web_max_instancesМаксимум экземпляров веб-интерфейса.4Много одновременных пользователей.
admin_instancesЭкземпляры фонового воркера.1Редко.
poc_replicasПесочницы для проверок proof-of-concept.21 для пробной установки.

Сканирования и ключи AI

ПараметрЧто делаетПо умолчаниюКогда менять
enable_static_scansСтатический анализ.TrueНе трогайте.
enable_dynamic_scansДинамические и инфраструктурные сканирования, которым нужен демон Docker, а в этом развёртывании его нет.FalseНе трогайте.
llm_service_account_emailДругой сервисный аккаунт, которому выдаются роли Vertex AI и доступа к бакету.нетТолько если Vertex AI нужно вызывать с ключом другого сервисного аккаунта, а не от имени самого развёртывания.
llm_sa_key_fileПуть к файлу ключа этого сервисного аккаунта; файл монтируется для приложения.нетКак выше.
llm_sa_key_b64Тот же ключ в base64. Лучше используйте llm_sa_key_file или добавьте версию секрета сами, чтобы ключ не попал в состояние Terraform.нетКак выше.

Только для GKE (platform = "gke")

ПараметрЧто делаетПо умолчаниюКогда менять
master_authorized_cidrsДиапазоны, которым разрешён доступ к плоскости управления кластера.адрес, с которого вы запускаете TerraformРазвёртывание из конвейера.
enable_secrets_encryptionДополнительно шифровать секреты Kubernetes ключом Cloud KMS.falseЭтого требует ваша политика.
pods_cidr, services_cidr, master_cidrДиапазоны адресов кластера.10.20.0.0/14, 10.24.0.0/20, 172.16.0.0/28Они пересекаются с вашей сетью.
general_machine_typeМашины для веб-интерфейса и планировщика.e2-standard-2Много пользователей.
scan_engine_machine_typeМашины для воркеров сканирования.n2-standard-4Большие репозитории.
worker_replicasВоркеры сканирования; каждый ведёт одно сканирование за раз.1Больше параллельных сканирований.
poc_machine_typeМашины для песочницы proof-of-concept.e2-standard-2Редко.
scratch_disk_gbРабочее место для сканирований на один воркер, в ГБ.200Большие репозитории.
image_pull_registryРеестр, в который входит секрет загрузки образов.Docker HubОбразы из вашего собственного реестра.

Переменные окружения и параметры скриптов

Переменная или параметрГде используетсяЧто делает
TF_VAR_dockerhub_tokendeploy.shТокен доступа к реестру. Вводит человек, в файле не хранится.
TF_VAR_project_iddeploy.shПроект — вместо project_id в terraform.tfvars.
SOURCE_REGISTRY_USERNAME, SOURCE_REGISTRY_TOKENdeploy.shУчётная запись, под которой deploy.sh копирует образы из source_registry; после этого выполняется выход.
LOCAL_IMAGES=1deploy.shЗагрузить образы из локального Docker, а не читать их из реестра.
MIGRATE=1deploy.shВыполнить миграцию базы данных, даже если образы не изменились. Она отменяет идущие сканирования.
дополнительные аргументыdeploy.sh, destroy.shПередаются terraform.
-y, --yesdestroy.shНе спрашивать ID проекта.
--delete-artifactsdestroy.shУдалить и бакет артефактов вместе с сохранёнными артефактами сканирований.

Выводы

terraform output выводит их в любой момент; terraform output -raw <имя> выводит один.

ВыводЧто это
urlАдрес ScanSuite.
load_balancer_ipАдрес балансировщика, для DNS-записи. Пуст при internal_only.
scan_egress_ipsПостоянные адреса, с которых уходят сканирования и запросы к AI, — для списков разрешённых адресов. Пуст при egress_mode = none.
google_apis_rangeПри egress_mode = none: диапазон, который нужно маршрутизировать из корпоративной сети.
dns_inbound_forwarders_commandВыводит адреса, на которые ваши DNS-серверы пересылают run.app.
artifact_bucketБакет с артефактами сканирований.
secret_namesЗаписи Secret Manager со сгенерированными паролями.
migrate_job_name, migrate_commandЗадание миграции и команда, которая его запускает.
imagesТочные образы, на которых работают сервисы.
artifact_registry_urlКуда загружаются зеркалированные образы (пример F).

9. Повседневная работа

  • Изменить настройку: отредактируйте terraform.tfvars и снова запустите ./deploy.sh. Пока образы не меняются, идущие сканирования продолжаются.
  • Новый релиз: положите новый .lic в ../key/ и удалите старый, задайте в image_tag новый код, выполните git pull, а затем ./deploy.sh. Миграция отменяет незавершённые сканирования, поэтому обновляйтесь, когда сканирований нет.
  • Прерванные сканирования восстанавливаются сами: сканирование, запуск которого остановился, 90 минут не показывает прогресса, а затем запускается заново.
  • Загрузка через браузер в Cloud Run ограничена 32 МиБ; код большего объёма сканируйте из git-репозитория.
  • Ваш адрес сменился, и интерфейс больше не открывается: обновите web_allowed_cidrs и запустите ./deploy.sh.
  • Журналы: в консоли в разделе Logging → Logs Explorer или командами:
bash
gcloud logging read 'resource.type="cloud_run_revision" AND resource.labels.service_name="scansuite-web"' --limit 50 --format='value(textPayload)'
gcloud logging read 'resource.type="cloud_run_job" AND resource.labels.job_name="scansuite-sast"' --limit 100 --format='value(textPayload)'
  • Резервные копии: Cloud SQL делает их каждую ночь и поддерживает восстановление на момент времени; восстанавливают в консоли в разделе SQL → Backups.
  • Берегите состояние Terraform: в terraform.tfstate хранятся сгенерированные пароли и ваша лицензия. Держите файл в закрытом месте, делайте резервную копию после каждого развёртывания и перенесите его в бакет Cloud Storage, прежде чем развёртывать будет второй человек или конвейер.

Ориентировочная стоимость в месяц, в долларах США; цены для своего региона уточните в калькуляторе Google Cloud:

СтатьяПо умолчаниюПробная (пример A)
Cloud SQL200–25050–70
Memorystore150–20035–45
Сервисы Cloud Run300–400200–250
Балансировщик, Cloud Armor, Cloud NAT50–8050–80
Хранилище, секреты, реестр, журналы10–3010–30
Сканирования, по 4 vCPU и 16 ГиБоколо 0,5 за час сканированиятак же

10. Удаление

Удаление стирает базу данных со всеми данными сканирований. Решение запустить destroy.sh принимает человек, и он же вводит ID проекта, когда скрипт его спросит.

bash
./destroy.sh                      # попросит ввести ID проекта
./destroy.sh --delete-artifacts   # удалить и сохранённые артефакты сканирований

Скрипт примерно за 15 минут удаляет всё, что создало развёртывание. Бакет с артефактами сканирований остаётся, если не указать --delete-artifacts. Если скрипт остановился на полпути, запустите его снова: он продолжит с оставшегося. Одна остановка — в порядке вещей: после удаления сервисов Cloud Run ещё до двух часов удерживает несколько адресов в сети, и освободить их может только Google. Скрипт сообщает об этом; за оставшееся на этот момент плата не начисляется. Убедитесь, что ничего не осталось: terraform state list тогда ничего не выводит.

Частые сообщения

billing is not enabled: подключите к проекту платёжный аккаунт. no licence in ../key/: положите туда свой .lic или задайте pyarmor_license_file. could not find teams-web:<код>: проверьте image_tag, dockerhub_username и токен. The Cloud SQL instance already exists: пример G. Ошибка зоны после смены региона: пример D. API «has not been used in project»: только что включённому API нужно несколько минут, запустите ./deploy.sh ещё раз. Страница не открывается: проверьте, что ваш адрес входит в web_allowed_cidrs; новый балансировщик начинает отвечать через 5–10 минут. Адрес открывает страницу входа, а не страницу начальной настройки: первую учётную запись создал кто-то другой — выполните ./destroy.sh и разверните заново с более узким web_allowed_cidrs. Миграция завершается ошибкой: прочитайте её журнал командой gcloud logging read 'resource.type="cloud_run_job" AND resource.labels.job_name="scansuite-migrate"' --limit 50 --format='value(textPayload)', устраните причину и снова запустите ./deploy.sh. Во всех остальных случаях сначала просто запустите ./deploy.sh ещё раз — каждый шаг можно безопасно повторить.

Проверено: 2026-10-19