Обзор
Как устроен Scan pipeline — пайплайны на агентах, где хранятся результаты и что где настраивается.
Scan pipeline сканирует выбранные репозитории и собирает находки в одну таблицу запуска. Скан выполняют агенты по шаблону пайплайна:
| Как устроено | |
|---|---|
| Что выполняется | Шаблон пайплайна: стадии → шаги → образ + команды, как в Jenkins |
| Где выполняется | Агенты: встроенный агент рядом с сервером, контейнер на скан-хосте с Docker или pod в Kubernetes |
| Параллельность | Каждый репозиторий — отдельное задание на свободном агенте; запуски идут одновременно |
| SBOM | Командами сборки из шаблона: Maven, Gradle, npm, cdxgen и любые другие |
| Результаты | JSON-отчёты, SBOM и логи шагов в S3: по умолчанию во встроенном хранилище комплекта, по желанию — в своём S3; скачиваются со страницы запуска |
| Настройка | Workflow → Пайплайны и Раннеры, своё S3 (не обязательно) в Интеграциях |
Как это работает
Запуск: шаблон + репозитории + параметры
└── задание на каждый репозиторий
├── агент с подходящими метками забирает задание
├── git clone → стадии и шаги (контейнеры или runner)
├── отчёты, SBOM, логи шагов → S3
└── Archepelag разбирает отчёты → находки- Шаблон описывает пайплайн на YAML: стадии, шаги, образы, команды, параметры формы запуска, секреты шагов и отчёты. Шаблоны правят администраторы; пользователь при запуске выбирает шаблон, репозитории и значения параметров. Готовые шаблоны есть для SBOM (Maven, Gradle, npm, cdxgen), Gitleaks, Semgrep, Trivy и полной проверки с Grype по SBOM.
- Агент сам подключается к Archepelag по HTTPS и забирает задания. Задание попадает только на агента, у которого есть все метки из шаблона. У агента нет доступа к базе данных и ключам Archepelag, а секреты он получает только для шагов, где их объявил шаблон.
- Результаты агент загружает в S3: во встроенное хранилище — через Archepelag, в своё S3 — напрямую по одноразовым подписанным ссылкам. Archepelag скачивает объявленные отчёты, разбирает их в находки и показывает на странице запуска вместе с шагами, логами и файлами. SBOM скачивается кнопкой Скачать SBOM.
- Надёжность. Остановка агента или обновление сервера не роняют сборку: задание возвращается в очередь без траты попытки. Если подходящего агента нет, страница запуска показывает причину ожидания, а по истечении времени ожидания задание завершается ошибкой.
Где что настраивается
| Что | Раздел UI |
|---|---|
| Шаблоны пайплайнов на агентах | Workflow → Пайплайны |
| Агенты, их метки и токены | Workflow → Раннеры |
| Своё S3 для результатов агентов (без него — встроенное хранилище) | Настройки → Интеграции → S3-хранилище |
| Bitbucket, GitHub, Nexus, PT AI, CodeScoring | Интеграции |
| Токены и другие секреты | Настройки → Секреты |
Maven settings, .npmrc и другие шаблоны файлов | Настройки → Файлы конфигурации |
| Выбор репозиториев и запуск | Scan pipeline |
Что дальше
- Как запустить — от установки агента до результатов запуска
- Установка агентов — встроенный агент, docker-хост или Kubernetes
- Описание пайплайна (YAML) — справочник и примеры
- S3-хранилище — куда попадают отчёты и SBOM
- Устранение неполадок