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

Установка в Microsoft Azure

Развёртывание ScanSuite Teams в собственной подписке Azure на Container Apps с помощью Terraform, с примерами установки.

Открыть в Markdown

ScanSuite Teams можно развернуть не на сервере, а в собственной подписке Azure. Конфигурация Terraform из папки azure репозитория установки создаёт всё одной командой и удаляет другой. Приложение работает в Azure Container Apps вместе с управляемыми сервисами, так что обслуживать виртуальную машину не нужно. Первое развёртывание занимает 30–40 минут.

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

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

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

Всё размещается в одной группе ресурсов, которую создаёт развёртывание. Секреты генерируются при первом развёртывании и хранятся в Key Vault. База данных доступна только изнутри виртуальной сети, а хранилище артефактов — только из подсети Container Apps, без ключей хранилища.

ЧастьКак работает
Веб-интерфейс и APIПриложение-контейнер с управляемым TLS; входящий трафик пропускается только с ваших диапазонов адресов.
Фоновые воркерыПриложения-контейнеры: обслуживание и восстановление прерванных сканирований, планировщик, Redis для очереди задач и песочница для AI-проверок proof-of-concept, которая запускается по требованию.
СканированияОтдельный запуск задания Container Apps на каждое сканирование, 4 vCPU и 8 ГиБ; после сканирования он завершается.
Миграция базы данныхЗадание Container Apps, которое запускает deploy.sh.
База данныхAzure Database for PostgreSQL 16 (Flexible Server), внутренняя; резервные копии за 7 дней, а с environment = "prod" — за 14 дней и зонально-избыточная резервная реплика.
Артефакты сканированийBlob Storage, доступ через управляемое удостоверение; прежние версии хранятся 30 дней.
ОбразыСобственный Azure Container Registry: во время работы установка ничего не загружает из интернета.
Журналы и оповещенияLog Analytics, по умолчанию не больше 1 ГБ в день. Оповещения об ошибках, неудачных сканированиях и нагрузке на базу данных создаются, только если задан alert_email.

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

УсловиеПроверкаОжидаемый результат
Azure CLI 2.60 или новееaz version --query '"azure-cli"' -o tsv2.60.0 или новее
Terraform 1.6 или новееterraform versionTerraform v1.6.0 или новее
git и bash (Linux, macOS или Windows с WSL или Git Bash)git --version; bash --version | head -1по строке с версией для каждого
Роль Owner в подписке или Contributor вместе с Role Based Access Control Administrator (развёртывание создаёт управляемые удостоверения, собственную роль и назначения ролей); проверяется после шага 3az role assignment list --assignee <YOUR_ACCOUNT> --scope /subscriptions/<SUBSCRIPTION_ID> --include-inherited --query "[].roleDefinitionName" -o tsvOwner или обе роли: Contributor и Role Based Access Control Administrator
Файл лицензии, имя пользователя и токен доступа к реестру из заказа—См. шаг 2
Ваш публичный IPv4-адрес или диапазоны, с которых разрешено открывать веб-интерфейсcurl -4 -s https://ifconfig.meIPv4-адрес; запрашивайте именно IPv4, иначе многие подключения покажут IPv6
Поручите агенту подготовить развёртывание
По инструкции https://scansuite.ru/documentation/installation/install-on-azure проверь мои предварительные требования, напиши terraform.tfvars для <пробной|производственной> установки в подписке <SUBSCRIPTION_ID> с моим IPv4-адресом в web_allowed_cidrs, выполни terraform init и terraform plan и покажи мне оба результата. Не запускай ./deploy.sh и ./destroy.sh, пока я не скажу. az login и экспорт DOCKERHUB_USERNAME и DOCKERHUB_TOKEN я выполню сам; никогда не спрашивай у меня токен.

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

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

ОбозначениеОткуда взять
<SUBSCRIPTION_ID>Подписка, в которую выполняется развёртывание: az account list -o table, столбец SubscriptionId.
<YOUR_ACCOUNT>Ваше имя для входа в Azure: az account show --query user.name -o tsv.
<LICENCE_CODE>Шесть символов после последнего подчёркивания в имени файла лицензии, <имя>_<LICENCE_CODE>.lic. Это же и тег образов.
<REGISTRY_USER>Имя пользователя реестра, присланное с заказом.
<YOUR_IPV4>Вывод curl -4 -s https://ifconfig.me или диапазоны вашего офиса и VPN.
<RESOURCE_GROUP>Значение resource_group_name, заданное в terraform.tfvars.
<RESOURCE>Для Azure OpenAI: имя вашего ресурса Azure OpenAI.

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

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

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

3. Войдите в Azure

Войдите в открывшемся браузере и выберите подписку:

bash
az login
az account set --subscription <SUBSCRIPTION_ID>

Проверьте:

Терминал
az account show --query "{subscription:id, user:user.name}" -o tsv

Ожидаемый результат: ID подписки и ваше имя для входа. Затем выполните проверку ролей из шага 1.

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

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

Терминал
cp terraform.tfvars.example terraform.tfvars
ПараметрЧто указатьПо умолчанию
subscription_idID подписки.обязательно
locationРегион, например germanywestcentral, swedencentral или northeurope.germanywestcentral
resource_group_nameИмя новой группы ресурсов. Её создаёт развёртывание, поэтому такой группы ещё не должно быть.rg-scansuite-dev
environmentdev или prod (см. справочник параметров).dev
image_tagКод вашей лицензии.обязательно
web_allowed_cidrsДиапазоны адресов, с которых открывается интерфейс, например ["203.0.113.10/32"]. Задайте до первого развёртывания: страница начальной настройки достаётся тому, кто первым её откроет.открыто для всего интернета
timezoneЧасовой пояс, по которому запускаются запланированные сканирования.Europe/Berlin
alert_emailАдрес для оповещений. Без него оповещения не создаются.нет

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

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

Ожидаемый результат: Plan: N to add, 0 to change, 0 to destroy.

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

./deploy.sh создаёт и изменяет ресурсы без дополнительных вопросов: запуск скрипта и есть согласие. Передайте учётные данные реестра в оболочку сами — они нужны только для копирования образов в ваш реестр и нигде не сохраняются:

bash
export DOCKERHUB_USERNAME='<REGISTRY_USER>'
read -rsp 'Registry access token: ' DOCKERHUB_TOKEN; echo; export DOCKERHUB_TOKEN
./deploy.sh

До того как что-либо создавать, скрипт проверяет инструменты, вход в Azure, лицензию и то, может ли ваша подписка создать PostgreSQL в выбранном регионе. Затем он создаёт сеть, базу данных, Key Vault, хранилище, реестр, среду Container Apps и Redis (это занимает больше всего времени); копирует образы ScanSuite в ваш реестр; запускает веб-интерфейс и воркеры и выполняет миграцию базы данных. Повторный запуск безопасен на любом этапе.

Если в Docker на этой же машине уже есть образы для кода вашей лицензии, например от установки на сервер, deploy.sh загрузит эти локальные копии вместо копирования из реестра; удалите их заранее, если они могли устареть.

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

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

Ожидаемый результат: адрес, затем 200.

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

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

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

  1. AI-подключения → Добавить подключение. Для Azure OpenAI: Тип OpenAI-compatible, URL APIhttps://<RESOURCE>.openai.azure.com/openai/v1, API-ключ — ключ ресурса. Подойдёт и любой другой поддерживаемый провайдер. Нажмите Сохранить.
  2. AI-модели → Добавить модель: Название, Подключение, а в поле ID модели — имя развёртывания Azure OpenAI. Нажмите Сохранить.
  3. Маршрутизация задач → Изменение в строке По умолчанию → Первая модель → Сохранить.
  4. Системный ИИ → Проверить подключение. Ожидаемый результат: Ответ за N с: …

Введите ключ Azure OpenAI в поле API-ключ сами и никогда не вставляйте его в чат.

Если ваш AI-провайдер принимает запросы только с адресов из списка, добавьте постоянный исходящий адрес (пример C). Все поля и маршрутизация по задачам описаны в разделе Поставщики ИИ и стоимость. Затем переходите к разделу Быстрый старт.

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

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

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

Небольшие размеры dev, интерфейс открыт для одного адреса:

terraform.tfvars
subscription_id     = "00000000-0000-0000-0000-000000000000"
location            = "swedencentral"
resource_group_name = "rg-scansuite-trial"
environment         = "dev"

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

# Холодный старт вместо постоянно прогретого интерфейса: первый вход после
# перерыва ждёт около минуты.
web_min_replicas = 0

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

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

Зонально-избыточная база данных с резервной репликой, зонально-избыточное хранилище, реестр Premium, защита Key Vault от окончательного удаления и выделенный профиль вычислений для сканирований, а также постоянный исходящий адрес и журналы без ограничения объёма:

terraform.tfvars
subscription_id     = "00000000-0000-0000-0000-000000000000"
location            = "germanywestcentral"
resource_group_name = "rg-scansuite"
environment         = "prod"

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

postgres_sku       = "GP_Standard_D2ds_v5"
enable_nat_gateway = true
log_daily_quota_gb = -1

Это на несколько сотен долларов в месяц дороже, чем dev. Прежде чем развёртыванием займётся кто-то ещё, перенесите состояние Terraform в Azure Storage, как описано в backend.tf.example.

C. Постоянный исходящий адрес

Иначе исходящий трафик уходит с адреса среды, который может меняться. Если git-сервер или AI-провайдер принимает только адреса из списка, добавьте NAT-шлюз (около 35 долларов в месяц плюс трафик); адрес, который нужно разрешить, будет в выводе egress_ip:

terraform.tfvars
enable_nat_gateway = true

D. Вторая установка в той же подписке

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

terraform.tfvars
resource_group_name = "rg-scansuite-test"

E. Регион, где PostgreSQL вам недоступен

Некоторые типы подписок, в том числе Visual Studio, не могут создать PostgreSQL в любом регионе; deploy.sh сообщает об этом, ещё ничего не создав. Выберите другой регион:

terraform.tfvars
location = "swedencentral"   # или northeurope, francecentral

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

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

Размещение

ПараметрЧто делаетПо умолчаниюКогда менять
subscription_idПодписка, в которую выполняется развёртывание.обязательно—
locationРегион.germanywestcentralВаш регион; другой, если PostgreSQL недоступен (пример E).
resource_group_nameГруппа ресурсов, которую развёртывание создаёт для всего.rg-scansuite-devВсегда: задайте собственное имя.
name_prefixПрефикс имён всех ресурсов: от 3 до 12 строчных латинских букв и цифр, начинается с буквы.scansuiteРедко; глобально уникальные имена и так получают случайный суффикс.
environmentdev или prod: зонально-избыточный PostgreSQL с резервной репликой и резервными копиями за 14 дней, реестр Premium, зонально-избыточное хранилище, защита Key Vault от окончательного удаления и выделенный профиль вычислений для сканирований.devprod для производственной установки.
tagsТеги, добавляемые ко всем ресурсам, например { owner = "secops" }.нетВаша политика тегов.
timezoneЧасовой пояс контейнеров; по нему запускаются запланированные сканирования.Europe/BerlinВаш часовой пояс.
alert_emailКуда отправляются оповещения. Если пусто, оповещения не создаются вовсе.нетПроизводственная установка.

Сеть и доступ

ПараметрЧто делаетПо умолчаниюКогда менять
web_allowed_cidrsДиапазоны, которые пропускает входной шлюз интерфейса.пусто: весь интернетВсегда, до первого развёртывания.
enable_nat_gatewayПостоянный исходящий адрес, вывод egress_ip (около 35 долларов в месяц плюс трафик).falseВаш git-сервер или AI-провайдер принимает только адреса из списка.
vnet_cidrВиртуальная сеть.10.40.0.0/16Она пересекается с сетью, с которой вы будете устанавливать пиринг.
aca_subnet_cidrПодсеть Container Apps; /23 оставляет запас для роста.10.40.0.0/23Вместе с vnet_cidr.
postgres_subnet_cidrПодсеть базы данных.10.40.2.0/28Вместе с vnet_cidr.

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

ПараметрЧто делаетПо умолчаниюКогда менять
image_tagКод вашей лицензии: тег трёх образов.обязательноКаждый новый релиз.
image_registryОткуда deploy.sh копирует образы.docker.io/appsec4uНе меняйте.
image_digestsЗаписывает deploy.sh в images.auto.tfvars.json.—Никогда вручную.
key_dirПапка с файлом лицензии.../keyЛицензия лежит в другом месте.
pyarmor_license_fileИмя файла лицензии в key_dir.единственный .lic тамВ key_dir их несколько.
deploy_workloadsfalse создаёт только платформу (сеть, данные, удостоверения, реестр, среду), для которой не нужны ни лицензия, ни образы.trueПодготовить платформу до получения лицензии.
worker_poc_installation_secretsПередать песочнице proof-of-concept ключи установки.falseТолько по просьбе поддержки, для образов старше этого релиза.

Ресурсы и данные

ПараметрЧто делаетПо умолчаниюКогда менять
scan_cpuvCPU на сканирование, не больше 4.4Редко.
scan_memoryПамять на сканирование; Container Apps допускает 2 ГиБ на vCPU.8GiВместе с scan_cpu.
scan_timeout_secondsМаксимальная длительность сканирования.172800 (48 часов)Редко.
web_min_replicasПостоянно прогретые реплики веб-интерфейса.10 экономит деньги; первый вход после перерыва ждёт около минуты.
web_max_replicasМаксимум реплик веб-интерфейса.2Много одновременных пользователей.
postgres_skuРазмер базы данных. B_Standard_B1ms допускает около 50 подключений, B_Standard_B2s — около 430.B_Standard_B1msB_Standard_B2s или GP_Standard_D2ds_v5 для производственной установки.
postgres_storage_mbХранилище базы данных в МБ.32768Много сканирований, которые долго хранятся.
artifact_retention_daysСколько дней хранятся прежние версии сохранённых артефактов.30Ваша политика хранения.
log_daily_quota_gbДневной лимит Log Analytics в ГБ; -1 снимает его.1-1 для производственной установки.
enable_static_scansСтатический анализ.TrueНе трогайте.
enable_dynamic_scansДинамические и инфраструктурные сканирования, которым нужен демон Docker, а в этом развёртывании его нет.FalseНе трогайте.

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

Переменная или параметрГде используетсяЧто делает
DOCKERHUB_USERNAME, DOCKERHUB_TOKENdeploy.shУчётные данные реестра, с которыми копируются образы. Вводит человек, нигде не хранятся.
TF_VAR_subscription_iddeploy.shПодписка — вместо subscription_id в terraform.tfvars.
MIGRATE=1deploy.shВыполнить миграцию базы данных, даже если образы не изменились. Она отменяет идущие сканирования.
дополнительные аргументыdeploy.sh, destroy.shПередаются terraform apply или destroy.
-ydestroy.shНе спрашивать имя группы ресурсов. Указывается первым: ./destroy.sh -y.

Выводы

ВыводЧто это
urlАдрес ScanSuite.
resource_groupГруппа ресурсов, в которой находится всё.
egress_ipПостоянный исходящий адрес, при enable_nat_gateway.
environment_static_ipВходящий адрес среды Container Apps.
registryРеестр контейнеров, в который копируются образы.
key_vaultKey Vault со сгенерированными секретами.
postgres_fqdnИмя сервера базы данных, доступное только изнутри сети.
log_analytics_workspace_idРабочая область Log Analytics, для az monitor log-analytics query.
migrate_job_name, sast_job_nameЗадание миграции и задание сканирования.

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

  • Изменить настройку: отредактируйте terraform.tfvars и снова запустите ./deploy.sh. Пока образы не меняются, идущие сканирования продолжаются.
  • Новый релиз: положите новый .lic в ../key/ и удалите старый, задайте в image_tag новый код, выполните git pull, а затем ./deploy.sh. Миграция отменяет незавершённые сканирования, поэтому обновляйтесь, когда сканирований нет.
  • Прерванные сканирования восстанавливаются сами: сканирование, контейнер которого остановил Azure, 90 минут не показывает прогресса, а затем запускается заново.
  • Журналы: откройте рабочую область Log Analytics в группе ресурсов, выберите Logs и запросите ContainerAppConsoleLogs_CL по ContainerAppName_s (например, scansuite-web) или ContainerJobName_s (scansuite-sast для сканирований).
  • Экономия, когда установкой не пользуются: web_min_replicas = 0, а базу данных можно остановить командой az postgres flexible-server stop; через семь дней Azure запустит её сам.
  • Берегите состояние Terraform: в terraform.tfstate хранятся сгенерированные пароли и ваша лицензия. Держите файл в закрытом месте, делайте резервную копию после каждого развёртывания и перенесите его в Azure Storage, прежде чем развёртывать будет второй человек или конвейер.

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

СтатьяОриентировочно
Постоянно работающие контейнеры (веб, воркеры, планировщик, Redis)120–160
PostgreSQL B_Standard_B1ms, 32 ГБ20
Log Analytics, не больше 1 ГБ в день0–70
Реестр, Key Vault, хранилищеоколо 10
Сканирования, по 4 vCPU и 8 ГиБоколо 0,45 за час сканирования
NAT-шлюз, если включён35 плюс трафик

10. Удаление

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

Терминал
./destroy.sh

Скрипт примерно за 15 минут удаляет всё, что создало развёртывание. Проверьте:

Терминал
az group show -n <RESOURCE_GROUP>

Ожидаемый результат: Resource group '<RESOURCE_GROUP>' could not be found. Если скрипт остановился с сообщением polling support for the Content-Type "" was not implemented, Azure уже удалил то, что в нём названо: запустите скрипт снова, при необходимости два-три раза. С environment = "prod" Key Vault можно восстановить в течение срока его хранения.

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

PostgreSQL Flexible Server 16 is not available to this subscription: пример E. ManagedEnvironmentCapacityHeavyUsageError: в регионе сейчас нет места для новой среды; удалите неудавшуюся (az containerapp env delete) и повторите позже или в другом регионе. no licence for image tag: положите .lic в ../key/ и приведите image_tag в соответствие с его кодом. could not import docker.io/appsec4u/...: задайте учётные данные реестра в той же оболочке. Provider produced inconsistent result after apply после повторного создания развёртывания с тем же именем группы ресурсов: возьмите новое имя или подождите 15 минут. Адрес открывает страницу входа, а не страницу начальной настройки: первую учётную запись создал кто-то другой — выполните ./destroy.sh и разверните заново с более узким web_allowed_cidrs. Миграция завершается ошибкой: в сообщении назван запуск задания; его журнал — в Log Analytics, в ContainerAppConsoleLogs_CL, где ContainerGroupName_s начинается с этого имени (журнал появляется через несколько минут). Устраните причину и снова запустите ./deploy.sh.

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