Trabalhar com o AWS Step Functions usando o AWS Toolkit

O AWS Toolkit oferece suporte para AWS Step Functions. O Step Functions permite criar máquinas de estado que definem fluxos de trabalho para funções do AWS Lambda e outros serviços da AWS que dão suporte a aplicações essenciais aos negócios.

Você pode usar o AWS Toolkit para fazer o seguinte com o Step Functions:

• Criar e publicar uma máquina de estado, que é um fluxo de trabalho composto de etapas individuais.

• Baixar um arquivo que define um fluxo de trabalho de máquina de estado.

• Executar um fluxo de trabalho de máquina de estado com a entrada que você inseriu ou selecionou.

Pré-requisitos

O Step Functions pode executar códigos e acessar recursos da AWS (p. ex., invocar uma função do Lambda). Para manter a segurança, você deve conceder acesso ao Step Functions para esses recursos usando uma função do IAM.

Com o AWS Toolkit é possível aproveitar as funções do IAM geradas automaticamente que são válidas para a região da AWS na qual você cria a máquina de estado. Para criar sua própria função do IAM para uma máquina de estado, consulte Como o AWS Step Functions funciona com o IAM no Guia do desenvolvedor da AWS Step Functions.

Criar e publicar uma máquina de estado

Ao criar uma máquina de estado com o AWS Toolkit, você escolhe um modelo inicial que define um fluxo de trabalho para um caso de negócios. Em seguida, você pode editar ou substituir esse modelo de acordo com as suas necessidades específicas. Para mais informações sobre como definir uma máquina de estado em um arquivo que represente sua estrutura, consulte Amazon States Language (Linguagem de estados da Amazon) no Guia do desenvolvedor do AWS Step Functions.

1. No painel AWS Explorer, abra o menu de contexto (clique com o botão direito do mouse) para Step Functions e, em seguida, selecione Create a new Step Function state machine (Criar uma nova máquina de estado Step Function).

2. No painel de comando, selecione um modelo inicial para o fluxo de trabalho da máquina de estado.

3. Em seguida, selecione um formato para o arquivo Amazon States Language (ASL) que define sua máquina de estado.

   Um editor exibe o arquivo ASL que define o fluxo de trabalho da máquina de estado.

   nota

   Para obter informações sobre como editar o arquivo ASL a fim de personalizar seu fluxo de trabalho, consulte Estrutura da máquina de estado.

4. No arquivo ASL, selecione Publish to Step Functions (Publicar no Step Functions) para adicionar sua máquina de estado à Nuvem AWS.

   nota

   Você também pode escolher Render graph (Renderizar gráfico) no arquivo ASL para exibir uma representação visual do fluxo de trabalho da máquina de estado.

   

5. No painel de comando, selecione uma região da AWS para hospedar sua step function.

6. Em seguida, você pode optar por criar uma nova step function ou atualizar uma já existente.

   Quick Create

   Essa opção permite que você crie uma nova step function com base no arquivo ASL usando step-functions/latest/dg/concepts-standard-vs-express.html. Você é solicitado a especificar o seguinte:

   • Uma função do IAM que permita que sua step function execute códigos e acesse recursos da AWS. (Você pode escolher uma função do IAM gerada automaticamente que seja válida para a região da AWS na qual você cria a máquina de estado.)

   • Um nome para sua nova função.

   Você pode conferir se sua máquina de estado foi criada com sucesso e obter seu ARN na guia de saída do AWS Toolkit.

   Quick Update

   Se já existir uma máquina de estado na região da AWS, você poderá escolher uma para atualizar com o arquivo ASL atual.

   Você pode conferir se sua máquina de estado foi atualizada com sucesso e obter seu ARN na guia de saída do AWS Toolkit.

   Após criar uma máquina de estado, ela aparece em Step Functions no painel AWS Explorer. Se não aparecer imediatamente, selecione o menu Toolkit, Refresh Explorer (Atualizar o Explorer).

Executar uma máquina de estado no AWS Toolkit

Você pode usar o AWS Toolkit para executar máquinas de estado remotas. A máquina de estado em execução recebe um texto JSON como entrada e transmite essa entrada para o primeiro estado no fluxo de trabalho. Os estados individuais recebem JSON como entrada e geralmente passam JSON como saída para o próximo estado. Para mais informações, consulte Input and Output Processing in Step Functions (Processamento de entrada e saída no Step Functions).

1. No painel AWS Explorer, selecione Step Functions. Em seguida, abra o menu de contexto (clique com o botão direito do mouse) de uma máquina de estado específica e selecione Start Execution (Iniciar execução).

2. No painel Start Execution (Iniciar execução), adicione a entrada formatada em JSON para o fluxo de trabalho da máquina de estado inserindo o texto diretamente no campo abaixo ou carregando um arquivo do seu dispositivo local.

3. Selecione Execute (Executar)

   A guia de saída do AWS Toolkit exibe uma confirmação de que o fluxo de trabalho foi iniciado e o ARN do ID do processo. Você pode usar esse ID do processo para conferir se o fluxo de trabalho foi executado com sucesso no console do AWS Step Functions. Também é possível ver a data e a hora de início e término do seu fluxo de trabalho.

Baixar um arquivo de definição de máquina de estado e visualizar seu fluxo de trabalho

Baixar uma máquina de estado significa baixar um arquivo contendo texto JSON que representa a estrutura dessa máquina de estado. Em seguida, é possível editar esse arquivo para criar uma nova máquina de estado ou atualizar uma já existente. Para mais informações, consulte Amazon States Language (Linguagem de estados da Amazon) no Guia do desenvolvedor da AWS Step Functions.

1. No painel AWS Explorer, selecione Step Functions. Em seguida, abra o menu de contexto (clique com o botão direito do mouse) de uma máquina de estado específica e selecione Download Definition (Baixar definição).

   nota

   O menu de contexto também oferece as opções de Copy Name (Copiar nome) e Copy ARN (Copiar ARN).

2. Na caixa de diálogo Save (Salvar), selecione a pasta no ambiente na qual você armazena o arquivo de máquina de estado baixado e, em seguida, selecione Save (Salvar).

   O arquivo formatado em JSON que define o fluxo de trabalho da máquina de estado é exibido em um editor.

3. Para exibir uma representação visual do fluxo de trabalho, selecione Render graph (Renderizar gráfico).

   Uma janela exibe um fluxograma, que mostra a sequência de estados no fluxo de trabalho da máquina de estado.