Como configurar uma integração bidirecional Jira GitHub

Este é um cenário comum na maioria das organizações: a equipe de desenvolvimento usa o repositório GitHub , enquanto a equipe de serviço usa o Jira Service Management. No entanto, a partilha de informações revela-se um desafio, uma vez que ambas as equipas estão em plataformas que não são compatíveis entre si.

Para preencher a lacuna, o gerente de projeto apresenta um serviço terceirizado Integração Jira GitHub para ajudar ambas as equipes no compartilhamento de dados automaticamente.

Neste guia, mostrarei como configurar uma integração bidirecional entre Jira e GitHub.

Quando você precisa de uma integração Jira GitHub?

Seguindo o cenário de exemplo mencionado anteriormente, os desenvolvedores e as equipes de atendimento ao cliente precisam de uma integração do Jira GitHub para compartilhar dados e centralizar esforços.

Suponha que um cliente apresente uma reclamação à equipe de atendimento. Nesse caso, o agente relator criará um problema no Jira com uma descrição, que também ficará visível para os desenvolvedores no problema do GitHub.

Agora, quando o desenvolvedor fizer alterações no problema — ou ele for resolvido — as alterações também refletirão no problema do Jira. Não há necessidade de atualizações manuais; não há necessidade de sair de suas respectivas plataformas de gestão de trabalho.

Outro caso para usar a integração do Jira GitHub é replicar o Relacionamento épico-filho usando listas de tarefas do GitHub . Isso ajuda a manter uma aparência de hierarquia no GitHub ao compartilhar informações de Epics de várias camadas.

Existem outros casos de uso para integrações GitHub Jira, mas você precisa escolher a solução iPaaS certa para explorar essas possibilidades.

Como escolher a ferramenta de integração certa

Aqui estão alguns fatores a serem considerados antes de escolher qualquer ferramenta de integração para Jira e GitHub.

• Flexibilidade e escalabilidade

  A solução de integração deve ser capaz de se adaptar a diferentes cenários de sincronização através do uso de mapeamentos personalizáveis ou mecanismos de script. Isso ajudará as equipes a ajustarem suas cargas de trabalho sem sobrecarregar a rede.

  
  

• Segurança

  Você precisa de uma ferramenta de integração que garanta segurança porque você está dando acesso à sua base de código e repositório. Portanto, esteja sempre atento aos controles de acesso baseados em funções, bem como aos protocolos de autenticação e criptografia.

  
  

• Descentralização

  Como parte da segurança, você precisa isolar a arquitetura do seu sistema, especialmente para colaborações entre empresas. A escolha de uma ferramenta de integração com arquitetura de locatário único oferece controle autônomo sobre a sincronização da sua empresa.

  
  

• Versatilidade

  As soluções de integração para Jira e GitHub devem ser capazes de lidar com diferentes cenários de integração. Quer se trate de um mapeamento simples ou de uma integração complexa baseada em código, a ferramenta deve ser capaz de lidar com isso de maneira elegante.

  
  

• Confiabilidade

  A integração deve ter capacidade para lidar com cargas crescentes enquanto mantém o tempo de atividade máximo. Se uma conexão falhar, a integração poderá ser retomada automaticamente quando a conexão for restaurada.

  
  

• Suporte e tratamento de erros

  Quando ocorre um erro, a solução deve fornecer recursos de depuração. Para problemas técnicos avançados, a equipe de suporte deve ser capaz de fornecer assistência e solução de problemas detalhadas.

Uma solução de integração que preenche todas essas caixas é Exalate — uma solução de integração bidirecional que permite sincronizações bidirecionais entre Jira e GitHub.

Como integrar Jira e GitHub usando Exalate

Para começar a compartilhar dados e controlar o seu lado da conexão como desejar, você precisa instalar o Exalate no Jira (no local ou na nuvem) e no GitHub.

Passo 1 - Instalar o Exalate no Jira

Vou ao Mercado Atlassiano e pesquise “Exalate Jira Issue Sync & More”.

Clique no botão “Experimentar gratuitamente” e selecione “Nuvem” nas opções que aparecem. Observe que você também pode instalar o Exalate em um servidor Jira ou data center, bem como Docker .

Escolha um site ou insira o endereço do site. Em seguida, clique em “Iniciar teste gratuito”. Você será redirecionado para o painel do Jira para confirmar a avaliação gratuita.

Voilá! Agora você instalou o Exalate no Jira Cloud.

Passo 2 - Instale o Exalate no GitHub

Pesquise “Exalate Two-Way Issue Sync” no mercado GitHub.

*Clique em “Configurar plano” e ele irá rolar para baixo até o painel de instalação. Clique em “Instalar gratuitamente”. Em seguida, clique em “Concluir o pedido e iniciar a instalação”.

Na tela de autorização, clique em “Instalar” e escolha a organização na qual deseja instalar o Exalate. Você será redirecionado para o console de administração do Exalate. Salve este link em algum lugar seguro.

\Escolha se deseja conceder acesso ao Exalate a todos os repositórios ou a alguns repositórios selecionados. Não se preocupe, você sempre pode alterar o acesso mais tarde.

\Clique em “Autorizar Exalate” para conceder ao Exalate acesso aos seus repositórios.

Insira seus dados de contato na tela de registro. Clique em “Concordar e enviar” para concluir o registro. O Exalate agora encaminhará um e-mail de verificação para sua caixa de entrada.

Vá para sua caixa de entrada e abra este link de verificação. Clique em “Verificar instância Exalate” na tela que aparece. Após a verificação, você será redirecionado para o console do Exalate.

A próxima tela exibida irá notificá-lo de que a validação foi bem-sucedida. Clique em “Continuar” para prosseguir.

Insira seu token pessoal gerado no GitHub. Siga as instruções na tela para gerar um token de acesso pessoal no campo “Token”.

Clique em “Login” para concluir o processo de instalação. E bum! Você está pronto para começar a fazer conexões.

Passo 3 – Conecte suas instâncias

A beleza do Exalate é que ele permite iniciar a conexão a partir do Jira ou do GitHub. O processo é semelhante e a interface é idêntica em ambas as plataformas.

Clique em “Iniciar conexão”. Insira o URL da instância de destino no campo designado. Se você não tiver um URL, clique no botão de alternância “Não tenho um URL”.

O Exalate oferece suporte a dois modos de configuração para uma integração do Jira GitHub:

Modo Básico (para configurações simples pré-construídas) e Modo Script (para configurações de script avançadas).

Vamos começar com o Modo Básico.

Selecione o projeto para onde deseja que os problemas recebidos sejam enviados e clique em “Avançar”.

Confirme se você tem acesso de administrador e clique em “Iniciar”.

Você será redirecionado automaticamente para a instância remota. Escolha um repositório e clique

"Confirme". Insira a chave do problema e clique em “Exalar” para prosseguir.

Viva! Você configurou sua primeira conexão básica.

Agora vamos para o modo Script. Inicie a conexão e verifique o URL da instância de destino conforme mencionado anteriormente. Mas em vez de escolher o Modo Básico, selecione Modo Script.

Digite o nome e a descrição da conexão antes de clicar em “Avançar”. Em seguida, selecione o projeto e clique em “Iniciar”.

Copie o código do convite para sua área de transferência. Vá para o outro lado e clique em “Aceitar convite”.

Digite o código de convite da sua área de transferência antes de clicar em “Avançar”. Em seguida, selecione um repositório e confirme.

Parabéns! Você configurou com êxito uma conexão no modo Script.

Passo 4 – Configure sua conexão

De volta ao painel do Exalate, vá até a conexão e clique no ícone “Editar conexão”.

Na guia “Regras”, você verá um mecanismo de script para “Sincronização de saída” e “Sincronização de entrada”. É aqui que a mágica acontece. Você pode personalizar suas conexões usando a linguagem Groovy.

Passo 5 - Criar gatilhos de sincronização automatizados

A seguir está a guia “Gatilhos”. Aqui você pode ver todos os gatilhos ativos para automatizar sincronizações.

Para configurar um gatilho, clique no botão “+ Criar gatilho”.

A seguir, selecione o tipo de entidade e insira a consulta. Para configurar gatilhos GitHub, use o Sintaxe de pesquisa avançada do GitHub e especifique o repositório. Os gatilhos do Jira usam o Jira Query Language (JQL).

Passo 6 - Comece a sincronizar

Com os gatilhos definidos, agora você pode começar a escrever regras para conectar suas instâncias do Jira e do GitHub. Você também pode rastrear erros usando o rastreamento de pilha no console.

Experimente regras simples de sincronização para descobrir como funciona a conexão. Depois de entender o básico, você pode adicionar outras regras ou editar as que já possui.

Cenários comuns de integração do Jira GitHub

• Projeto de repositório Git público : desenvolvedores com código público podem usar o GitHub para gerenciamento de projetos e rastreamento de problemas. Integre o Jira e o GitHub para inserir itens no Jira, permitindo monitorar discussões públicas de maneira privada. Atribua problemas da base de código pública, decida ações e sincronize os campos escolhidos com o GitHub. Isso garante a colaboração com a comunidade de código aberto, ao mesmo tempo que mantém as discussões internas confidenciais.

  
  

• Atendimento ao cliente e colaboração de engenharia : o atendimento ao cliente registra problemas no Jira, alguns exigindo atenção de engenharia. Com a integração Jira-GitHub, os problemas relevantes são transferidos automaticamente para o GitHub. Depois de resolvidas, as soluções são atualizadas no Jira, permitindo que o atendimento ao cliente comunique as correções aos clientes.

  
  

• Desenvolvimento de produto e garantia de qualidade : A equipe de qualidade garante que os produtos atendam aos padrões legais globais. Eles rastreiam e tratam de questões legais enquanto monitoram continuamente a qualidade do produto. Com a integração, questões legais e relacionadas à qualidade são enviadas automaticamente para a equipe de desenvolvimento no GitHub. À medida que os desenvolvedores resolvem os problemas, a equipe de qualidade é atualizada automaticamente por meio do Jira.

• 
  

Principais conclusões

Mover dados entre sistemas de gerenciamento de trabalho pode ser uma tarefa difícil. Mas com uma solução de terceiros confiável e segura como o Exalate, as equipes podem compartilhar informações de maneira integrada.

Configurar sua conexão com o Exalate é um processo simples. Você pode usar o modo básico sem código ou optar pelo modo Script baseado em código. E se quiser controlar tickets em massa, você pode Bulk Exalate com gatilhos personalizados.

Se você tem um caso de uso específico e deseja saber como ele pode ser implementado com o Exalate, agende uma sessão gratuita com um engenheiro de integração e veja-o em ação!