Добавление значков состояния для репозитория GitHub

  • Статья

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Синтаксис Markdown можно добавить в репозиторий README.md GitHub, чтобы отобразить состояние доски Kanban в этом репозитории. Отображение состояния путем добавления синтаксиса, выбранного в параметрах доски Kanban.

Примечание.

Требуется Azure DevOps Server 2019 с обновлением 1 или более поздней версии.

Показанный синтаксис работает независимо от того, подключен ли проект к GitHub.com или репозиторию GitHub Enterprise Server. Для GitHub Enterprise Server сервер должен быть доступен для Azure DevOps Services.

Необходимые компоненты

  • Проект Azure Boards должен быть подключен к репозиторию GitHub, где фиксации и запросы на вытягивание, к которым требуется связаться или из него. Дополнительные сведения см. в статье об интеграции Azure Boards-GitHub.
  • У вас должна быть доска Kanban, которую вы хотите настроить. При добавлении команды вы добавите к ней доску Kanban. Дополнительные сведения см. в разделе "О командах и средствах Agile".
  • Вы должны быть добавлены в роль администратора команды для параметров команды, которые вы хотите изменить, или быть членом группы безопасности Project Администратор istrators. Дополнительные сведения см. в разделе "Добавление администратора команды" или "Изменение разрешений на уровне проекта".
  • Чтобы добавить индикатор состояния в репозиторий GitHub.com, необходимо быть участник репозитория.

Добавление значка состояния

  1. Войдите в Azure Boards и откройте доску Kanban.

  2. Выберите значок шестеренки, чтобы настроить доску и задать общие параметры команды.

    Screenshot of opening board settings.

  3. Выберите значок состояния, а затем проверка или отменить проверка разрешить анонимным пользователям доступ к индикатору состояния. Если оно не проверка, пользователи, которые не вошли в систему, по-прежнему могут просматривать индикатор состояния.

    Screenshot of Kanban Board Settings dialog, Status badge tab.

    Screenshot of Kanban Board Settings dialog, Status badge tab, Azure DevOps Server 2019.

  4. Выберите нужный тип эмблемы и выберите значок копирования, чтобы скопировать синтаксис Markdown для значка.

    • Показывать столбцы "Во время выполнения" пропускают только первые и последние столбцы.
    • Включить все столбцы включают первые и последние столбцы доски.
    • Можно настроить набор столбцов, указав 2 для столбцов columnOptions, а затем список столбцов с разделителями-запятыми. Например, ?columnOptions=2&columns=Proposed,Committed,In%20Progress,In%20Reviewкак показано в следующем синтаксисе. Для меток столбцов, включающих пробелы, необходимо закодировать пространство с %20помощью . Например, In%20Progress.
     [![Board Status](https://dev.azure.com/fabrikam/677da0fb-b067-4f77-b89b-f32c12bb8617/cdf5e823-1179-4503-9fb1-a45e2c1bc6d4/_apis/work/boardbadge/6fa7b56f-d27c-4e96-957d-f9e7b0f56705?columnOptions=2&columns=Proposed,Committed,In%20Progress,In%20Review)](https://dev.azure.com/fabrikam/677da0fb-b067-4f77-b89b-f32c12bb8617/_boards/board/t/cdf5e823-1179-4503-9fb1-a45e2c1bc6d4/Microsoft.RequirementCategory/)

    Значок, аналогичный следующему отображению.

    Screenshot showing badge rendered.

  5. По завершении выберите Сохранить.

    Единственный параметр, который можно настроить, — разрешить анонимным пользователям доступ к индикатору состояния. Тип индикатора событий в Параметры переключает синтаксис Markdown только для копирования из значений URL-адреса примера Markdown и изображения.

  6. Откройте файл README в репозитории GitHub и вставьте синтаксис, скопированный для отображения значка.

    Вы увидите тот же образ предварительного просмотра, который вы выбрали со значениями, соответствующими доске Kanban.