Cron & Scheduling

cron Jenkins · Veja a faixa antes de agendar

Monte uma expressão Core e confira as faixas H e o fragmento Pipeline correspondente.

cron Jenkins

Expressão

A entrada é processada neste navegador e não é enviada a um servidor.

Explicação e fragmento Pipeline

Opções

Construtor por campos

Estes campos são um rascunho. Só Aplicar substitui a expressão acima; o texto colado continua sendo a entrada validada.

H/15 * * * *

Minuto 0–59; hora 0–23; dia 1–31; mês 1–12; semana 0–7. Listas numéricas, faixas, */passo, faixa/passo ou H. Número isolado/passo não é aceito.

A entrada ou as opções mudaram. Atualize os resultados antes de exportar.

O cron Jenkins usa H para distribuir tarefas, mantendo um valor estável para cada job. Este gerador separa os valores fixos dos possíveis pontos de partida, sem transformar um hash desconhecido em um horário que pareça confirmado.

Cole uma expressão cron ou monte os cinco campos no rascunho. No agendamento, cron solicita a compilação mesmo sem alterações; pollSCM consulta o repositório. A escolha do gatilho muda o objetivo, embora os campos tenham a mesma sintaxe.

Por que conferir o cron Jenkins

Separar intervalo e início

No cron Jenkins, */15 marca os minutos 0, 15, 30 e 45. H/15 escolhe um início de 0 a 14 e avança de 15 em 15. O relatório apresenta esses inícios como possibilidades, sem dizer que o job roda em cada minuto candidato.

Duas linhas do tempo comparam quatro marcas alinhadas e quatro marcas deslocadas pelo mesmo intervalo.

Respeitar o limite da janela

H(0-29)/10 começa entre 0 e 9 e fica na primeira metade de cada hora. As três marcas não passam de 29. Mostrar o início possível e o limite final evita interpretar o passo como uma repetição que também ocupa a segunda metade.

Três marcas igualmente espaçadas ficam apenas na primeira metade destacada de uma linha do tempo.

Revisar o rascunho antes de trocar a expressão

01

Aplicar depois da prévia

Os modelos alteram apenas os cinco campos do rascunho. A prévia compara o texto antigo, o novo e seus tamanhos. Aplicar substitui a entrada; Desfazer recupera a expressão, as opções e o resultado anterior juntos.

02

Usar o nome como anotação

O nome completo pode incluir pastas para identificar o job no relatório. Ele não ativa o cálculo do hash. Mesmo com o nome exato, a faixa continua sendo uma possibilidade, não uma lista de horários confirmados.

03

Escolher o gatilho e atualizar

Use cron para compilações periódicas ou pollSCM para consultar mudanças. A análise automática espera 350 ms; desligue-a para executar com Ctrl/Cmd + Enter. Alterações na entrada bloqueiam a exportação até a próxima análise.

Ler as condições que formam o gatilho

Cinco campos numéricos

Minuto, hora, dia do mês, mês e dia da semana aceitam listas, faixas inclusivas e passos em faixas ou asteriscos. Valores repetidos são removidos e domingo 7 é agrupado com 0 no relatório numérico, preservando a escrita da expressão original.

Uma explicação por item H

Em H(10-20)/4, os inícios possíveis vão de 10 a 13. A quantidade de valores depende do início, portanto não se afirma que sempre haverá três execuções. Listas com números e hashes mantêm a condição de cada item separada.

Aliases conforme o padrão do Core

Os sete aliases incluem @annually. Por padrão, @monthly vira H H H * *, com o dia também escolhido pelo hash. @midnight vira H H(0-2) * * *, uma janela que não equivale a meia-noite em ponto.

Fragmentos Pipeline para cada uso

Copie só a expressão ou o bloco triggers com cron ou pollSCM. O download em texto reúne as condições, o gatilho e a anotação do job. O nome digitado livremente nunca entra no código Groovy executável.

Limites da validação e dos horários

Sem horário real calculado
A sequência aleatória Java, o estado hash compartilhado entre linhas e o fuso do controlador não são reproduzidos. Alterações administrativas no hash dos aliases também ficam fora do modelo. Confirme a programação real na sua instância Jenkins.
Uma linha da sintaxe Core
A expressão aceita até 512 unidades UTF-16 e o nome, 1024. Não há segundos, ano, JAN/MON, ?, L, W, #, 5/15, cabeçalhos TZ=, comentários, comandos ou importação de Jenkinsfile completo. H deve ser maiúsculo.
Dia do mês e da semana devem coincidir
As duas condições são combinadas com AND. Um dia 31 de fevereiro pode ter sintaxe válida sem existir. O H simples no dia usa 1–28; H(29-31) pode selecionar datas ausentes. Passos diários não mantêm a mesma duração na virada do mês.
H/1 seleciona um valor
H/1 funciona como H; */1 seleciona todos os valores. Um passo de hash maior que 1 deve caber na faixa escolhida. Jobs diferentes ainda podem coincidir. A página não se conecta ao Jenkins, não cadastra jobs e não inicia compilações.

Dúvidas sobre cron Jenkins

O que significa H/5?

No campo dos minutos, escolhe um início estável entre 0 e 4 e avança de cinco em cinco dentro da hora. H/5 3,21 * * 1-5 aplica esse padrão nos dias úteis durante as horas 3 e 21. Não significa uma única execução dentro de cinco minutos.

Como agendar releases na integração contínua com Jenkins?

O cron agenda o job, mas os estágios dele precisam definir como a release será feita. Configure Build periodically ou use o bloco triggers numa Pipeline declarativa. A configuração precisa ser carregada pelo Jenkins; a expressão, sozinha, não implementa nem executa uma release.

Jenkins aceita vários fusos horários?

Uma configuração completa de gatilho Core pode conter uma linha TZ= com um ID reconhecido pelo Java. Sem ela, vale o fuso do controlador. Este gerador recebe apenas uma expressão e não calcula horários pelo fuso do navegador.

Qual é a diferença entre Poll SCM e Build periodically?

Poll SCM consulta o repositório e solicita uma compilação quando detecta mudanças. Build periodically não depende de mudanças no código. Escolha pollSCM ao gerar o bloco de consulta e confirme no Jenkins o comportamento do repositório configurado.

Como executar no último dia de cada mês?

O Core não tem o seletor L para fim do mês. Uma execução diária com verificação da data no job ou um plugin adequado são soluções separadas. @monthly escolhe, por padrão, um dia de 1 a 28 e não representa o último dia.

Encontrou uma data inesperada?

Conferir a programação no controlador

Use o cron Jenkins para revisar as condições dos campos e copiar o fragmento adequado para sua configuração. Consulte a prévia do job antes de depender de um horário exato.

Sintaxe válida não garante que uma compilação comece ou termine com sucesso.