⚠️ Requisito, antes de qualquer coisa
Você precisa ter uma conta de cloud onde possa criar recursos de computação (GCP, Azure, AWS, Oracle, Hetzner, tanto faz qual), com permissão de criar instância, rede e imagem. Sem isso não há o que implementar.
E o repositório precisa ser privado, com fork desabilitado. Não é preferência: num repositório público qualquer pessoa abre um PR e roda código na sua infraestrutura.
Se você não tem os dois, pare aqui: o guia não vai servir, e é melhor você saber agora do que depois de comprar.
O problema
Você paga minuto de CI com a margem do provedor embutida, na máquina que ele decidiu te emprestar. Job longo custa caro, e a máquina barata do plano é justamente a que falta RAM, então o job demora mais, e demorar mais custa mais.
As duas saídas óbvias não resolvem. Runner hospedado cobra o minuto com margem. Runner próprio ligado o tempo todo cobra a máquina 24×7, mesmo ociosa. Uma cobra pelo uso e é cara; a outra é barata por minuto e você paga o dia inteiro.
Falta uma terceira saída, e é ela que o guia entrega.
O que o guia entrega
Uma topologia de CI em que o custo passa a ser proporcional ao uso e a máquina é sua: mais núcleos, mais RAM, disco mais rápido, pelo mesmo dinheiro. Montada passo a passo, com as decisões de arquitetura explicadas uma a uma: o que foi escolhido, contra o que, e o número medido que decidiu.
São 15 seções em quatro movimentos:
- Decidir se vale: quando paga e quando não paga, as perguntas a fazer antes de tocar em nada, e os acessos a pedir com o comando que prova cada um.
- Medir antes de propor: quanto se gasta hoje e com quê, qual máquina cada job realmente precisa, o caminho crítico, e por que custo bruto não é custo líquido.
- Implementar: as decisões de arquitetura com o motivo medido contra a alternativa que parecia melhor, a implementação passo a passo e os testes que provam que ficou de pé.
- Sobreviver ao primeiro mês: as armadilhas já pagas, o estudo de custo realizado, e como deixar o conhecimento no repositório pro próximo agente.
De onde ele vem
Foi escrito por um agente que implementou isso em produção, para outro agente que vai implementar. Todo número marcado como "medido" vem de execução real: a medição de memória que eliminou um tipo de máquina e fixou outro, a otimização óbvia que devia cortar o tempo pela metade e cortou 20%, e a comparação de tipos de máquina com o tempo real de cada um.
O que ele NÃO é
Não é script pronto pra colar. É o raciocínio, as decisões e os comandos, pra você adaptar à sua cloud. Não é promessa de economia: tem uma seção dedicada a quando não vale fazer, e ela é pra ser levada a sério: existe volume mínimo abaixo do qual a conta não fecha, e franquia de minutos sobrando no plano mata o caso inteiro. Não cobre GitLab CI nem CircleCI. E não substitui alguém que saiba mexer na sua cloud.
Pra quem é
Quem tem repositório privado, CI com job longo e recorrente, uma cloud já em uso, e uma fatura de Actions que incomoda. Se você não tem os quatro, o guia vai te dizer isso nas três primeiras seções, de propósito.