Conecte o Azure Boards: guia passo a passo
Cria um item de trabalho para cada teste com falha, adiciona um comentário quando o teste falha novamente e define o item como concluído quando o teste passa sem falhas. O mesmo token também publica resultados de testes e coloca pipelines na fila. Este guia leva você do zero a uma conexão verificada e lista os erros que podem ocorrer, com suas causas e soluções.
Última atualização:
Mantenha suas credenciais em sigilo. Nunca cole um token, uma chave, uma senha ou uma URL de webhook em uma conversa. Insira esses dados apenas em Studio → Configurações → Integrações, onde são salvos no arquivo .env do seu espaço de trabalho e exibidos como pontos. O mesmo vale para um assistente de IA: ele pode orientar você neste guia, mas nunca precisa do seu token.
O que você precisa
- Uma organização do Azure DevOps Services: https://dev.azure.com/<organization> ou https://<organization>.visualstudio.com (não há suporte ao Azure DevOps Server em suas próprias máquinas).
- O nome do projeto que receberá os itens de trabalho.
- Um token de acesso pessoal (PAT) com Itens de trabalho → Leitura & gravação e Compilação → Leitura & execução se você também usar Executar em CI.
- Conhecer o processo do seu projeto, pois ele determina o tipo de item de trabalho: Basic tem Issue, Epic e Task (sem Bug); Agile, Scrum e CMMI têm Bug.
Obtenha as credenciais
- Abra dev.azure.com e acesse Configurações do usuário → Tokens de acesso pessoal → Novo token.
- Selecione sua organização, defina uma data de expiração e, em Escopos, escolha Definição personalizada.
- Marque Itens de trabalho → Leitura & gravação (adicione Compilação → Leitura & execução para Executar em CI), crie o token e copie-o agora. Ele é exibido uma única vez.
- Mantenha-o na área de transferência. Não o cole em nenhum lugar além do Studio (próxima etapa).
Conecte no Studio
- No Studio, abra Configurações → Integrações → Conectar Azure DevOps.
- Cole qualquer link do Azure DevOps (um quadro, um item de trabalho ou a página do projeto) e clique em Verificar conexão. O Studio armazena a organização e o projeto.
- Quando solicitado, insira o PAT e clique em Salvar & verificar. Selecione o projeto em "Destino dos itens de trabalho".
- Se a verificação indicar que o projeto não tem um tipo de item de trabalho chamado Bug, defina
AZURE_BOARDS_WORK_ITEM_TYPEcomo um dos tipos listados (em um projeto Basic, Issue) eAZURE_BOARDS_DONE_STATEcomo um estado disponível nesse processo (Basic: Done). - Ative
AZURE_BOARDS_ENABLED.
Verifique se funciona
- Verificar conexão exibe "O token tem acesso a N projetos" e "<project> aceita itens de trabalho do tipo <type>". A verificação apenas lê dados; nunca cria um item de trabalho.
- Abra Configurações → Integrações → Chamados e clique em Criar chamado de teste. Isso cria um item de trabalho com a etiqueta nexus-test e uma captura de tela anexada.
- Abra-o no Azure Boards, confirme a etiqueta e o anexo e exclua-o quando terminar.
Erros comuns
| O que você vê | Causa | Solução |
|---|---|---|
| "O Azure DevOps recusou o token" (HTTP 203 ou 401) | O PAT está incorreto, expirado, revogado, foi copiado de forma incompleta ou foi criado em outra organização. | Crie um novo PAT na mesma organização de AZURE_DEVOPS_ORG_URL com Itens de trabalho → Leitura & gravação e salve-o novamente. |
| HTTP 403 | O PAT é válido, mas falta um escopo, ou seu usuário não tem permissão nesse projeto. | Edite os escopos do PAT (Itens de trabalho → Leitura & gravação; Compilação → Leitura & execução para Executar em CI) ou solicite acesso ao administrador do projeto. |
| HTTP 404 | A organização ou o nome do projeto não existe, ou o projeto foi renomeado. | Cole um link do projeto correto e selecione-o na lista. |
| VS402323 "O tipo de item de trabalho Bug não existe" | O processo do projeto não tem um tipo de item de trabalho com esse nome. Um projeto Basic tem Issue, Epic e Task, mas não Bug. | Defina AZURE_BOARDS_WORK_ITEM_TYPE como um tipo listado pela verificação (Basic: Issue) e AZURE_BOARDS_DONE_STATE como um dos estados desse tipo (Basic: Done) e clique em Verificar conexão novamente. |
| "<project> não tem um tipo de item de trabalho chamado …" | A mesma causa de VS402323, detectada por Verificar conexão antes que qualquer item seja registrado. | Defina AZURE_BOARDS_WORK_ITEM_TYPE como um dos tipos listados nessa mensagem ou escolha outro projeto. |
| "Este não é um link do Azure DevOps" | O endereço não está em dev.azure.com/<organization> nem em <organization>.visualstudio.com, ou começa com http://. | Copie o endereço da barra de endereços do Azure DevOps Services. O Azure DevOps Server não é compatível. |
| "não foi possível acessar o Azure DevOps (…)" ou "não respondeu em 20 s" | Este computador não consegue acessar o Azure DevOps: uma VPN ou um proxy, ou falta de conexão de rede. | Abra dev.azure.com em um navegador no mesmo computador e tente verificar novamente. |
| Um teste aprovado não define o estado de conclusão | O processo recusa AZURE_BOARDS_DONE_STATE para esse tipo, então o item recebe apenas o comentário. | Defina AZURE_BOARDS_DONE_STATE como um estado desse tipo (Basic: Done; bug do Agile: Resolved). |
| Está tudo certo, mas nenhum item de trabalho aparece | AZURE_BOARDS_ENABLED está como false; ou o resultado foi FLAKY ou um resultado de ambiente; ou foi uma execução em ambiente isolado; ou o teste já tem um item de trabalho aberto (uma falha repetida adiciona um comentário). | Ative AZURE_BOARDS_ENABLED e use Criar chamado de teste para confirmar a conexão. |
Chaves de configuração
| Chave | O que faz | Valor válido | Como verificar |
|---|---|---|---|
AZURE_BOARDS_ENABLED | Criar itens de trabalho do Azure para falhas | true ou false | Ative depois que Verificar conexão indicar sucesso e execute Criar chamado de teste. |
AZURE_DEVOPS_ORG_URL | Endereço da organização do Azure DevOps | https://dev.azure.com/<organization> ou https://<organization>.visualstudio.com | Verificar conexão mostra a organização; colar um link preenche esse campo. |
AZURE_DEVOPS_PROJECT | Nome do projeto do Azure DevOps | O nome do projeto, exatamente como aparece no Azure DevOps | Verificar conexão lista os projetos aos quais o token tem acesso. |
AZURE_DEVOPS_PAT | Token de acesso do Azure DevOps (secreto, salvo apenas neste computador) | Uma linha, sem aspas, sem espaços | Verificar conexão: "recusou o token" significa que ele está incorreto, expirou ou é de outra organização. |
AZURE_BOARDS_WORK_ITEM_TYPE | Tipo de chamado do Azure para falhas | Um tipo disponível no processo do projeto: Bug (Agile, Scrum, CMMI) ou Issue (Basic) | Verificar conexão informa "<project> aceita itens de trabalho do tipo <type>" ou lista os tipos disponíveis no projeto. |
AZURE_BOARDS_DONE_STATE | Estado do Azure quando o teste é aprovado | Um estado desse tipo de item de trabalho: Resolved (bug do Agile), Done (issue do Basic) | Uma aprovação sem problemas muda o estado do item; se o processo recusar o estado, o item recebe apenas um comentário. |
AZURE_PIPELINE_ID | Pipeline do Azure para executar na CI | O ID numérico de um pipeline do Azure (apenas para Executar na CI) | nexus ci-remote --provider=azure coloca esse pipeline na fila; requer Compilação → Ler & executar. |
Mais: todas as integrações, o guia de Configurações, solução de problemas. Outros guias: Jira Cloud, Slack, Microsoft Teams, Telegram, GitHub Issues.
Ainda com dificuldades? Escreva para [email protected] com a linha exata do erro exibido pelo Studio. Não inclua nenhum token.