Репозитории
Как устроен каталог репозиториев, как он синхронизируется с Bitbucket и что такое Targets.
Каталог
Каждый репозиторий в Archepelag — отдельная сущность со своими атрибутами:
| Атрибут | Для чего |
|---|---|
| Команда | Кто отвечает за код и findings |
| Продукт | К какому продукту относится репозиторий |
| Ветка по умолчанию | Какая ветка сканируется, если не указана другая |
| Статус синхронизации | Есть ли репозиторий в Bitbucket прямо сейчас |
| Статус | Обращает ли платформа внимание на репозиторий: «Активный», «Архив» или «Игнорируется» |
Список репозиториев — основная рабочая поверхность раздела: имя, метаданные, статус и действия видны в одной строке.
Статус репозитория
Статус — системное поле. От него зависит, сканирует ли платформа репозиторий и учитывает ли его в отчётах.
| Статус | Что означает | Сканы и автозадачи | Список и отчёты |
|---|---|---|---|
| Активный | Код развивается или работает в проде, даже если обновления больше не выходят | Да | Да |
| Архив | Репозиторий выведен из эксплуатации | Нет | Виден с фильтром «Архив», найденные дефекты остаются в истории |
| Игнорируется | Репозиторий исключён из учёта, например форк или песочница | Нет | Скрыт из списка и отчётов, виден только с фильтром «Исключённые из учёта» |
Статус меняют карандашом строки «Статус» в «Общих сведениях». Для архива можно оставить комментарий, например чем заменили репозиторий.
Ставить и снимать «Игнорируется» может администратор или роль с правом «Исключение репозиториев из учёта». Причина обязательна: форк, песочница, зеркало, тестовый или другое. Для «другого» нужен комментарий. Кто и когда поменял статус, видно в карточке и в журнале активности.
Синхронизация с VCS статус не меняет. Если репозиторий архивирован в VCS, а в Аркепелаге он активный, в строке «Статус» появится подсказка «Перевести в архив».
Переключатель «Сканирование» работает только у активных репозиториев.
Стадии жизненного цикла
Стадии, принятые в компании, ведут классификатором репозиториев. В «Настройки → Справочники → Классификаторы репозиториев» есть шаблон «Стадия ЖЦ». Он копирует значения «Стадии ЖЦ» продуктов с теми же цветами и порядком. Если у продуктов такого классификатора нет, шаблон ставит пять своих: Разработка, Эксплуатация, Сопровождение, Вывод из эксплуатации, Архив. Копия с продуктами не связана. Значения можно переименовать, добавить свои или убрать лишние. Стадия ни на что не влияет. Сканы и отчёты зависят только от статуса.
Синхронизация с Bitbucket
Фоновая задача регулярно сверяет каталог с Bitbucket. Если репозиторий удалили или перенесли, в таблице он получает метку Нет в Bitbucket — текстовую, а не только цветовую, чтобы её было видно в любой теме и при любом восприятии цвета.
Targets: репозитории вне каталога
Репозитории, которые найдены, но ещё не заведены в каталог (shadow repos), попадают в раздел Targets. У каждой находки есть статус триажа:
| Статус | Что означает |
|---|---|
| New | Найдено, ещё никто не разбирал |
| Need Action | Нужен триаж или онбординг |
| Ignore | Сознательно исключено из каталога |
| Registered | Заведено в каталог |
Риск
Колонка Риск — оценка от 0 до 100. Аркепелаг считает её по метаданным из системы контроля версий и пересчитывает при каждом сканировании:
| Условие | Баллы |
|---|---|
| Любой репозиторий | 45 |
| Репозиторий публичный | +25 |
| Появился в последнем сканировании | +20 |
| Переименован в последнем сканировании | +10 |
| Больше 5 веток | +10 |
Сумма не превышает 100.
| Риск | Как показан |
|---|---|
| 85 и выше | Красным |
| 70–84 | Жёлтым |
| Ниже 70 | Без цвета |
Карточка Критичные и одноимённый фильтр показывают цели с риском 70 и выше.
Совет
Перед регистрацией убедитесь, что репозиторий есть в Bitbucket и корректно сопоставлен — по URL или по тройке ключей каталога. Иначе сканы и findings привяжутся не к тому репозиторию.