Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Serviços de DevOps do Azure | Azure DevOps Server | Azure DevOps Server 2022
Neste início rápido, você instala o aplicativo Azure Boards for GitHub para conectar o Azure Boards aos seus repositórios do GitHub. Ao conectar projetos do Azure Boards com repositórios GitHub.com, você dá suporte à vinculação entre confirmações do GitHub e solicitações pull para itens de trabalho. Você pode usar o GitHub para desenvolvimento de software enquanto usa os Painéis do Azure para planejar e acompanhar seu trabalho. Depois de instalar o aplicativo Azure Boards para GitHub em sua conta ou organização do GitHub, escolha a quais repositórios do GitHub você deseja se conectar a partir do seu projeto.
Para obter uma visão geral da integração suportada pelo aplicativo Azure Boards for GitHub, consulte Integração Azure Boards-GitHub.
Prerequisites
| Category | Requirements |
|---|---|
| Permissions | - Membro do grupo Project Collection Administrators. Se você criou o projeto, você tem permissões. - Administrador ou proprietário da organização do GitHub para instalar a aplicação Azure Boards. - Permissões de leitura para o repositório GitHub. |
| Adesão ao projeto | Membro do projeto. |
Important
Se o repositório já estiver conectado usando outro tipo de autenticação, como OAuth, você deverá remover esse repositório da conexão existente antes de reconectá-lo usando o aplicativo GitHub. Siga as etapas fornecidas em Adicionar ou remover repositórios do GitHub mais adiante neste artigo antes de configurar o aplicativo GitHub.
Você pode conectar uma organização do Azure DevOps a vários repositórios do GitHub se for um administrador desses repositórios. Você não deve conectar um repositório GitHub a mais de uma organização do Azure DevOps.
Instalar e configurar o aplicativo Azure Boards
A sequência de instalação pode variar devido à configuração da sua conta. Se necessário, siga as instruções na tela entre as etapas a seguir.
Vá para o aplicativo Azure Boards no GitHub Marketplace.
Em Planos e preços, em Gratuito, selecione Instalar.
Em Instalar & Autorizar Painéis do Azure, escolha os repositórios que você deseja conectar aos Painéis do Azure e selecione Instalar & Autorizar.
Este exemplo usa Todos os repositórios:
Escolha a organização do Azure DevOps e o projeto do Azure Boards que pretende ligar ao GitHub.com.
Você só pode conectar um projeto de cada vez. Se você tiver outros projetos que deseja conectar, poderá fazê-lo posteriormente, conforme descrito em Configurar outros projetos ou repositórios , mais adiante neste artigo.
Conceder acesso aos Azure Boards da organização
Se necessário, para conceder acesso ao GitHub à sua organização do Azure DevOps, execute as etapas a seguir.
No portal da Web do GitHub, abra Configurações no menu do seu perfil.
Selecione Aplicativos em Integrações.
Selecione Aplicações GitHub Autorizadas>Azure Boards.
Em Acesso à organização, resolva quaisquer problemas que possam aparecer. Selecione Conceder para conceder acesso a todas as organizações que mostram ter uma solicitação de acesso pendente.
Verifique sua política de acesso a aplicativos de terceiros
Certifique-se de que sua organização do GitHub permita o acesso a aplicativos de terceiros para o aplicativo Azure Boards. Se o acesso de terceiros for restrito, adicionar repositórios do Azure DevOps pode mostrar uma lista vazia ou produzir um erro.
Para habilitar o acesso:
No GitHub, abra sua organização e vá para Configurações > da política do aplicativo OAuth.
Aprove o aplicativo Azure Boards especificamente (recomendado) ou remova restrições para todos os aplicativos de terceiros.
Observação
Você deve ser proprietário ou administrador de uma organização para alterar essa configuração.
Utilize a conexão
Neste ponto, sua integração do Azure Boards-GitHub está concluída. Você pode pular as próximas etapas ou passar por elas para entender os recursos suportados com a conexão.
No seu quadro, selecione Novo item de trabalho para inserir um novo item de trabalho chamado "Adicionar selo ao LEIA-ME" — Problema (Básico), História de Usuário (Agile) ou Item de Lista de Pendências do Produto (Scrum) — dependendo do modelo de processo usado pelo seu projeto do Azure Boards.
Um item de trabalho intitulado Adicionar emblema ao LEIA-ME aparece no seu painel.
Abra seu item de trabalho, vá para a seção Desenvolvimento e selecione Adicionar link.
Em Tipo de link, selecione GitHub Pull Request.
Selecione o repositório e insira o ID de solicitação pull e um comentário opcional.
Selecione Adicionar link.
As seguintes ações ocorrem em segundo plano, automaticamente:
- Adiciona um selo ao arquivo LEIA-ME do primeiro repositório na lista de repositórios do GitHub conectados.
- Cria uma confirmação do GitHub para a atualização feita adicionando o selo ao arquivo LEIA-ME.
- Cria uma solicitação pull do GitHub para mesclar as alterações feitas no arquivo LEIA-ME.
- Vincula a solicitação commit e pull do GitHub ao item de trabalho criado na etapa 1.
Selecione o primeiro link de solicitação pull do seu item de trabalho.
O pull request do GitHub é aberto num novo separador do navegador.
Selecione Mesclar pedido de pull.
Vá para o arquivo README do repositório e visualize o selo que foi adicionado.
Para obter mais informações, consulte Adicionar selos de status para seu repositório GitHub.
Configurar outros projetos ou repositórios
Você pode configurar outros Azure Boards/Azure DevOps Projects, GitHub.com repositórios ou alterar a configuração atual na página do aplicativo Azure Boards. Para obter mais informações, consulte Adicionar ou remover repositórios ou remover uma conexão dos Painéis do Azure.
Adicionar ou remover repositórios ou remover uma conexão dos Painéis do Azure
Se você encontrar um problema com uma conexão, recomendamos que você remova a conexão e comece de novo com uma nova conexão.
No seu projeto no Azure DevOps, vá para Configurações>do projeto Conexões do GitHub.
Para adicionar ou remover repositórios, selecione as reticências de Mais opções na ligação e escolha Adicionar repositórios ou Remover repositórios no menu.
Para remover todos os repositórios e a conexão, escolha a opção Remover conexão . Em seguida, escolha Remover para confirmar.
Alterar o acesso ao repositório
No portal da Web do GitHub, abra Configurações no menu do seu perfil.
Selecione Integrações>Aplicações. Em Aplicativos GitHub instalados, selecione Configurar.
A página de configuração do Azure Boards é aberta.
Role para baixo até a seção Acesso ao repositório .
Escolha a opção desejada, Todos os repositórios ou Selecione apenas repositórios.
Se você escolher Selecionar apenas repositórios, selecione os repositórios dos quais deseja participar da integração com os Painéis do Azure.
Selecione Guardar.
Suspender ou desinstalar a integração do Azure Boards
A partir da etapa 2 do procedimento anterior, role para baixo até a seção Zona de perigo.
Para suspender a integração, escolha Suspender. Na janela de confirmação, escolha OK para confirmar a suspensão.
Para cancelar a suspensão da integração, escolha Cancelar suspensão.
Para desinstalar o aplicativo Azure Boards, escolha Desinstalar e, em seguida, escolha OK na janela de confirmação pop-up.
Atualizar conexões do Azure Boards-GitHub
Se alterar os repositórios que a aplicação Azure Boards para GitHub suporta, poderá ser redirecionado para as ligações GitHub do Azure Boards. Uma boa prática é remover os repositórios nos Painéis do Azure que não podem mais se conectar ao GitHub. Para obter mais informações, consulte Adicionar ou remover repositórios do GitHub.
Se você desinstalar o aplicativo Azure Boards para GitHub, a seguinte mensagem será exibida em Azure Boards, Project settings>GitHub connections. Escolha Remover conexão para remover todas as conexões do GitHub feitas anteriormente. Para obter mais informações, consulte Adicionar ou remover repositórios do GitHub.
