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(semprehttps://),AIUBY_RUNNER_TOKEN_FILE,AIUBY_RUNNER_WORKDIReAIUBY_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.
{
"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