Vincular código do GitHub ou GitLab às tarefas

Os desenvolvedores podem vincular o código às tarefas sem sair do GitHub ou do GitLab. Quando uma mensagem de commit, um nome de branch ou um pull request (um merge request no GitLab) menciona o número de uma tarefa, como CBS-74-T357, ele aparece na aba Código vinculado dessa tarefa. Isso faz parte do pacote Business, e só administradores podem conectar.

Conectar um repositório

1. Abra Configurações e escolha Integrações.
2. Em GitHub e GitLab, digite um Nome (por exemplo Mobile app), escolha GitHub ou GitLab e clique em Conectar.
3. O Kaam360 mostra um Endereço e um Segredo. Copie os dois agora: o segredo é mostrado só uma vez.
4. No GitHub, abra o repositório (ou sua organização) e depois Settings, Webhooks, Add webhook. Cole o endereço em Payload URL, escolha application/json, cole o segredo em Secret, escolha Let me select individual events, marque Pushes e Pull requests e clique em Add webhook.
5. No GitLab, abra o projeto (ou seu grupo) e depois Settings, Webhooks, Add new webhook. Cole o endereço em URL e o segredo em Secret token, marque Push events e Merge request events e clique em Add webhook.

O GitHub envia na hora uma mensagem de teste. A conexão passa a mostrar Ativo e o que a última mensagem fez.

Mencionar uma tarefa

Copie o número da tarefa, que fica no topo dela (por exemplo CBS-74-T357), para:

• uma mensagem de commit, como Fix the login button (CBS-74-T357);
• um nome de branch, como feature/CBS-74-T357-login;
• o título ou a descrição de um pull request.

O número precisa incluir o código do próprio projeto, assim um número de outro projeto nunca é vinculado por engano. Abra a tarefa e escolha a aba Código vinculado para ver cada commit, branch e pull request vinculados, com repositório e autor e, num pull request, se está aberto, mesclado ou fechado. Clique numa linha para abri-la no GitHub ou GitLab. O histórico da tarefa também mostra quando o código foi vinculado.

Concluir tarefas quando um pull request é mesclado

Marque Marcar como concluídas as tarefas mencionadas numa conexão. Quando um pull request que menciona uma tarefa é mesclado, a tarefa passa a concluída, como se o administrador que criou a conexão tivesse feito isso.

Manter seguro

• O Kaam360 verifica o segredo em cada mensagem e recusa tudo o que não o tiver.
• Se o segredo pode ter vazado, clique no botão da chave (Novo segredo) e coloque o novo segredo nas configurações do webhook. O antigo para de funcionar na hora.
• Clique em Pausar para parar de vincular por um tempo, ou em Remover para excluir a conexão e os vínculos que ela criou. Remova o webhook no GitHub ou GitLab também.

Se algo der errado

• Nada é vinculado: confira se o número inclui o código do projeto e o número de tarefa certo, e se o webhook envia pushes e pull requests.
• O GitHub mostra uma marca vermelha numa entrega: o endereço ou o segredo está errado. Clique em Novo segredo e cole-o de novo.