Adicionar selos de status para seu repositório do GitHub

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Você pode adicionar a sintaxe markdown a um arquivo de repositório GitHub README.md para exibir o status do quadro Kanban nesse repositório. Mostre o status adicionando a sintaxe escolhida nas configurações do quadro Kanban.

Observação

Tem como requisito o Azure DevOps Server 2019 Atualização 1 ou versão posterior.

A sintaxe mostrada funciona se você tiver conectado seu projeto a um GitHub.com ou ao repositório do GitHub Enterprise Server. Para o GitHub Enterprise Server, seu servidor deve estar acessível à rede para o Azure DevOps Services.

Pré-requisitos

  • Seu projeto do Azure Boards deve estar conectado ao repositório do GitHub onde existem as solicitações de confirmação e pull que você deseja vincular a/de. Para obter mais informações, consulte integração Azure Boards-GitHub.
  • Você deve ter um quadro Kanban que deseja configurar. Quando você adiciona uma equipe, você adiciona um quadro Kanban para essa equipe. Para obter mais informações, confira Sobre equipes e ferramentas Agile.
  • Para adicionar ou renomear colunas ou personalizar cartões, você deve ser adicionado à função de administrador de equipe nas configurações da equipe que deseja modificar ou ser membro do grupo de segurança Administradores de Projeto. Para ser adicionado, confira Adicionar um administrador de equipe ou Alterar permissões no nível do projeto.
  • Para adicionar o selo de status ao repositório GitHub.com, você deve ser um colaborador do repositório.

Adicionar um selo de status

  1. Entre no Azure Boards e abra seu quadro Kanban.

  2. Selecione o ícone de engrenagem para configurar o quadro e definir as configurações gerais da equipe.

    Screenshot of opening board settings.

  3. Selecione o selo de Status e verifique ou desmarque a opção Permitir que usuários anônimos acessem o selo de status. Quando essa opção estiver desmarcada, os usuários que não estiverem conectados ainda poderão exibir o selo de status.

    Screenshot of Kanban Board Settings dialog, Status badge tab.

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

  4. Escolha o tipo de selo desejado e escolha o ícone de cópia para copiar a sintaxe Markdown para o selo.

    • Mostrar somente as colunas "Em andamento" ignora a primeira e a última colunas.
    • Incluir todas as colunas inclui a primeira e a última colunas do quadro.
    • Você pode personalizar o conjunto de colunas especificando 2 para columnOptions e uma lista delimitada por vírgulas das colunas de quadro a serem exibidas. Por exemplo, ?columnOptions=2&columns=Proposed,Committed,In%20Progress,In%20Review, conforme mostrado na sintaxe a seguir. Para rótulos de coluna que incluem espaços, você deve codificar o espaço com %20. Por exemplo, 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/)
    

    Uma notificação semelhante a esta será exibida:

    Screenshot showing badge rendered.

  5. Quando terminar, selecione Salvar.

    A única configuração que você pode configurar é Permitir que usuários anônimos acessem o selo de status. O tipo de selo em Configurações só alterna a sintaxe Markdown para você copiar dos valores markdown de exemplo e URL de imagem.

  6. Abra o arquivo README no repositório GitHub e cole a sintaxe copiada para exibir o selo.

    Você deverá ver a mesma imagem de visualização selecionada com valores que correspondem ao quadro Kanban.