This page is not yet available in English. Read it in Portuguese

Skip to content
Menu da documentação

CI e integrações

Runner próprio

Rode os jobs dos pipelines numa VM ou num cluster seu: um agente pull com uma chave por runner, serviços auxiliares, cache e limites de recurso.

#Como funciona

O runner é um agente que roda do seu lado e busca trabalho na AIUBY por HTTPS de saída: nenhuma porta precisa ser aberta. Ele executa o job do pipeline num contêiner Docker com a mesma imagem do executor gerenciado, e também playbooks Ansible (por padrão em --check --diff) e migrações de banco aprovadas.

#Instalação

  • Cadastre o runner em Software Delivery › Operação, com os rótulos dele. A chave do runner aparece uma vez.
  • Grave a chave num arquivo e instale o agente numa VM com Docker ou como Deployment no Kubernetes (manifesto com Docker-in-Docker).
  • Variáveis principais: AIUBY_URL (sempre https://), AIUBY_RUNNER_TOKEN_FILE, AIUBY_RUNNER_WORKDIR e AIUBY_RUNNER_MEMORY/CPUS/PIDS (padrão 4g, 2 e 1024 por contêiner).
  • A conexão de banco para migração fica só no runner, em AIUBY_DB_<BANCO>: a AIUBY não guarda essa credencial.

#No pipeline

O estágio escolhe o runner pelos rótulos em runsOn. Só com runsOn o estágio pode ter serviços auxiliares e cache.

json
{
  "name": "test",
  "image": "node22",
  "runsOn": ["linux", "rede-interna"],
  "services": [{ "name": "db", "image": "postgres:16", "env": { "POSTGRES_PASSWORD": "teste" } }],
  "cache": { "presets": ["npm"] },
  "steps": [{ "name": "testes", "run": "npm ci && npm test" }]
}
  • Até 4 serviços na rede do job, chamados pelo nome.
  • Cache por ferramenta (npm, pnpm, yarn, pip, módulos Go, Maven, Gradle, build Go), no escopo da branch, com teto de 500 MB por workspace. Pull request só lê o cache.
  • CPU e memória de cada job ficam registradas na execução.

#Segurança

  • Uma chave por runner, com escopo próprio; o job fica preso ao runner e à organização que o pediu.
  • Pull request de fork não chega ao runner: é bloqueado antes do despacho.
  • Variáveis e segredos do pipeline chegam cifrados por job, como no executor gerenciado.

Atenção

O runner executa o código do seu repositório com acesso à rede onde está instalado. Instale-o num lugar com o acesso que os jobs precisam, e só esse.