Разделы документации

Обзор

Как устроен 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

Что дальше