Установка в Google Cloud
Развёртывание ScanSuite Teams в собственном проекте Google Cloud на Cloud Run с помощью Terraform, с примерами установки.
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 CLI | gcloud --version | Google Cloud SDK и номер версии |
| Terraform 1.6 или новее | terraform version | Terraform 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.me | IPv4-адрес |
Если проект ещё не создан, создайте его и привяжите к нему платёжный аккаунт в консоли 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:
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). Каждая команда открывает браузер, где вы выбираете свою учётную запись:
gcloud auth login
gcloud auth application-default login
gcloud config set project <PROJECT_ID>Проверьте:
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_id | ID вашего проекта. | обязательно |
| 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, и в файл настроек он не попадает:
read -rsp 'Registry access token: ' TF_VAR_dockerhub_token; echo; export TF_VAR_dockerhub_token
./deploy.shДо того как что-либо создавать, скрипт проверяет вход в Google Cloud, биллинг проекта и лицензию. Затем он создаёт Artifact Registry проекта и находит точные образы для кода вашей лицензии; создаёт сеть, базу данных, Redis, хранилище и секреты и выполняет миграцию базы данных; после этого запускает сервисы, балансировщик и мониторинг. Повторный запуск безопасен на любом этапе.
Ожидаемый результат: вывод заканчивается строкой ==> Done, значениями выводов и списком Next. Проверьте, что страница начальной настройки отвечает:
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-провайдера — без контейнеров сканеров анализ выполняет модель, так что этот шаг обязателен. В меню пользователя (справа вверху) откройте Настройки системы → Общие сервисы:
- AI-подключения → Добавить подключение. Для Vertex AI в этом проекте: Тип Vertex AI (Claude), ID проекта Google Cloud
<PROJECT_ID>, Регион Vertex AI, где доступна модель (например,europe-west1илиglobal), и включите Использовать учётную запись самого развёртывания (без ключа): у сервисного аккаунта установки уже есть роль Vertex AI User. Подойдёт и любой интерфейс типа OpenAI-compatible; сканирования обращаются к нему с адресов из выводаscan_egress_ips. Нажмите Сохранить. - AI-модели → Добавить модель: Название, Подключение, ID модели (ID модели Claude). Нажмите Сохранить.
- Маршрутизация задач → Изменение в строке По умолчанию → Первая модель → Сохранить.
- Системный ИИ → Проверить подключение. Ожидаемый результат: Ответ за N с: …
Перед проверкой включите модель Claude для проекта в консоли Google Cloud в разделе Vertex AI → Model Garden; так вы принимаете условия поставщика модели.
Все поля и маршрутизация по задачам описаны в разделе Поставщики ИИ и стоимость. Затем переходите к разделу Быстрый старт.
Собственный домен
Если задан domain_name, интерфейс получает сертификат, выпущенный Google, как только имя начинает указывать на балансировщик:
Направьте DNS-запись A для <YOUR_DOMAIN> на значение вывода load_balancer_ip. С manage_dns = true зону и запись создаст развёртывание, а вам останется делегировать зону у регистратора.
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. Пробная установка
Небольшие размеры без резервных копий, интерфейс открыт для одного адреса — примерно вдвое дешевле настроек по умолчанию:
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, оповещения и защита от случайного удаления:
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, где все строки ниже приведены с комментариями:
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 и резервной копии базы данных:
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), и задайте свой префикс, чтобы все ресурсы получили собственные имена:
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 тогда не нужны:
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 резервирует имя удалённого экземпляра примерно на неделю. Чтобы развернуть установку заново в этот срок, задайте базе данных другое имя:
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; также влияет на некоторые размеры. | prod | dev для пробной установки. |
| platform | cloudrun или gke — для регионального кластера GKE Standard с теми же образами. | cloudrun | Только если нужен контроль на уровне узлов или более долгий период завершения, чем позволяет Cloud Run; см. параметры GKE ниже. |
| timezone | Часовой пояс контейнеров; по нему запускаются запланированные сканирования. | Europe/Moscow | Всегда: укажите свой. |
| alert_email | Куда отправляются оповещения. | нет: оповещения без канала | Производственная установка. |
| deletion_protection | Cloud SQL и сервисы нельзя удалить ничем, кроме destroy.sh. | false | true для производственной установки. |
Доступ
| Параметр | Что делает | По умолчанию | Когда менять |
|---|---|---|---|
| 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_mode | nat: Cloud NAT на постоянных адресах. none: маршрута в интернет нет; API Google через Private Google Access. | nat | none для примера C (только Cloud Run). |
| nat_ip_count | Сколько постоянных исходящих адресов зарезервировать. | 2 | Не меняйте их: именно их разрешают git-серверы и AI-провайдеры. |
| google_apis_vip | При egress_mode = none: private (все API Google) или restricted (VPC Service Controls). | private | restricted внутри периметра. |
| 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 | Резервная база данных в другой зоне. | true | false для пробной установки: примерно вдвое дешевле. |
| redis_memory_gb | Объём Memorystore в ГБ. | 4 | 1 для пробной установки. |
| redis_ha | Реплика Redis с автоматическим переключением. | true | false для пробной установки. |
| redis_tls | Шифрование трафика к Redis. Изменение пересоздаёт экземпляр и теряет задачи в очереди. | true | Только когда не идёт ни одно сканирование. |
| artifact_retention_days | Сколько дней хранятся прежние версии сохранённых артефактов. | 30 | Ваша политика хранения. |
| artifact_bucket_force_destroy | Разрешить удалению стирать бакет артефактов вместе с содержимым. | false | Не трогайте: его задаёт destroy.sh --delete-artifacts. |
Ресурсы Cloud Run
| Параметр | Что делает | По умолчанию | Когда менять |
|---|---|---|---|
| scan_cpu | vCPU на сканирование, не больше 8. | 4 | Очень большие репозитории. |
| scan_memory | Память на сканирование, не больше 32Gi. Клон репозитория хранится в памяти и учитывается в ней. | 16Gi | Очень большие репозитории. |
| scan_task_timeout_seconds | Максимальная длительность сканирования. | 172800 (48 часов) | Редко. |
| web_min_instances | Постоянно прогретые экземпляры веб-интерфейса. | 1 | 0 экономит деньги; первый вход после перерыва ждёт холодного старта. |
| web_max_instances | Максимум экземпляров веб-интерфейса. | 4 | Много одновременных пользователей. |
| admin_instances | Экземпляры фонового воркера. | 1 | Редко. |
| poc_replicas | Песочницы для проверок proof-of-concept. | 2 | 1 для пробной установки. |
Сканирования и ключи 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_token | deploy.sh | Токен доступа к реестру. Вводит человек, в файле не хранится. |
| TF_VAR_project_id | deploy.sh | Проект — вместо project_id в terraform.tfvars. |
| SOURCE_REGISTRY_USERNAME, SOURCE_REGISTRY_TOKEN | deploy.sh | Учётная запись, под которой deploy.sh копирует образы из source_registry; после этого выполняется выход. |
| LOCAL_IMAGES=1 | deploy.sh | Загрузить образы из локального Docker, а не читать их из реестра. |
| MIGRATE=1 | deploy.sh | Выполнить миграцию базы данных, даже если образы не изменились. Она отменяет идущие сканирования. |
| дополнительные аргументы | deploy.sh, destroy.sh | Передаются terraform. |
| -y, --yes | destroy.sh | Не спрашивать ID проекта. |
| --delete-artifacts | destroy.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 или командами:
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 SQL | 200–250 | 50–70 |
| Memorystore | 150–200 | 35–45 |
| Сервисы Cloud Run | 300–400 | 200–250 |
| Балансировщик, Cloud Armor, Cloud NAT | 50–80 | 50–80 |
| Хранилище, секреты, реестр, журналы | 10–30 | 10–30 |
| Сканирования, по 4 vCPU и 16 ГиБ | около 0,5 за час сканирования | так же |
10. Удаление
Удаление стирает базу данных со всеми данными сканирований. Решение запустить destroy.sh принимает человек, и он же вводит ID проекта, когда скрипт его спросит.
./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