DocumentaciónAjuda

Conectar o GitHub ou o GitLab

Vincule branches, commits e pull ou merge requests aos itens das suas mesas ágeis, e mude o status do item ao abrir o PR ou ao fazer merge.

Nesta página

Com esta integração, cada branch, commit e pull request (GitHub) ou merge request (GitLab) que menciona a chave de um item, por exemplo APP-123, fica vinculado a esse item na sua mesa ágil. Opcionalmente, o item avança de status sozinho ao abrir o PR ou o MR e ao fazer merge.

Os cartões do GitHub e do GitLab levam a marca Proposto: o design desta integração ainda pode mudar.

Antes de começar

  • No Elion ITSM, você precisa de Administrar no módulo Configurações (por exemplo, a função Administrador).

  • No GitHub ou no GitLab, você precisa de permissão para criar webhooks no repositório ou no projeto.

  • Você pode criar uma conexão por repositório, ou uma só e usar a URL dela em vários repositórios.

Passo 1: conectar no Elion ITSM

  1. Entre em Configurações → Integrações.

  2. No cartão GitHub ou GitLab, clique em Conectar.

  3. Preencha:

    • Nome: por exemplo, o nome do repositório.

    • Mesas ágeis onde buscar os itens (nenhuma marcada = todas): marque as mesas cujos itens podem ser mencionados.

    • Regras opcionais (só avançam o item):

      • Ao abrir o PR, mover para (status) (no GitLab, Ao abrir o MR, mover para (status)): vem review.

      • Ao fazer merge, mover para (status): vem qa.

      Escreva a chave do status em minúsculas, como aparece nos ajustes da mesa. Deixe vazio para não mover o item.

  4. Clique em Conectar.

Abre-se uma janela que é exibida uma única vez, com a URL do webhook e o Segredo do webhook (no GitLab, Secret token). Use Copiar URL e Copiar segredo. Não a feche até terminar o passo 2.

Passo 2: criar o webhook no repositório

No GitHub

  1. No repositório, entre em Settings → Webhooks → Add webhook.

  2. Em Payload URL, cole a URL. Em Content type, escolha application/json. Em Secret, cole o segredo.

  3. Nos eventos, marque Pushes e Pull requests.

  4. Salve o webhook.

No GitLab

  1. No projeto, entre em Settings → Webhooks.

  2. Em URL, cole a URL. Em Secret token, cole o segredo.

  3. Marque Push events e Merge request events.

  4. Salve o webhook.

Volte ao Elion ITSM e clique em Pronto, já copiei.

O que acontece depois

  • Ao fazer push ou abrir um PR ou MR que mencione APP-123 no nome do branch, em um commit ou no título, o item APP-123 fica vinculado.

  • Se você definiu regras, o item passa para o status indicado ao abrir o PR ou o MR e ao fazer merge. As regras só fazem o item avançar.

  • A conexão mostra Último contato com a data do último evento recebido.

Peça à equipe que nomeie os branches com a chave do item, por exemplo APP-123-login-con-google. É a forma mais simples de deixar tudo vinculado.

Rotacionar a URL e o segredo

Se você acha que a URL ou o segredo vazaram, clique em Rotacionar URL e segredo e confirme com Rotacionar. Os atuais deixam de funcionar na hora: cole os novos no webhook do repositório.

Relacionado

Pesquisar em Elion ITSM

Digite pelo menos 2 letras para pesquisar em Elion ITSM.

↑↓ navegar · Enter abrir · Esc fechar