Пользовательские статусы

bd поставляется с пятью встроенными статусами. Вы можете добавить свои, чтобы соответствовать реальному рабочему процессу вашей команды.

Предварительные требования

  • bd 0.58.0+ установлен
  • Beadbox 0.15.0+
  • Существующий воркспейс хотя бы с одним bead

Встроенные статусы

Каждый воркспейс начинается с этих пяти статусов. Их нельзя удалить.

StatusDescription
openНовая или не начатая работа
in_progressАктивно выполняется
blockedОжидает зависимости или внешнего ввода
deferredНамеренно отложено
closedГотово

Добавление пользовательских статусов

Одна команда. Передайте список названий статусов через запятую:

bd config set status.custom "ready_for_qa,in_qa,qa_passed,ready_to_ship"

Вот и всё. Новые статусы доступны сразу и в bd, и в Beadbox.

Использование пользовательских статусов

Пользовательские статусы работают везде, где работают встроенные:

Установить статус bead:

bd update bb-1234 --status ready_for_qa

Фильтровать по статусу:

bd list --status ready_for_qa

Список всех bead в пользовательском состоянии:

bd list --status in_qa,qa_passed

Как это выглядит в Beadbox

Выпадающий список статусов

Пользовательские статусы появляются в выпадающем списке статусов каждого bead с цветовыми индикаторами. Перезапуск не требуется. Как только вы выполните команду config, новые статусы отобразятся при следующем открытии bead.

Представление пайплайна

Страница активности показывает пайплайн с одним столбцом на каждый статус слева направо. Пользовательские статусы отображаются как дополнительные столбцы между встроенными.

Pipeline view showing custom status columns

Note: Текущее ограничение: представление пайплайна поддерживает фиксированный набор позиций столбцов. Пользовательские статусы отображаются в выпадающем списке и работают со всеми командами CLI, но у некоторых пока может не быть выделенных столбцов в пайплайне.

Удаление или изменение статусов

Чтобы изменить пользовательские статусы, выполните команду config снова с новым списком:

bd config set status.custom "ready_for_qa,qa_passed,ready_to_ship"

Чтобы удалить все пользовательские статусы и вернуться к пяти стандартным:

bd config set status.custom ""

Bead, которым уже присвоен удалённый статус, сохраняют этот статус. Они по-прежнему отображаются в bd list и Beadbox, и вы можете фильтровать по ним. Вы просто не сможете назначить удалённый статус новым bead.

Советы

  • Используйте подчёркивания, а не пробелы. Названия статусов являются идентификаторами. ready_for_qa работает. "Ready for QA" — нет.
  • Порядок имеет значение. Порядок, в котором вы перечисляете статусы в конфигурации, определяет их положение в представлении пайплайна и выпадающем списке. Располагайте их в порядке прохождения работы через них.
  • Список должен быть коротким. Оптимальное количество — от трёх до пяти пользовательских статусов. Больше — и представление пайплайна станет перегруженным.
  • Называйте по рабочему процессу, а не по инструменту. ready_for_qa, in_review, needs_deploy говорят, что делать дальше. status_7 — нет.