APRENDER. PRATICAR. EVOLUIR.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ência: Controller and agent isolation · Jenkins LTS 2.568.3 historical exercises; LTS 2.580.1 documentation reviewed 2026-10-02; Java 21 or 25 runtime; plugin versions require confirmation