Vincular o GitHub ao Azure Boards

A integração entre o GitHub e o Azure Boards cria uma abordagem híbrida poderosa que combina o ambiente amigável para desenvolvedores do GitHub com os recursos de planejamento empresarial do Azure Boards. Essa conexão permite que as organizações mantenham a governança centralizada do projeto, permitindo que as equipes de desenvolvimento trabalhem em seu ambiente de GitHub preferido.

Benefícios comerciais da integração:

• Visibilidade unificada: os stakeholders podem acompanhar o progresso do desenvolvimento sem acessar o GitHub diretamente
• Conformidade e auditoria: manter o acompanhamento formal do projeto, preservando os fluxos de trabalho do desenvolvedor
• Colaboração multifuncional: preencher a lacuna entre os gerentes de projeto e as equipes de desenvolvimento
• Sincronização automatizada: reduzir a sobrecarga manual para manter o status do projeto atual

Aplicativo do Azure Boards: a base de integração

O aplicativo Azure Boards serve como a ponte técnica que habilita o fluxo de dados contínuo entre o GitHub e o Azure Boards. Esse aplicativo marketplace fornece acesso seguro e autenticado, mantendo a integridade de ambas as plataformas.

Principais recursos de integração:

• Vinculação bidirecional: conectar itens de trabalho do Azure Boards com confirmações, PRs e problemas do GitHub
• Transições de estado automatizadas: Conclua itens de trabalho quando menções no GitHub incluírem palavras-chave como "fixes"
• Sincronização em tempo real: as alterações no GitHub refletem imediatamente nos Quadros do Azure
• Controle de escopo flexível: escolha a integração de repositório seletivo ou em toda a organização

Requisitos e permissões de instalação

Pré-requisitos do GitHub:

• Acesso ao repositório: permissões de administrador ou proprietário para repositórios de destino
• Permissões da organização: função de proprietário para instalações em toda a organização
• Acesso ao Marketplace: capacidade de instalar aplicativos do GitHub Marketplace

Pré-requisitos do Azure DevOps:

• Administrador da coleção de projetos: necessário para a configuração inicial da conexão
• Permissões do projeto: acesso de participantes ou superior para visualizar itens de trabalho vinculados
• Credenciais de autenticação: PAT ou OAuth para acesso seguro à API

Considerações sobre autenticação e segurança

A autenticação segura é essencial para manter a integridade de dados e o controle de acesso em ambas as plataformas. O Azure Boards dá suporte a vários métodos de autenticação, cada um com implicações de segurança específicas e casos de uso.

Opções de autenticação do GitHub:

Práticas recomendadas de segurança:

• Princípio de privilégio mínimo: conceder apenas as permissões necessárias para a funcionalidade de integração
• Rotação de tokens: atualize regularmente PATs e examine as permissões de acesso
• Log de auditoria: monitorar a atividade de integração para padrões de acesso incomuns
• Isolamento do repositório: conectar apenas repositórios que exigem a integração do Azure Boards

Processo de conexão passo a passo:

1. Instalar o aplicativo Azure Boards do GitHub Marketplace
2. Configurar o acesso ao repositório (todos os repositórios ou seletivos)
3. Autenticar com o Azure DevOps usando o método preferencial
4. Mapear repositórios para projetos no Azure Boards
5. Testar a integração com links de exemplo e commits

Para obter diretrizes detalhadas de implementação, consulte: Conectar o Azure Boards ao GitHub

Flexibilidade e gerenciamento de configuração

Capacidades de gerenciamento no GitHub:

• Controle de escopo do repositório: adicionar ou remover repositórios específicos da integração
• Mapeamento de projeto: configurar quais projetos do Azure Boards se conectam a cada repositório
• Suspensão de integração: desabilitar temporariamente sem perder a configuração
• Remoção completa: desinstalar o aplicativo e remover todas as conexões

Funcionalidades de gerenciamento do Azure Boards:

• Conexões de vários repositórios: vincular vários repositórios do GitHub a projetos únicos
• Vinculação entre projetos: permitir que repositórios se conectem a vários projetos do Azure Boards
• Monitoramento de integridade da conexão: acompanhar o status da integração e resolver problemas de conectividade
• Gerenciamento de permissões: controlar quais usuários podem modificar conexões do GitHub

Cenários de integração com suporte

A integração de Boards-GitHub do Azure dá suporte às seguintes conexões:

• No GitHub:

  • Suporte à integração para todos os repositórios de uma conta ou organização GitHub ou seleção de repositórios.
  • Adicione ou remova os repositórios do GitHub que participam da integração e configure o projeto ao qual eles se conectam.
  • Suspender a integração de Boards-GitHub do Azure ou desinstalar o aplicativo.

• No Azure Boards:

  • Conecte um ou mais repositórios do GitHub a um projeto do Azure Boards.
  • Adicione ou remova repositórios do GitHub de uma conexão do GitHub em um projeto do Azure Boards.
  • Remova completamente uma conexão do GitHub para um projeto.
  • Permitir que um repositório GitHub se conecte a um ou mais projetos do Azure Boards na mesma organização ou coleção do Azure DevOps.

A integração de Boards-GitHub do Azure dá suporte às seguintes tarefas operacionais:

• Criar links entre itens de trabalho e confirmações de GitHub, solicitações de pull e problemas com base em menções do GitHub.
• Dar suporte à transição de estado de itens de trabalho para o estado Concluído ao usar a menção do GitHub por meio de correções.
• Dê suporte à rastreabilidade total postando um comentário de discussão no GitHub ao vincular de um item de trabalho a uma confirmação, solicitação de pull ou problema do GitHub.
• Mostrar os artefatos de código do GitHub vinculados na seção Desenvolvimento do item de trabalho.
• Mostrar artefatos vinculados ao GitHub como anotações em cartões de quadros Kanban.
• Selos de status de suporte para as colunas do quadro Kanban foram adicionados aos repositórios do GitHub.

No momento, não há suporte para as seguintes tarefas:

• Consulta de itens de trabalho com links para artefatos do GitHub. No entanto, você pode consultar itens de trabalho com uma Contagem de Links Externos maior que 0.

Para obter mais informações, consulte:

• Altere o acesso ao repositório GitHub ou suspenda ou desinstale a integração.
• Adicionar ou remover repositórios do GitHub.
• Vincular confirmações, solicitações de pull e problemas do GitHub a itens de trabalho para obter detalhes sobre como vincular a itens de trabalho.