Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Azure DevOps Serviços | Azure DevOps Server | Azure DevOps Server 2022
Neste início rápido, irá instalar a aplicação Azure Boards para GitHub para ligar o Azure Boards aos seus repositórios do GitHub. Quando ligas projetos do Azure Boards a repositórios do GitHub.com, suportas a ligação entre commits do GitHub e pull requests aos itens de trabalho. Podes usar o GitHub para desenvolvimento de software enquanto usas o Azure Boards para planear e acompanhar o teu trabalho. Depois de instalar a aplicação Azure Boards para GitHub na sua conta ou organização GitHub, escolha a que repositórios GitHub quer ligar-se a partir do seu projeto.
Para uma visão geral da integração que a aplicação Azure Boards para GitHub suporta, veja Azure Boards-GitHub integração.
Prerequisites
| Category | Requirements |
|---|---|
| Permissões | - Membro do grupo Project Collection Administrators. Se você criou o projeto, você tem permissões. - Administrador ou proprietário da organização 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 seu repositório já estiver ligado usando outro tipo de autenticação como o OAuth, deve remover esse repositório da sua ligação existente antes de o voltar a ligar usando a aplicação GitHub. Siga os passos fornecidos em Adicionar ou remover GitHub repositórios mais adiante neste artigo antes de configurar a GitHub App.
Podes ligar uma organização Azure DevOps a vários repositórios do GitHub se fores administrador desses repositórios. Não deveria ligar um repositório do GitHub a mais de uma organização do Azure DevOps.
Instale e configure a aplicação 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.
Vai à aplicação Azure Boards no Marketplace GitHub.
Em Planos e preços, em Gratuito, selecione Instalar.
Em Instalar e Autorizar Azure Boards, escolha os repositórios que deseja ligar ao Azure Boards, depois selecione Instalar e Autorizar.
Este exemplo usa Todos os repositórios:
Escolha a organização do Azure DevOps e o projeto do Azure Boards ao qual quer ligar-se 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.
Forneça acesso à organização do Azure Boards
Se necessário, para conceder acesso ao GitHub à sua organização Azure DevOps, siga os seguintes passos.
No portal web GitHub, abra Settings no menu do seu perfil.
Selecione Aplicativos em Integrações.
Selecione Apps 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 a sua organização GitHub permite o acesso de aplicações de terceiros para a aplicação Azure Boards. Se o acesso de terceiros for restringido, adicionar repositórios do Azure DevOps pode mostrar uma lista vazia ou produzir um erro.
Para habilitar o acesso:
Em GitHub, abra a sua organização e vá para as Definições > Política de aplicação OAuth.
Aprove especificamente a aplicação Azure Boards (recomendado), ou remova restrições para todas as aplicações 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 momento, a sua integração 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 emblema ao README"—Issue (Básico), User Story (Agile) ou Product Backlog Item (Scrum)—dependendo do modelo de processo utilizado pelo seu projeto 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.
No tipo de ligação, 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 emblema ao ficheiro README do primeiro repositório na lista de repositórios GitHub ligados.
- Cria um commit no GitHub para a atualização feita ao adicionar o emblema ao ficheiro README.
- Cria um pull request no GitHub para fundir as alterações feitas ao ficheiro README.
- Liga o commit e o pull request do GitHub ao item de trabalho criado no passo 1.
Selecione o primeiro link de solicitação pull do seu item de trabalho.
A pull request do GitHub abre numa nova aba do navegador.
Selecione Mesclar pedido de pull.
Vá para o arquivo README do repositório e visualize o selo que foi adicionado.
Para mais informações, consulte Adicione insígnias de estatuto para o seu GitHub repositório.
Configurar outros projetos ou repositórios
Pode configurar outros projetos Azure Boards/Azure DevOps, GitHub.com repositórios ou alterar a configuração atual a partir da página da aplicação Azure Boards. Para mais informações, consulte Adicionar ou remover repositórios, ou remover uma ligação de Azure Boards.
Adicionar ou remover repositórios, ou remover uma ligação do Azure Boards
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.
A partir do teu projeto no Azure DevOps, vai a Definições do Projeto>GitHub Conexões.
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 web GitHub, abra Settings no menu do seu perfil.
Selecione Integrações>Aplicações. Em Aplicações GitHub Instaladas, selecione Configurar.
A página de configuração do Azure Boards abre-se.
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 escolher Apenas selecionar repositórios, selecione os repositórios com os quais quer participar na integração Azure Boards.
Selecione Guardar.
Suspender ou desinstalar a integração com o 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 a aplicação Azure Boards, escolha Desinstalar e depois selecione OK na janela de confirmação pop-up.
Atualizar conexões do Azure Boards-GitHub
Se mudares os repositórios que a aplicação Azure Boards para GitHub suporta, poderás ser reencaminhado para as ligações do GitHub do Azure Boards. Uma boa prática é remover os repositórios no Azure Boards que já não conseguem ligar-se ao GitHub. Para mais informações, consulte Adicionar ou remover repositórios GitHub.
Se desinstalar a aplicação Azure Boards para GitHub, a seguinte mensagem aparece em Azure Boards, definições do projeto>ligações GitHub. Escolha Remover ligação para remover todas as ligações do GitHub previamente feitas. Para mais informações, consulte Adicionar ou remover repositórios GitHub.
A captura de ecrã mostra a app do GitHub do Azure Boards desinstalada.