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
Entre em Configurações → Integrações.
No cartão GitHub ou GitLab, clique em Conectar.
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.
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
No repositório, entre em Settings → Webhooks → Add webhook.
Em Payload URL, cole a URL. Em Content type, escolha
application/json. Em Secret, cole o segredo.Nos eventos, marque Pushes e Pull requests.
Salve o webhook.
No GitLab
No projeto, entre em Settings → Webhooks.
Em URL, cole a URL. Em Secret token, cole o segredo.
Marque Push events e Merge request events.
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-123no nome do branch, em um commit ou no título, o itemAPP-123fica 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.