Conceito e mecanismo
O controller coordena jobs, estado e configuração; os agents executam trabalho num contexto com ferramentas e permissões próprias. Separar estas funções reduz a exposição dos dados administrativos ao código dos builds. Define zero executors no nó integrado e planeia capacidade em agents adequados.
Um executor livre não serve qualquer job: labels, estado online e restrições de scheduling determinam elegibilidade. O runtime Jenkins também precisa de compatibilidade entre componentes. Na baseline LTS 2.568.3, a política suporta Java 21 ou 25 para controller, agents e CLI.
O JDK usado para compilar uma aplicação é uma decisão distinta, embora plugins possam impor restrições adicionais.
Aplicação guiada
Numa plataforma fictícia de fundos, uma fila para linux && oracle-client não se resolve acrescentando capacidade Windows. Verifica primeiro a expressão, os agents elegíveis e a fase em que o trabalho está parado. Guarda o Jenkinsfile em controlo de versões para relacionar definição e revisão da aplicação.
Num projeto Multibranch, receber um webhook é apenas uma etapa: descoberta, filtros e indexing precisam de encontrar uma branch elegível. Regista commit, versão da pipeline e identidade do artifact em cada release. Fingerprints ajudam a seguir utilização de ficheiros entre builds, mas não substituem assinatura, testes ou armazenamento.
Uma relação rastreável permite ao suporte investigar sem reconstruir a história a partir de nomes informais.
Fila crescente e executors livres: comparar requisitos do job com capacidade elegível antes de escalar.
Armadilhas comuns
Capacidade como elegibilidade; workspace como isolamento; runtime como target da aplicação; fingerprint como assinatura.
Tópicos relacionados: Credenciais e fronteiras de confiança · Pipeline: âmbito, tempo e evidência · Entrega, aprovações e repetição
Diagnostica o contexto de execução e liga cada resultado à revisão que o produziu.
Referências
- Controller and agent isolation · Current primary documentation; Jenkins LTS 2.568.3 baseline
- Declarative syntax and timeout scope · Current primary documentation; Jenkins LTS 2.568.3 baseline
- Java runtime support · Current primary documentation; Jenkins LTS 2.568.3 baseline
- Versioned Jenkinsfile and credentials · Current primary documentation; Jenkins LTS 2.568.3 baseline
- Branch discovery · Current primary documentation; Jenkins LTS 2.568.3 baseline
- Artifact usage tracking · Current primary documentation; Jenkins LTS 2.568.3 baseline