Iterar um loop com uma função do Lambda no Step Functions

Faça login no console do Lambda e escolha Criar função.

Na página Create function, selecione Author from scratch.

Na seção Informações básicas, configure a função do Lambda da seguinte maneira:

1. Em Function name (Nome da função), insira Iterator.

2. Em Runtime (Tempo de execução), selecione Node.js.

3. Em Alterar a função de execução padrão, escolha Create a new role with basic Lambda permissions (Criar uma função com permissões básicas do Lambda).

4. Escolha a opção Criar função.

Copie o código a seguir da função do Lambda na Origem do código.

export const handler = function (event, context, callback) {
  let index = event.iterator.index
  let step = event.iterator.step
  let count = event.iterator.count
 
  index = index + step
 
  callback(null, {
    index,
    step,
    count,
    continue: index < count
  })
}

Esse código aceita os valores de entrada count, index e step. Ele incrementa o index pelo valor da step e retorna esses valores e o booliano continue. O valor de continue é true se index for inferior a count.

Escolha Implantar.

Escolha Testar.

Na caixa de diálogo Configurar evento de teste, insira TestIterator na caixa Nome do evento.

Substitua os dados de exemplo pelo seguinte:

{
  "Comment": "Test my Iterator function",
  "iterator": {
    "count": 10,
    "index": 5,
    "step": 1
  }
}

Esses valores imitam o que pode ser proveniente de sua máquina de estado durante uma iteração. A função do Lambda incrementará o índice e exibirá true para continue quando o índice for menor que count. Para este teste, o índice já foi incrementado para 5. O teste vai incrementar index para 6 e definir continue como true.

Escolha Criar.

Escolha Testar para testar a função do Lambda.

Os resultados do teste são exibidos na guia Resultados da execução.

Escolha a guia Resultados da execução para ver a saída.

{
  "index": 6,
  "step": 1,
  "count": 10,
  "continue": true
}

Abra o console do Step Functions e escolha Create a state machine (Criar uma máquina de estado).

Selecione o modelo Em branco.

No painel Código, cole o JSON a seguir que define a máquina de estado.

Para obter mais informações sobre a Amazon States Language, consulte Estrutura da máquina de estado.

{
    "Comment": "Iterator State Machine Example",
    "StartAt": "ConfigureCount",
    "States": {
        
        "ConfigureCount": {
            "Type": "Pass",
            "Result": {
                "count": 10,
                "index": 0,
                "step": 1
            },
            "ResultPath": "$.iterator",
            "Next": "Iterator"
        },
        "Iterator": {
            "Type": "Task",
            "Resource": "arn:aws:lambda:region:123456789012:function:Iterate",
            "ResultPath": "$.iterator",
            "Next": "IsCountReached"
        },
        "IsCountReached": {
            "Type": "Choice",
            "Choices": [
                {
                    "Variable": "$.iterator.continue",
                    "BooleanEquals": true,
                    "Next": "ExampleWork"
                }
            ],
            "Default": "Done"
        },
        "ExampleWork": {
            "Comment": "Your application logic, to run a specific number of times",
            "Type": "Pass",
            "Result": {
              "success": true
            },
            "ResultPath": "$.result",
            "Next": "Iterator"
        },
        "Done": {
            "Type": "Pass",
            "End": true
          
        }
    }
}

Substitua o campo Iterator Resource pelo ARN real da função do Lambda Iterator criada anteriormente.

Selecione Configuração e insira um nome para a máquina de estado, como IterateCount.

Em Tipo, aceite o valor padrão de Padrão. Em Permissões, escolha Criar perfil.

Escolha Criar e confirme as criações de perfil escolhendo Confirmar.

Na página IterateCount, escolha Iniciar execução.

(Opcional) Insira um nome de execução personalizado para substituir o padrão gerado.

Escolha Start Execution.

Uma nova execução de sua máquina de estado inicia-se mostrando sua execução em andamento.

A execução é incrementada em etapas, fazendo o acompanhamento da contagem com a função do Lambda. Em cada iteração, ela executa o exemplo mencionado no estado ExampleWork em sua máquina de estado.

Quando a contagem atingir o número especificado no estado ConfigureCount em sua máquina de estado, a execução fechará a iteração e será encerrada.