aws:branch – Executa etapas de automação condicionais

A ação aws:branch permite que você crie uma automação dinâmica que avalia diferentes opções em uma única etapa e, em seguida, salta para outra etapa no runbook, com base nos resultados da avaliação.

Quando você especifica a ação aws:branch para uma etapa, você especifica as Choices que a automação deve avaliar. As Choices podem ser baseadas no valor especificado na seção Parameters do runbook ou em um valor dinâmico gerado como saída da etapa anterior. A automação avalia cada opção usando uma expressão booleana. Se a primeira opção for verdadeira, a automação pulará para a etapa designada para essa opção. Se a primeira opção for falsa, a automação avaliará a próxima opção. A automação continua a avaliar cada opção até processar uma opção verdadeira. A automação pula para a etapa designada para a opção true (verdadeira).

Se nenhuma das opções for verdadeira, a automação verificará se a etapa contém um valor default. Um valor padrão define uma etapa para a qual a automação deve saltar se nenhuma das opções for verdadeira. Se nenhum valor default for especificado para a etapa, a automação processará a próxima etapa no runbook.

A ação aws:branch oferece suporte a avaliações de opções complexas usando uma combinação de operadores And, Not e Or. Para obter mais informações sobre como usar o aws:branch, incluindo runbooks de exemplo e exemplos que usam operadores diferentes, consulte Uso de instruções condicionais em runbooks.

Entrada

Especifique uma ou mais Choices em uma etapa. As Choices podem ser baseadas no valor especificado na seção Parameters do runbook ou em um valor dinâmico gerado como saída da etapa anterior. Aqui está um exemplo de YAML que avalia um parâmetro.

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

Aqui está um exemplo de YAML que avalia a saída de uma etapa anterior.

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