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

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

Источник: https://scansuite.ru/documentation/installation/install-on-google-cloud
Проверено: 2026-10-19

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

> **Охват: статический анализ:** В Cloud Run нет демона Docker, поэтому сканеры, которые запускаются отдельными контейнерами, — динамическое сканирование веб-приложений (DAST), сканирование инфраструктуры и AI-пентест — здесь не работают. Анализ кода (SAST), зависимостей (SCA), инфраструктуры как кода, поиск секретов и AI-анализ кода работают полностью. Для остальных видов сканирования установите ScanSuite на сервер: [Установка ScanSuite Teams](https://scansuite.ru/documentation/installation/install-scansuite-server).

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

Всё размещается в одном проекте. Пароли генерируются при первом развёртывании и хранятся в 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 отдельный проект.

> **Промпт для агента: Поручите агенту подготовить развёртывание**
>
> ```text
> По инструкции 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 и экспорт токена реестра я выполню сам; никогда не спрашивай у меня токен.
> ```

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

| Обозначение | Откуда взять |
|---|---|
| <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](https://scansuite.ru/documentation/installation/install-on-google-cloud#examples), все параметры перечислены в [справочнике параметров](https://scansuite.ru/documentation/installation/install-on-google-cloud#settings-reference).

```bash
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 | Адрес для оповещений. | нет |

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

```bash
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](https://scansuite.ru/documentation/installation/install-scansuite-server), шаг 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; так вы принимаете условия поставщика модели.

Все поля и маршрутизация по задачам описаны в разделе [Поставщики ИИ и стоимость](https://scansuite.ru/documentation/usage/ai-providers). Затем переходите к разделу [Быстрый старт](https://scansuite.ru/documentation/quick-start).

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

Если задан `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; также влияет на некоторые размеры. | 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** или командами:

```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 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 проекта, когда скрипт его спросит.

```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` ещё раз — каждый шаг можно безопасно повторить.
