APRENDER. PRATICAR. EVOLUIR.Conceito e mecanismo
Uma Pipeline Declarative descreve onde e como executar stages. Com agent none no topo, cada stage que precisa de workspace e shell deve obter o contexto adequado. Uma variável no environment de um stage não é automaticamente partilhada com o seguinte. Escolhe o âmbito necessário para configuração comum e mantém secrets limitados. A localização de timeout também altera o significado: nas options de um stage com agent próprio, a alocação entra no limite; no agent de topo, o timeout global começa após a alocação. Esta diferença ajuda a explicar falhas antes de qualquer comando de aplicação. Mede espera e execução separadamente em vez de aumentar todos os limites.
Aplicação guiada
Numa pipeline fictícia, testes produzem um pequeno relatório num agent e outro stage precisa de o analisar. Stash e unstash permitem transferir ficheiros no fluxo da execução. Para vários gigabytes ou releases duráveis, avalia um repositório de artifacts ou um Artifact Manager compatível; evita sobrecarregar o controller com compressão e estado desnecessários. A recolha de relatórios deve ser tentada também após falha, usando post always no âmbito apropriado. O bloco não cria ficheiros que o teste nunca produziu e pode precisar de tratar workspace indisponível. Mantém o resultado original e distingue falha do teste de falha na publicação da evidência. Assim, APS recebe informação útil mesmo quando o caminho normal é interrompido.
Oito minutos para obter agent e três de comandos excedem timeout de stage de dez minutos.
Armadilhas comuns
Variável local como global; stash como arquivo de releases; post como garantia de ficheiros; timeout como CPU.
Tópicos relacionados: Arquitetura, agents e rastreabilidade · Credenciais e fronteiras de confiança · Entrega, aprovações e repetição
Define contexto, âmbito e retenção de resultados em cada etapa.
Referência: Declarative syntax and timeout scope · 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