Conectar Jira Cloud: guia passo a passo
Cria um Bug para cada teste que falha, adiciona um comentário quando o teste falha novamente e o move para Concluído quando o teste passa sem problemas. Este guia orienta você desde o início até a verificação da conexão 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
- Um site do Jira Cloud, por exemplo https://your-team.atlassian.net (somente Jira Cloud; o endereço deve usar https).
- O e-mail da sua conta Atlassian e um token de API criado com essa mesma conta.
- Uma chave de projeto, por exemplo QA, cujo projeto tenha um tipo de item chamado Bug.
- Nesse projeto, permissão para essa conta navegar, criar itens, adicionar comentários, criar anexos e realizar transições de itens.
Obtenha as credenciais
- Abra https://id.atlassian.com/manage-profile/security/api-tokens e selecione Criar token de API.
- Dê um nome a ele (por exemplo "Nexus StudioQA"), escolha uma data de expiração, crie-o e copie o token agora. A Atlassian o exibe apenas uma 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 Jira.
- Cole qualquer link do seu Jira (a página inicial, um quadro ou um item) e pressione Verificar conexão. O Studio guarda o endereço do site e a chave do projeto.
- Quando solicitado, insira seu e-mail da Atlassian e o token e pressione Salvar & verificar.
- Selecione o projeto em "Destino dos bugs" e ative
JIRA_ENABLED.
Verifique se funciona
- Verificar conexão exibe "Conectado como <your name>" e "<KEY> aceita chamados do tipo Bug". A verificação apenas consulta dados; nunca abre um chamado.
- Abra Configurações → Integrações → Chamados e pressione Criar chamado de teste. Essa ação cria um chamado com a etiqueta nexus-test e é o único clique nessa tela que faz uma chamada ao Jira.
- Abra esse chamado no Jira e confirme que ele tem as etiquetas auto-generated, nexus-studioqa-automation e nexus-test. Exclua-o quando terminar.
Erros comuns
| O que você vê | Causa | Solução |
|---|---|---|
| "Isso não é um link" ou "Um link do Jira começa com https://" | O texto colado não é um endereço da web completo ou começa com http://. | Copie o endereço da barra de endereços enquanto estiver no seu site do Jira. Ele deve começar com https://. |
| HTTP 401 | O e-mail ou o token está incorreto, o token expirou ou foi revogado, ou o e-mail não corresponde à conta que criou o token. | Crie um novo token em id.atlassian.com com a conta cujo e-mail você salvou e salve ambos novamente em Configurações. |
| HTTP 403 | A autenticação funciona, mas o Jira informa que a conta não tem autorização para essa ação: geralmente falta a permissão Criar itens, Adicionar comentários ou Criar anexos no projeto. | Peça essas permissões ao administrador do projeto ou escolha outro projeto. O Nexus StudioQA não pode concedê-las. |
| HTTP 404 | O endereço do site ou a chave do projeto não existe, ou essa conta não pode visualizar o projeto (o Jira retorna 404 para projetos que ele oculta). | Cole qualquer link do site correto e escolha o projeto na lista. |
| "Esse endereço respondeu, mas não com uma conta do Jira" | O endereço não é de um site do Jira Cloud (por exemplo, é um endereço do Server ou Data Center, ou outra página da web). | Use o endereço https://<team>.atlassian.net do seu site do Jira Cloud. |
| "<KEY> não tem um tipo de item chamado Bug" | O projeto não tem um tipo de item chamado Bug, então nenhum chamado pode ser criado. | No Jira, abra Configurações do projeto → Tipos de item e adicione Bug, ou escolha outro projeto. |
| "não foi possível acessar o Jira (ENOTFOUND)" ou "não respondeu em até 20 s" | Este PC não consegue acessar o site: há um erro de digitação no endereço, uma VPN ou um proxy, ou não há conexão de rede. | Corrija o endereço e abra o site em um navegador no mesmo PC. Tente verificar novamente. |
| Está tudo certo na verificação, mas nenhum chamado aparece | JIRA_ENABLED está como false; ou o resultado foi FLAKY ou relacionado ao ambiente; ou foi uma execução em ambiente isolado; ou já existe um Bug aberto para esse teste (uma falha repetida gera um comentário); ou um Bug com o mesmo título foi criado nas últimas 24 horas. | Ative JIRA_ENABLED, leia "Um item por teste" na página de integrações e use Criar chamado de teste para confirmar a conexão. |
| Um teste aprovado não fecha seu chamado | O fluxo de trabalho não tem uma transição com o nome definido em JIRA_DONE_TRANSITION, então o chamado só recebe o comentário. | Defina JIRA_DONE_TRANSITION com o nome exato do botão de transição no seu fluxo de trabalho. |
Chaves de configuração
| Chave | O que faz | Valor válido | Como verificar |
|---|---|---|---|
JIRA_ENABLED | Criar chamados no Jira para falhas | true ou false | Ative a integração e execute Criar chamado de teste. |
JIRA_BASE_URL | Endereço do site do Jira | https://<site>.atlassian.net | Verificar conexão mostra o site; colar um link preenche esse campo. |
JIRA_EMAIL | E-mail de acesso ao Jira | O e-mail da conta Atlassian à qual o token pertence | Verificar conexão mostra "Conectado como …" com este e-mail. |
JIRA_API_TOKEN | Token de acesso ao Jira (secreto, salvo apenas neste computador) | Uma linha, sem aspas, sem espaços | Verificar conexão: HTTP 401 significa que a combinação de e-mail e token está incorreta. |
JIRA_PROJECT_KEY | Projeto do Jira para chamados do tipo Bug | A chave do projeto, geralmente em letras maiúsculas, por exemplo QA | O projeto aparece na lista suspensa; "aceita chamados do tipo Bug" confirma o tipo. |
JIRA_DONE_TRANSITION | Status no Jira quando o teste é aprovado | O nome exato de uma transição do fluxo de trabalho, sem diferenciar maiúsculas de minúsculas | Uma aprovação sem problemas move o chamado; se o fluxo de trabalho não tiver essa transição, ele só recebe um comentário. |
Mais: todas as integrações, o guia de Configurações, solução de problemas. Outros guias: Azure Boards, 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.