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

Репозитории

Как устроен каталог репозиториев, как он синхронизируется с 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 привяжутся не к тому репозиторию.