Pular para o conteúdo principal

Repositórios Git e pipelines

Conecte o RuleForge ao repositório Git onde o seu time guarda regras e decoders. Depois da conexão, você consegue importar conteúdo existente, publicar alterações e, se quiser, acionar pipelines já configurados (GitHub Actions, GitLab CI, Jenkins).

Como funciona​

O RuleForge trabalha com duas camadas, nessa ordem:

  1. Conexão com o provedor Git (nível da organização) — cadastra o acesso ao GitHub, GitLab ou Gitea.
  2. Vínculo do projeto com um repositório — escolhe qual repositório e qual branch cada projeto do RuleForge espelha.

Você só precisa configurar a conexão uma vez; os projetos podem ter vínculos diferentes.

Provedores suportados​

  • GitHub (com Personal Access Token ou GitHub App)
  • GitLab (com diferentes tipos de token)
  • Gitea

Para ambientes corporativos mais sensíveis, o GitHub App costuma ser o caminho mais seguro.

Conectar seu Git​

  1. Abra Configurações → Integrações → Repositórios.
  2. Clique em Nova conexão.
  3. Escolha o provedor e informe as credenciais.
  4. Clique em Testar conexão — o RuleForge confirma se o acesso funciona antes de salvar.

Se o teste falhar, revise a credencial e o escopo de permissões no provedor.

Vincular um projeto ao repositório​

  1. No projeto desejado, abra Integrações → Git.
  2. Clique em Vincular repositório.
  3. Escolha a conexão criada no passo anterior.
  4. Selecione o repositório e a branch.
  5. O RuleForge analisa o repositório e sugere onde estão as regras e os decoders.
  6. Revise ou ajuste a sugestão e salve.

O RuleForge só deixa salvar depois que o vínculo for validado. Isso evita que um erro de configuração só apareça na hora de publicar.

Importar conteúdo existente​

Depois do vínculo, você pode trazer o conteúdo atual do repositório para dentro do RuleForge:

  1. Abra o projeto vinculado.
  2. Clique em Importar do Git.
  3. Confira o resumo: quantos arquivos, quais caminhos, últimas alterações.
  4. Confirme a importação.

O conteúdo aparece como um rascunho (workspace). Você ainda pode revisar tudo antes de publicar.

Publicar alterações​

Ao publicar a partir do RuleForge, você escolhe entre duas estratégias:

  • Pull request (ou merge request) — o RuleForge abre uma solicitação de merge no seu provedor, para revisão no fluxo que você já usa.
  • Commit direto — o RuleForge comita as alterações na branch vinculada. Ideal para ambientes de automação onde a revisão acontece em outra etapa.

A estratégia é configurada no vínculo do projeto e pode ser ajustada quando o processo do time mudar.

Acionar pipelines​

Se o seu time usa pipelines de CI para validar, testar ou fazer deploy do conteúdo publicado, o RuleForge pode dispará-los automaticamente ou sob demanda.

  1. Abra Configurações → Integrações → Pipelines.
  2. Escolha o provedor (GitHub Actions, GitLab CI ou Jenkins).
  3. Informe o alvo do pipeline e a credencial.
  4. Clique em Testar antes de salvar.

Depois de cadastrado, o pipeline pode ser acionado manualmente a partir do projeto, ou automaticamente conforme o fluxo da sua equipe.

Erros comuns​

O teste da conexão falha​

Revise a credencial no provedor, o escopo de permissões e, se aplicável, a instalação do GitHub App na sua organização.

A validação do vínculo falha​

O RuleForge não conseguiu encontrar as regras/decoders na estrutura do repositório. Ajuste os caminhos sugeridos na tela e rode a validação novamente.

A publicação não abre pull/merge request​

Confira a estratégia configurada no vínculo e se a credencial tem permissão para abrir PR/MR no provedor.