Como configurar as integrações Jira do Gitlab

Jira é um produto de rastreamento de problemas popular, comumente usado para facilitar o desenvolvimento ágil de software. Ele vem com suporte para o controle de origem do próprio Atlassian, BitBucket, que vincula problemas diretamente a commits, mas você também pode habilitar o mesmo suporte para Gitlab.

O que a integração faz?

Basicamente, a integração do Jira com o Gitlab permite vincular os problemas do Jira aos commits do Git. Sempre que mudanças são enviadas ao Gitlab, ele verifica se algum problema do Jira é mencionado na mensagem de confirmação ou descrição e adiciona um comentário ao problema.

Este é um recurso simples, mas é crucial para vincular as duas plataformas. Digamos que você forneça a um desenvolvedor um conjunto de questões para trabalhar em um sprint de código. Esse desenvolvedor cria vários commits e os envia para o Gitlab sempre que as tarefas são concluídas, mencionando problemas no processo. Quando o gerente de projeto passar por Jira, ele &’ será capaz de ver rapidamente os commits relacionados para quaisquer problemas, já que haverá links para cada commit sobre o problema.

Isso funciona de outra maneira também — com o Gitlab, você &’ poderá ver rapidamente quais problemas um commit menciona. Isso basicamente economiza um clique, mas é um bom recurso para quando você tem muitos problemas.

Com a integração, você também pode automatizar o fechamento de questões de mensagens de confirmação. Se você precisar que os desenvolvedores movam problemas de “ Em andamento ” para “ Em revisão, ” você pode configurar o Gitlab para fazer isso sempre que alguém escrever ” Resolve PROJECT-1 ” em uma mensagem de confirmação.

Os mesmos recursos também têm suporte para solicitações de mesclagem, úteis quando você tem um desenvolvedor trabalhando em seu próprio branch que precisa ser mesclado com o master.

Configurando a integração Jira

A integração do Jira é configurada por projeto, então vá para a página do seu projeto e clique em “ Configurações ” > “ Integrações ”:

Role para baixo na lista de “ Serviços de projeto ” para localizar e clicar em “ Jira. ” Você terá que configurar várias coisas aqui.

Primeiro, você deseja ativar a integração em primeiro lugar marcando “ Ativo. ” Você também pode desativar os acionadores de solicitação de confirmação e mesclagem, mas provavelmente você os quer.

Em seguida, insira o seu URL da web Jira. Se você estiver usando a versão de nuvem gerenciada de Jira (em atlassian. net), você colocará o URL de nomedaempresa. atlassian. net. Se você estiver hospedando o Jira por conta própria, colocará o URL da sua instância, provavelmente algo como jira. companyname. com. Opcionalmente, se você estiver hospedando o Jira por conta própria e colocar a API em um domínio diferente, você vai querer inseri-lo aqui.

Se você estiver usando a versão em nuvem do Jira, convém incluir seu e-mail e um token de API, que pode ser obtido nesta página. Crie um novo token e cole-o na caixa do Gitlab. Isso autenticará o Gitlab em sua conta Atlassian. Se você estiver usando o Jira auto-hospedado, basta inserir seu nome de usuário e senha.

De qualquer maneira, você provavelmente desejará criar uma conta de serviço para que as mensagens do “ Gitlab ” em vez de sua conta de usuário pessoal. Se você não quiser pagar por uma conta extra, a sua conta pessoal funcionará bem.

Em seguida, você precisará fornecer ao Gitlab uma lista de IDs de transição. Eles definem os diferentes estágios de problemas, por exemplo, “ Todo ”, “ Em andamento ” e “ Concluído ”. É estranho que o Gitlab não configure isso automaticamente, mas você pode obter uma lista deles na API Jira acessando o seguinte URL em seu navegador:

 https://yourcompany. atlassian. net/rest/api/2/issue/ISSUE-1/transitions 

Observe que você precisará substituir “ suaempresa ” para o seu URL Jira real e sub no “ PROBLEMA-1 ” para um ID de problema real. Isso dará

 var x = `cole a resposta aqui` console. log (JSON. parse (x) . transitions. map ((d) = > d. id) . join (',')) [/ PRE ]
 Que retornará algo como 11, 21, 31 (o padrão) que você inserirá na caixa ID de transição. 
 Usando a integração Jira 
 O uso da integração Jira é bastante simples. Não há caixas para verificar ou alavancas para puxar, simplesmente mencione um ID de problema Jira em qualquer lugar no assunto ou descrição de um commit &’ o Gitlab postará automaticamente um comentário sobre o problema com um link de volta para a página de commit: 
 
 
 Isso é bom e tudo, mas ser capaz de fechar problemas de commits é ainda melhor. Atualmente, existem três palavras-chave que você pode usar para fechar um problema: 
 
 Resolve PROJECT-1 
 
 Fecha PROJECT-1 
 
 Corrige PROJECT-1 
 
 Você pode escrever estes inline em mensagens de commit ou descrições: 
 
 
 Cada um deles fará a mesma coisa — mover o problema relacionado para o último ID de transição especificado na lista. Se você não quiser que os desenvolvedores movam os problemas diretamente para “ Concluído, ” você pode configurar o Gitlab para enviar commits para “ Em revisão ” em vez disso, deixando de fora os IDs de transição para as categorias indesejadas.