Vincular o GitHub aos painéis do Azure

A integração entre o GitHub e os 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 GitHub preferido.

Benefícios comerciais da integração:

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

Aplicativo Azure Boards: A base de integração

O Aplicativo de Painéis do Azure serve como a ponte técnica que permite o fluxo de dados contínuo entre o GitHub e os Painéis do Azure. Este aplicativo de mercado fornece acesso seguro e autenticado, mantendo a integridade de ambas as plataformas.

Principais capacidades de integração:

• Vinculação bidirecional: conectar itens de trabalho do Azure Boards com confirmações, RPs e problemas do GitHub
• Transições de estado automatizadas: os itens de trabalho completos quando as menções do GitHub incluem palavras-chave como "correções"
• Sincronização em tempo real: as alterações no GitHub refletem imediatamente nos Painéis do Azure
• Controle de escopo flexível: escolha entre a integração ao nível da organização ou a integração de repositórios seletivos

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 das partes interessadas ou superior para exibir 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 é fundamental para manter a integridade dos dados e o controle de acesso em ambas as plataformas. Os Painéis do Azure dão suporte a vários métodos de autenticação, cada um com implicações de segurança e casos de uso específicos.

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

Práticas recomendadas de segurança:

• Princípio do menor privilégio: Conceda apenas as permissões necessárias para a funcionalidade de integração
• Rotação de tokens: atualize regularmente os PATs e revise as permissões de acesso
• Log de auditoria: monitore a atividade de integração em busca de padrões de acesso incomuns
• Isolamento do repositório: conecte apenas repositórios que exigem integração com o 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 de preferência
4. Mapear repositórios para projetos nos Painéis do Azure
5. Teste a integração com links de exemplo e confirmações

Para obter orientações detalhadas de implementação, consulte: Conectar painéis do Azure ao GitHub

Flexibilidade e gerenciamento de configuração

Capacidades de gestão no GitHub:

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

Capacidades de gestão do Azure Boards:

• Conexões com vários repositórios: vincule 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 da integridade da conexão: acompanhe o status da integração e resolva problemas de conectividade
• Gerenciamento de permissões: controle quais usuários podem modificar conexões do GitHub

Cenários de integração suportados

A integração do Azure Boards-GitHub suporta as seguintes conexões:

• Do GitHub:

  • Ofereça suporte à integração de todos os repositórios de uma conta ou organização do GitHub ou selecione repositórios.
  • Adicione ou remova repositórios do GitHub que participam da integração e configure o projeto ao qual eles se conectam.
  • Suspenda a integração do Azure Boards-GitHub ou desinstale o aplicativo.

• Dos painéis do Azure:

  • 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 GitHub para um projeto.
  • Permita que um repositório GitHub se conecte a um ou mais projetos do Azure Boards dentro da mesma organização ou coleção do Azure DevOps.

A integração do Azure Boards-GitHub suporta as seguintes tarefas operacionais:

• Crie links entre itens de trabalho e confirmações do GitHub, solicitações pull e problemas com base nas menções do GitHub.
• Ofereça suporte à transição de estado de itens de trabalho para um estado Concluído ou Finalizado ao mencionar no GitHub usando fix, fixes ou fixed.
• Ofereça 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 pull ou problema do GitHub.
• Mostrar artefatos de código vinculados ao GitHub dentro da seção Desenvolvimento do item de trabalho.
• Mostrar artefatos do GitHub vinculados como anotações nos cartões do quadro Kanban.
• Emblemas de suporte de estado das colunas do quadro Kanban adicionados aos repositórios do GitHub.

As seguintes tarefas não são suportadas no momento:

• Consulta de itens de trabalho com links para artefatos do GitHub. No entanto, você pode consultar itens de trabalho com um número de links externos maior que 0.

Para obter mais informações, consulte:

• Alterar o acesso ao repositório GitHub, suspender ou desinstalar a integração.
• Adicionar ou remover repositórios do GitHub.
• Link O GitHub confirma, extrai solicitações e emite itens de trabalho para obter detalhes sobre como vincular a itens de trabalho.