Use expressões cron no EC2 Image Builder

Use expressões cron para o EC2 Image Builder para configurar uma janela de tempo para atualizar sua imagem com atualizações que se aplicam à imagem base e aos componentes do seu pipeline. A janela de tempo para a atualização do pipeline começa com a hora definida na expressão cron. Você pode definir a hora em sua expressão cron até o minuto. A construção do seu pipeline pode ser executada durante ou após o horário de início.

Às vezes, pode levar alguns segundos ou até um minuto para que sua compilação comece a ser executada.

nota

As expressões Cron usam o fuso horário do Tempo Coordenado Universal (UTC) por padrão, ou você pode especificar o fuso horário. Para obter mais informações sobre o horário UTC e encontrar a diferença do seu fuso horário, consulte Time Zone Abbreviations, Worldwide List (Abreviações de fuso horário: lista mundial).

Valores compatíveis com expressões cron no Image Builder

O EC2 Image Builder usa um formato cron que consiste em seis campos obrigatórios. Cada um é separado dos outros por um espaço intermediário, sem espaços à esquerda ou à direita:

<Minute> <Hour> <Day> <Month> <Day of the week> <Year>

A tabela a seguir mostra os valores compatíveis com as entradas cron necessárias.

Valores compatíveis com expressões cron
Campo	Valores	Curingas
Minuto	0-59	, - * /
Hora	0-23	, - * /
Dia	1-31	, - * ? / L W
Mês	1-12 ou jan-dec	, - * /
Dia da semana	1-7 ou sun-sat	, - * ? L #
Ano	1970-2199	, - * /

Curingas

A tabela a seguir descreve como o Image Builder usa curingas para expressões cron. Lembre-se de que pode levar até um minuto após o horário especificado para que a compilação seja iniciada.

Curingas compatíveis com expressões cron
Curinga	Descrição
,	A , (vírgula) curinga inclui valores adicionais. No campo mês, jan,feb,mar inclui janeiro, fevereiro e março.
-	O - (traço) curinga especifica intervalos. Em dia do campo mês, 1-15 inclui dias 1 a 15 do mês especificado.
*	O * (asterisco) curinga inclui todos os valores válidos para o campo.
?	O curinga ? (interrogação) especifica que o valor do campo depende de outra configuração. No caso dos ay-of-week campos Dia e D, quando um é especificado ou inclui todos os valores possíveis (*), o outro deve ser ? a. Não é possível especificar ambos. Por exemplo, se você inserir a 7 no campo Dia (executar a construção no sétimo dia do mês), a ay-of-week posição D deverá conter ? a.
/	A / (barra) curinga especifica incrementos. Por exemplo, se você quiser que sua compilação seja executada a cada dois dias, insira */2 o campo dia.
L	O curinga L em qualquer um dos campos do dia especifica o último dia: 28 a 31 para o dia do mês, dependendo do mês, ou domingo, para o dia da semana.
W	O curinga W no ay-of-month campo D especifica um dia da semana. No ay-of-month campo D, se você inserir um número antes doW, isso significa que você deseja segmentar o dia da semana mais próximo desse dia. Por exemplo, se você especificar3W, deseja que sua compilação seja executada no dia da semana mais próximo ao terceiro dia do mês.
#	O # (hash) é permitido somente para o campo do dia da semana e deve ser seguido por um número entre 1 e 5. O número especifica quais semanas em um determinado mês se aplicam à execução da compilação. Por exemplo, se você quiser que sua compilação seja executada na segunda sexta-feira de cada mês, use fri#2 para o campo dia da semana.

Restrições

• Você não pode especificar os ay-of-week campos D ay-of-month e D na mesma expressão cron. Se você especificar um valor ou * em um dos campos, deverá usar um ? (ponto de interrogação) no outro.

• Não há suporte para expressões Cron que causam taxas mais rápidas que um minuto.

Exemplos de expressões cron no EC2 Image Builder

As expressões Cron são inseridas de forma diferente no console do Image Builder e na API ou na CLI. Para ver exemplos, escolha a guia que se aplica a você.

Image Builder console

Os exemplos a seguir mostram expressões cron que você pode inserir no console para sua agenda de compilação. O horário UTC é especificado usando um relógio de 24 horas.

Executada diariamente às 10h (UTC)

0 10 * * ? *

Corra diariamente às 12h15 (UTC)

15 12 * * ? *

Executar diariamente à meia-noite (UTC)

0 0 * * ? *

Executada às 10h (UTC) todas as manhãs dos dias da semana

0 10 ? * 2-6 *

Executada às 18h (UTC) todas as noites da semana

0 18 ? * mon-fri *

Executar às 8h (UTC) todo o primeiro dia do mês

0 8 1 * ? *

Execute na segunda terça-feira de cada mês às 22h30 (UTC)

30 22 ? * tue#2 *

dica

Se você não quiser que seu trabalho de pipeline se estenda até o dia seguinte enquanto estiver em execução, lembre-se de levar em consideração o tempo de sua compilação ao especificar o horário de início.

API/CLI

Os exemplos a seguir mostram expressões cron que você pode inserir usando comandos CLI ou solicitações de API para sua agenda de compilação. Somente a expressão cron é mostrada.

Executada diariamente às 10h (UTC)

cron(0 10 * * ? *)

Corra diariamente às 12h15 (UTC)

cron(15 12 * * ? *)

Executar diariamente à meia-noite (UTC)

cron(0 0 * * ? *)

Executada às 10h (UTC) todas as manhãs dos dias da semana

cron(0 10 ? * 2-6 *)

Executada às 18h (UTC) todas as noites da semana

cron(0 18 ? * mon-fri *)

Executar às 8h (UTC) todo o primeiro dia do mês

cron(0 8 1 * ? *)

Execute na segunda terça-feira de cada mês às 22h30 (UTC)

cron(30 22 ? * tue#2 *)

dica

Se você não quiser que seu trabalho de pipeline se estenda até o dia seguinte enquanto estiver em execução, lembre-se de levar em consideração o tempo de sua compilação ao especificar o horário de início.

Expressões de classificação no EC2 Image Builder

Uma expressão rate começa quando você cria a regra de evento programado e, em seguida, e a executa em sua programação definida.

As expressões rate tem dois campos obrigatórios. Os campos são separados por um espaço em branco.

Sintaxe

rate(value unit)

valor

Um número positivo.

unidade

A unidade de tempo. Diferentes unidades são necessárias para valores de 1, como minute, e valores acima de 1, como minutes.

Valores válidos: minuto | minutos | hora | horas | dia | dias

Restrições

Se o valor for igual a 1, a unidade deverá ser singular. Da mesma forma, para valores maiores do que 1, a unidade deve ser plural. Por exemplo, rate(1 hours) e rate(5 hour) não são válidos, mas rate(1 hour) e rate(5 hours) são.