Trabalhando com AWS Step Functions - AWS Kit de ferramentas para VS Code
Visualizar máquinas de estado do Step FunctionsCriar uma máquina de estado do Step FunctionsComo criar uma máquina de estado Step Functions usando um modeloBaixar uma máquina de estado do Step FunctionsSalvar alterações em uma máquina de estado do Step FunctionsExecutar uma máquina de estado do Step FunctionsComo trabalhar com trechos de códigoValidação de código

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Trabalhando com AWS Step Functions

As seções a seguir descrevem como trabalhar com AWS Step Functions Amazon State Language (ASL) arquivos contendo definições de máquina de estado no AWS Toolkit. Para obter informações detalhadas sobre máquinas de AWS Step Functions estado, consulte o tópico Saiba mais sobre máquinas de estado em Step Functions no Guia do AWS Step Functionsdesenvolvedor.

Visualizar máquinas de estado do Step Functions

Para visualizar seus ASL arquivos existentes contendo definições de máquina de estado no AWS Toolkit Explorer, conclua as etapas a seguir.

  1. No AWS Toolkit Explorer, expanda a região que contém o ASL arquivo que você deseja visualizar.

  2. Expanda o título Step Functions.

  3. Seus ASL arquivos são exibidos no AWS Explorer.

Criar uma máquina de estado do Step Functions

No AWS Toolkit, você pode criar uma nova máquina de estado Step Functions a partir de um arquivo ou usar um modelo. O procedimento a seguir descreve como criar uma máquina de estado do Step Functions usando um arquivo. Para obter detalhes sobre como criar uma máquina de estado SFN a partir de um modelo, consulte a seção Modelos de máquina de estado localizada abaixo, neste tópico do Guia do usuário.

nota

Para trabalhar com Step Functions no VS Code, a extensão do seu arquivo Amazon State Language (ASL) que contém a definição da sua máquina de estado deve terminar com asl.json, asl.yml, ou .asl.yaml.

Por padrão, os arquivos Step Functions relevantes são abertos no Workflow Studio. Para obter informações detalhadas sobre como trabalhar no Workflow Studio por meio do AWS kit de ferramentas, consulte o tópico Trabalhando com o Workflow Studio neste Guia do usuário.

  1. No seu espaço de trabalho no VS Code, crie um novo arquivo.

  2. Nomeie seu arquivo e especifique a extensão do arquivo como asl.json, asl.yml, ou.asl.yaml.

  3. Após a criação, o AWS Toolkit abre o novo arquivo no AWS Step Functions Workflow Studio.

  4. No Workflow Studio, escolha o botão Salvar no menu do utilitário para salvar seu novo arquivo ASL.

Como criar uma máquina de estado Step Functions usando um modelo

No AWS Toolkit, você pode criar uma máquina de estado Step Functions a partir de um modelo. O processo de modelo cria um arquivo ASL que contém uma definição de máquina de estado, fornecendo um ponto de partida para seu projeto. O procedimento a seguir descreve como criar uma máquina de estado Step Functions a partir de um modelo no AWS Toolkit.

  1. No AWS Toolkit Explorer, expanda a região na qual você deseja criar uma máquina de estado Step Functions.

  2. Abra o menu de contexto para (clique com o botão direito do mouse) Step Functions e escolha Criar uma nova máquina de estado Step Functions para abrir o assistente Selecionar um modelo inicial (1/2) no VS Code.

  3. No assistente Selecionar um modelo inicial (1/2), escolha o tipo de modelo para sua máquina de estado Step Functions para continuar.

  4. Na tela Selecionar formato de modelo (2/2), escolha YAML ou JSON para seu formato de modelo.

  5. Um novo ASL arquivo contendo sua definição de máquina de estado é aberto no editor de código do VS Code.

Baixar uma máquina de estado do Step Functions

Para baixar uma máquina de estado do Step Functions armazenada remotamente na instância local do VS Code, conclua as etapas a seguir.

  1. No AWS Toolkit Explorer, expanda a região que contém a máquina de estado Step Functions que você deseja baixar.

  2. Expanda Step Functions, clique com o botão direito do mouse na máquina de estado Step Functions que você deseja baixar e escolha Baixar definição... .

  3. Especifique um local para armazenar sua máquina de estado Step Functions localmente para continuar.

  4. A máquina de estado do Step Functions é aberta no Workflow Studio quando o procedimento é concluído.

Salvar alterações em uma máquina de estado do Step Functions

O procedimento a seguir descreve como salvar as alterações feitas na máquina de estado do Step Functions.

nota

As edições feitas no Workflow Studio são sincronizadas com seu arquivo local, mas permanecem sem serem salvas até que seu trabalho seja salvo no editor de código do VS Code ou no Workflow Studio. Se o arquivo local for modificado e salvo enquanto o Workflow Studio estiver aberto e não houver erros detectados no arquivo ASL, você receberá uma notificação de sucesso no Workflow Studio quando o salvamento for concluído. No entanto, se o arquivo local contiver dados inválidos JSON ou YAML você tentar salvá-lo, o arquivo local falhará ao sincronizar e você receberá uma notificação de aviso no Workflow Studio.

  1. Em um arquivo ASL aberto contendo uma definição de máquina de estado no Workflow Studio, navegue até os botões do Utilitário.

  2. Clique no botão Salvar.

  3. O VS Code notifica você quando o arquivo foi salvo.

Executar uma máquina de estado do Step Functions

O procedimento a seguir descreve como executar uma máquina de estado Step Functions no AWS Toolkit.

  1. No AWS Toolkit Explorer, expanda a região que contém a máquina de estado Step Functions que você deseja executar.

  2. Expanda o Step Functions e clique com o botão direito do mouse na máquina de estado do Step Functions que deseja executar.

  3. No menu contextual, escolha Iniciar execução para iniciar o processo de lançamento.

  4. O status do lançamento é exibido na janela Saída do AWS Toolkit no VS Code.

Como trabalhar com trechos de código

Os trechos de código são sugestões automatizadas que são geradas com base no código em que você está trabalhando. Para trabalhar com trechos de código com o Step Functions no kit de ferramentas, conclua as etapas a seguir.

nota

Para trabalhar com trechos de código do Step Functions no VS Code, a extensão do seu ASL arquivo que contém a definição da sua máquina de estado deve terminar com .asl.json, .asl.yml, ou .asl.yaml.

Por padrão, seus arquivos Step Functions relevantes são abertos no Workflow Studio.

  1. No VS Code, abra um arquivo ASL contendo a definição da máquina de estado que você deseja modificar ou crie um novo arquivo ASL.

  2. No Workflow Studio, alterne para o modo Código se você estiver no modo Design.

  3. No editor de código do Workflow Studio, coloque o cursor na "States" propriedade.

  4. Pressione control + space para abrir o menu de trechos de código, propriedades adicionais podem ser acessadas pressionando control + space e são baseadas no "State" "Type".

  5. Selecione o trecho de código desejado na lista.

Validação de código

À medida que você trabalha no Step Functions no Workflow Studio, a validação de código identifica ativamente os erros e faz sugestões para o seguinte:

  • Propriedades ausentes

  • Valores incorretos

  • Estado não terminal

  • Estados inexistentes que forem indicados