Use variáveis dinâmicas em seu documento de fluxo de trabalho

Você pode usar variáveis dinâmicas em seus documentos de fluxo de trabalho para representar valores que variam em runtime para seu processo de criação de imagem. A interpolação de strings para variáveis dinâmicas permite que você incorpore expressões JSONPath em conteúdo estruturado, como strings JSON. Isso é particularmente útil quando você precisa passar valores de tempo de execução em cargas complexas para etapas de ações como ou. ExecuteStateMachine WaitForAction

Para usar a interpolação de strings para variáveis dinâmicas, coloque as expressões JSONPath em colchetes duplos no conteúdo da string. "{{...}}" Somente expressões JSONPath entre chaves duplas são processadas como variáveis. Qualquer expressão JSONPath que não esteja entre colchetes duplos é tratada como conteúdo literal de string.

Sintaxe de variável de fluxo de trabalho dinâmico JSONPath

$.<document structure>.[<step name>.]<variable name>

Os valores das variáveis dinâmicas são representados como seletores JSONPath com nós estruturais que identificam a variável de destino de modo exclusivo. O primeiro nó após a raiz ($) se refere à estrutura do documento do fluxo de trabalho, como stepOutputs, ou no caso das variáveis de sistema do Image Builder, a imageBuilder. A lista a seguir contém os nós compatíveis de estrutura de documentos de fluxo de trabalho JSONPath.

Os nós da estrutura de documento parameters e stepOutputs incluem um nó opcional para o nome da etapa. Isso ajuda a garantir nomes exclusivos de variáveis em todas as etapas.

O nó final no JSONPath é o nome da variável de destino, como instanceId.

Cada etapa pode indicar a saída de qualquer ação da etapa anterior com essas variáveis dinâmicas JSONPath. Isso também é conhecido como encadeamento ou referência. Você pode usar a variável dinâmica a seguir para fazer referência à saída de uma ação da etapa anterior.

$.stepOutputs.step-name.output-name

Exemplo 1: indicador de encadeamento de parâmetros de entrada

O exemplo a seguir mostra um parâmetro de entrada que usa a interpolação de cadeias de caracteres para resolver uma variável dinâmica no valor do parâmetro em tempo de execução.

  - name: ApplyTestComponents
    action: ExecuteComponents
    onFailure: Abort
    inputs:
      instanceId.$: "$.stepOutputs.LaunchTestInstance.instanceId"

Exemplo 2: interpolação de cadeias de caracteres em variáveis dinâmicas

O exemplo a seguir demonstra como as variáveis dinâmicas usam a interpolação de cadeias de caracteres para determinar valores em tempo de execução.

- name: ValidateImageConfiguration
  action: ExecuteStateMachine
  inputs:
    stateMachineArn: arn:aws:states:us-east-1:111122223333:stateMachine:ImageValidation
    input: |
      {
        "imageId": "{{ $.stepOutputs.CreateImageFromInstance.imageId }}",
        "region": "us-east-1",
        "buildDate": "{{ $.imagebuilder.dateTime }}",
        "instanceType": "{{ $.stepOutputs.LaunchStep.instanceType }}"
      }

Neste exemplo, as expressões JSONPath agrupadas em chaves duplas são resolvidas em tempo de execução:

As sequências literais semelhantes "region": "us-east-1" permanecem inalteradas.

Usar variáveis de sistema do Image Builder

O Image Builder fornece as seguintes variáveis de sistema que você pode usar em seu documento de fluxo de trabalho. Esses são valores somente para leitura que o Image Builder preenche em tempo de execução. Você faz referência a uma variável do sistema com o nó da estrutura do imagebuilder documento, por exemplo$.imagebuilder.platform.