Utiliser des expressions cron dans EC2 Image Builder - EC2 Image Builder

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Utiliser des expressions cron dans EC2 Image Builder

Utilisez des expressions cron pour EC2 Image Builder afin de configurer une fenêtre temporelle afin d'actualiser votre image avec des mises à jour qui s'appliquent à l'image de base et aux composants de votre pipeline. La fenêtre temporelle pour l'actualisation de votre pipeline commence à l'heure que vous avez définie dans l'expression cron. Vous pouvez définir l'heure dans votre expression cron à la minute près. La construction de votre pipeline peut s'exécuter à l'heure de début ou après.

L'exécution de votre build peut parfois prendre quelques secondes, voire une minute.

Note

Les expressions Cron utilisent le fuseau horaire UTC (Universal Coordinated Time) par défaut, ou vous pouvez spécifier le fuseau horaire. Pour plus d'informations sur l'heure UTC et pour connaître le décalage correspondant à votre fuseau horaire, consultez la section Abréviations des fuseaux horaires — Liste mondiale.

Valeurs prises en charge pour les expressions cron dans Image Builder

EC2 Image Builder utilise un format cron composé de six champs obligatoires. Chacune est séparée des autres par un espace entre les deux, sans espaces de début ou de fin :

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

Le tableau suivant montre les valeurs prises en charge pour les entrées cron obligatoires.

Valeurs prises en charge pour les expressions cron
Champ Valeurs Caractères génériques
Minute 0-59 , - * /
Heure 0-23 , - * /
jour 1-31 , - * ? / L W
Mois 1-12 ou jan-dec , - * /
Jour de la semaine 1-7 ou sun-sat , - * ? L #
Année 1970-2199 , - * /
Caractères génériques

Le tableau suivant décrit comment Image Builder utilise des caractères génériques pour les expressions cron. N'oubliez pas que le démarrage de la compilation peut prendre jusqu'à une minute après l'heure spécifiée.

Caractères génériques pris en charge pour les expressions cron
Caractère générique Description
, Le caractère générique , (virgule) inclut des valeurs supplémentaires. Dans le champ Mois, jan,feb,mar inclut janvier, février et mars.
- Le caractère générique - (tiret) spécifie des plages. Dans le champ Jour du mois, 1-15 inclut les jours 1 à 15 du mois spécifié.
* Le caractère générique * (astérisque) inclut toutes les valeurs valides du champ.
? Le caractère générique ? (point d'interrogation) indique que la valeur du champ dépend d'un autre paramètre. Dans le cas des ay-of-week champs Day et D, lorsque l'un est spécifié ou inclut toutes les valeurs possibles (*), l'autre doit être ? a. Vous ne pouvez pas spécifier les deux. Par exemple, si vous saisissez un 7 dans le champ Jour (lancez le build le septième jour du mois), la ay-of-week position D doit contenir un?.
/ Le caractère générique / (barre oblique) spécifie les incréments. Par exemple, si vous souhaitez que votre build soit exécuté tous les deux jours, entrez */2 dans le champ jour.
L Le caractère générique L dans l'un ou l'autre des champs du jour indique le dernier jour : du 28 au 31 pour le jour du mois, selon le mois, ou le dimanche, pour le jour de la semaine.
W Le caractère générique W dans le ay-of-month champ D indique un jour de semaine. Dans le ay-of-month champ D, si vous entrez un nombre avant leW, cela signifie que vous souhaitez cibler le jour de la semaine le plus proche de ce jour. Par exemple, si vous le spécifiez3W, vous souhaitez que votre build soit exécuté le jour de la semaine le plus proche du troisième jour du mois.
# Le # (hachage) n'est autorisé que pour le champ du jour de la semaine et doit être suivi d'un nombre compris entre 1 et 5. Le numéro indique les semaines d'un mois donné qui s'appliquent à l'exécution de la version. Par exemple, si vous souhaitez que votre build soit exécuté le deuxième vendredi de chaque mois, utilisez fri#2 le champ du jour de la semaine.
Restrictions
  • Vous ne pouvez pas spécifier les ay-of-week champs D ay-of-month et D dans la même expression cron. Si vous spécifiez une valeur ou * dans l'un de ces champs, vous devez utiliser un ? dans l'autre.

  • Les expressions cron qui entraînent des fréquences d'une rapidité supérieure à une minute ne sont pas prises en charge.

Exemples d'expressions cron dans EC2 Image Builder

Les expressions Cron sont saisies différemment pour la console Image Builder et pour l'API ou la CLI. Pour voir des exemples, choisissez l'onglet qui s'applique à vous.

Image Builder console

Les exemples suivants montrent les expressions cron que vous pouvez saisir dans la console pour votre calendrier de génération. L'heure UTC est spécifiée à l'aide d'une horloge de 24 heures.

Fonctionne tous les jours à 10 h 00 (UTC)

0 10 * * ? *

Fonctionne tous les jours à 12 h 15 (UTC)

15 12 * * ? *

Fonctionne tous les jours à minuit (UTC)

0 0 * * ? *

Ouvert à 10 h 00 (UTC) tous les matins de la semaine

0 10 ? * 2-6 *

Ouvert à 18 h (UTC) tous les soirs de semaine

0 18 ? * mon-fri *

Ouvert à 8 h 00 (UTC) le premier jour de chaque mois

0 8 1 * ? *

Organisé le deuxième mardi de chaque mois à 22 h 30 (UTC)

30 22 ? * tue#2 *

Astuce

Si vous ne souhaitez pas que votre tâche de pipeline s'étende jusqu'au lendemain pendant son exécution, assurez-vous de prendre en compte le temps de construction lorsque vous spécifiez l'heure de début.

API/CLI

Les exemples suivants montrent les expressions cron que vous pouvez saisir pour votre calendrier de construction à l'aide de commandes CLI ou de requêtes d'API. Seule l'expression cron est affichée.

Fonctionne tous les jours à 10 h 00 (UTC)

cron(0 10 * * ? *)

Fonctionne tous les jours à 12 h 15 (UTC)

cron(15 12 * * ? *)

Fonctionne tous les jours à minuit (UTC)

cron(0 0 * * ? *)

Ouvert à 10 h 00 (UTC) tous les matins de la semaine

cron(0 10 ? * 2-6 *)

Ouvert à 18 h 00 (UTC) tous les soirs de semaine

cron(0 18 ? * mon-fri *)

Ouvert à 8 h 00 (UTC) le premier jour de chaque mois

cron(0 8 1 * ? *)

Organisé le deuxième mardi de chaque mois à 22 h 30 (UTC)

cron(30 22 ? * tue#2 *)

Astuce

Si vous ne souhaitez pas que votre tâche de pipeline s'étende jusqu'au lendemain pendant son exécution, assurez-vous de prendre en compte le temps de construction lorsque vous spécifiez l'heure de début.

Expressions de taux dans EC2 Image Builder

Une expression de fréquence démarre au moment où vous créez la règle d'événement planifié, puis s'exécute selon le calendrier défini.

Les expressions de fréquence comportent deux champs obligatoires. Ces champs sont séparés par un espace.

Syntaxe

rate(value unit)
value

Nombre positif.

unité

Unité de temps. Des unités différentes sont nécessaires pour les valeurs de 1 (par exemple minute) et les valeurs supérieures à 1, (par exemple, minutes).

Valeurs valides : minute | minutes | heure | heures | jour | jours

Restrictions

Si la valeur est égale à 1, l'unité doit être au singulier. De même, pour les valeurs supérieures à 1, l'unité doit être au pluriel. Par exemple, rate(1 hours) et rate(5 hour) ne sont pas valides, mais rate(1 hour) et rate(5 hours) sont valides.