aws:branch – exécuter les étapes d'automatisation conditionnelle

L'action aws:branch vous permet de créer une automatisation dynamique qui évalue plusieurs options en une seule étape, puis passe à une autre étape dans le runbook en fonction des résultats de cette évaluation.

Lorsque vous spécifiez l'action aws:branch pour une étape, vous définissez des Choices que l'automatisation doit évaluer. Les Choices peuvent se baser sur une valeur que vous avez spécifiée dans la section Parameters du runbook ou sur une valeur dynamique générée comme sortie à partir de l'étape précédente. L'automatisation évalue chaque choix à l'aide d'une expression booléenne. Si le premier choix est true, l'automatisation passe à l'étape désignée pour ce choix. Si le premier choix est false, l'automatisation évalue le choix suivant. L'automatisation continue d'évaluer chaque choix jusqu'à ce qu'il traite un choix défini sur true. L'automatisation accède ensuite à l'étape désignée correspondant au choix défini sur true.

Si aucun des choix n'est true, l'automatisation vérifie si l'étape contient une valeur default. La valeur par défaut définit une étape à laquelle l'automatisation doit passer si aucun des choix n'est défini sur true. Si aucune valeur default n'est spécifiée pour l'étape, l'automatisation traite l'étape suivante du runbook.

L'action aws:branch prend en charge les évaluations de choix complexes à l'aide d'une combinaison d'opérateurs And, Not et Or. Pour de plus amples informations sur l'utilisation d'aws:branch, y compris des exemples de runbooks et des exemples utilisant différents opérateurs, veuillez consulter Utilisation d'instructions conditionnelles dans les runbooks.

Entrée

Spécifiez un ou plusieurs Choices dans une étape. Les Choices peuvent se baser sur une valeur que vous avez spécifiée dans la section Parameters du runbook ou sur une valeur dynamique générée comme sortie à partir de l'étape précédente. Voici un exemple de fichier YAML qui évalue un paramètre.

mainSteps:
- name: chooseOS
  action: aws:branch
  inputs:
    Choices:
    - NextStep: runWindowsCommand
      Variable: "{{Name of a parameter defined in the Parameters section. For example: OS_name}}"
      StringEquals: windows
    - NextStep: runLinuxCommand
      Variable: "{{Name of a parameter defined in the Parameters section. For example: OS_name}}"
      StringEquals: linux
    Default:
      sleep3

Voici un exemple de fichier YAML qui évalue la sortie d'une étape précédente.

mainSteps:
- name: chooseOS
  action: aws:branch
  inputs:
    Choices:
    - NextStep: runPowerShellCommand
      Variable: "{{Name of a response object. For example: GetInstance.platform}}"
      StringEquals: Windows
    - NextStep: runShellCommand
      Variable: "{{Name of a response object. For example: GetInstance.platform}}"
      StringEquals: Linux
    Default:
      sleep3