Git auto-hospedado
Conecte uma instância própria de Forgejo, Gitea ou GitLab para espelhar pull requests e merge requests nas tarefas do Jiraya.
Se a sua equipe usa um servidor Git próprio, conecte a instância ao workspace para ver nas tarefas os pull requests (ou merge requests, no GitLab) que as resolvem. O Jiraya suporta Forgejo, Gitea e GitLab.
A conexão serve para espelhar os PRs. Os agentes enviam branches e abrem PRs com as credenciais Git do próprio runtime, como em qualquer repositório.
Conectar uma instância
Só proprietários e administradores do workspace conectam, desconectam ou geram um novo webhook. Os outros membros veem as conexões existentes.
Crie um token de acesso no provedor
O token precisa de permissão de leitura dos repositórios:
- Forgejo ou Gitea: em Settings › Applications, crie um token com leitura de repositórios.
- GitLab: crie um token de acesso pessoal com o escopo
read_api.
Conecte no Jiraya
Vá em Configurações › Integrações e, em Código e repositórios, abra Provedores Git (auto-hospedados). Preencha:
- Provedor: Forgejo, Gitea ou GitLab;
- URL da instância: o endereço completo, como
https://git.acme.com.br; - Token de acesso: o token criado no passo anterior.
Clique em Conectar. O Jiraya valida o token direto na instância antes de salvar a conexão.
Cadastre o webhook no provedor
Depois de conectar, a tela mostra a URL do webhook e o Segredo do webhook.
Atenção
Copie o segredo na hora. Ele aparece uma única vez e não pode ser recuperado depois.
Cadastre o webhook no repositório ou na organização do provedor:
- Forgejo ou Gitea: escolha o tipo Gitea, cole a URL e o segredo e ative os eventos Pull Request e Commit Status.
- GitLab: cole a URL, use o segredo como Secret token e ative os eventos Merge request e Pipeline.
O que é espelhado
A cada evento do provedor, o Jiraya atualiza:
- o estado do PR: aberto, rascunho, mesclado ou fechado;
- o autor, o branch e o tamanho da mudança;
- o resultado agregado do CI.
Os PRs aparecem na seção Pull requests do detalhe da tarefa, junto com os do GitHub. A seção segue a chave Barra lateral de Pull Request das configurações do GitHub, ligada por padrão.
Vincular PRs e concluir tarefas
As regras de vínculo são as mesmas do GitHub. O PR é vinculado à tarefa quando o identificador dela, como ACME-42, aparece:
- no título do PR;
- no nome do branch;
- no corpo, logo depois de uma palavra de fechamento:
close,closes,closed,fix,fixes,fixed,resolve,resolvesouresolved.
Quando um PR que cita a tarefa com palavra de fechamento no título ou no corpo recebe merge, e nenhum outro PR vinculado continua aberto, a tarefa vai para Concluído. Diferente do GitHub, aqui não há chave para desligar esse comportamento.
Gerar um novo segredo
Se o segredo vazar, clique em Gerar novo webhook. O segredo anterior para de funcionar na hora, e as entregas do provedor falham até você atualizar o segredo no webhook cadastrado. Conectar de novo a mesma instância também gera um segredo novo.
Desconectar
Clique em Desconectar na conexão. O Jiraya remove os PRs espelhados dessa conexão, os vínculos com as tarefas e os resultados de CI. Essa ação não pode ser desfeita. Remova também o webhook no provedor.
Próximos passos
- Configure o GitHub em GitHub.
- Dispare agentes a partir de eventos do GitLab, como uma falha de pipeline, com um webhook em Autopilots.
Atualizado em