Desenvolvendo fluxos de trabalho no Step Functions Workflow Studio - AWS Step Functions

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á.

Desenvolvendo fluxos de trabalho no Step Functions Workflow Studio

Usando o Workflow Studio for AWS Step Functions, você pode drag-and-drop inserir estados em uma tela para criar visualmente seus fluxos de trabalho. Você pode adicionar e editar estados visualmente, configurar filtros de entrada e saída, transformar os resultados e configurar o tratamento de erros.

À medida que você modifica os estados em seu fluxo de trabalho, o Workflow Studio validará e gerará automaticamente a definição da máquina de estado. Você pode revisar o código gerado, editar a configuração e até mesmo modificar a definição do texto com o editor de código integrado. Ao terminar, você pode salvar seu fluxo de trabalho, executá-lo e examinar os resultados.

Você pode acessar o Workflow Studio pelo console Step Functions ao criar ou editar um fluxo de trabalho.

Você também pode usar o Workflow Studio de dentroAWS Application Composer, um designer visual para criar infraestrutura como código com AWS Serverless Application Model AWS CloudFormation e. Para descobrir os benefícios dessa abordagem, consulteUsar o Workflow Studio no Application Composer.

nota

O Workflow Studio não é compatível com o Internet Explorer 11, então você deve escolher outro navegador.

O Workflow Studio tem três modos: Design, Código e Configuração. No modo Design, você pode drag-and-drop inserir estados na tela. O modo de código fornece um editor de código integrado para editar suas definições de fluxo de trabalho no console. No modo Config, você pode gerenciar a configuração do fluxo de trabalho.

Modo de design

O modo de design fornece uma interface gráfica para visualizar seus fluxos de trabalho à medida que você cria seus protótipos. A imagem a seguir mostra o navegador de estados, a tela do fluxo de trabalho, o inspetor e os painéis de ajuda contextual no modo Design do Workflow Studio.

Captura de tela do modo Design, mostrando o navegador de estados, a tela do fluxo de trabalho, o inspetor e os painéis de ajuda.
  1. Os botões de modo alternam entre os três modos. Você não pode alternar entre os modos se a definição do ASL fluxo de trabalho for inválida.

  2. O Navegador de estados contém as três guias seguintes:

    • A guia Ações fornece uma lista do AWS APIs que você pode arrastar e soltar no gráfico do fluxo de trabalho na tela. Cada ação representa um estado Estado do fluxo de trabalho da tarefa.

    • A guia Fluxo fornece uma lista de estados de fluxo que você pode arrastar e soltar no gráfico do fluxo de trabalho na tela.

    • A guia Padrões fornece vários ready-to-use blocos de construção reutilizáveis que você pode usar em diversos casos de uso. Por exemplo, você pode usar esses padrões para processar dados de forma iterativa em um bucket do Amazon S3.

  3. O Gráfico de tela e fluxo de trabalho é onde você arrasta e solta estados no gráfico do fluxo de trabalho, altera a ordem dos estados e seleciona estados para configurar ou visualizar.

  4. O painel Painel do Inspector é onde você pode visualizar e editar as propriedades de qualquer ação selecionada na tela. Ative o botão Definição para visualizar o código do Amazon States Language para o fluxo de trabalho, com o estado atualmente selecionado destacado.

  5. Os links de Informações abrem um painel com informações contextuais quando você precisa de ajuda. Esses painéis também incluem links para tópicos relacionados na documentação do Step Functions.

  6. Barra de ferramentas de design — contém um conjunto de botões para realizar ações comuns, como desfazer, excluir e ampliar.

  7. Botões utilitários — Um conjunto de botões para realizar tarefas, como salvar seus fluxos de trabalho ou exportar suas ASL definições em um arquivo JSON ouYAML.

Navegador de estados

No navegador de estados, você pode selecionar estados para arrastar e soltar na tela do fluxo de trabalho. A guia Ações fornece uma lista de estados de tarefas que se conectam a HTTP endpoints de terceiros e. AWS APIs A guia Fluxo fornece uma lista de estados com os quais você pode direcionar e controlar seu fluxo de trabalho. Os estados de fluxo incluem: Escolha, Paralelo, Mapa, Aprovação, Espera, Sucesso e Falha. A guia Padrões fornece blocos ready-to-use de construção predefinidos reutilizáveis. Você pode pesquisar entre todos os tipos de estados com a caixa de pesquisa na parte superior do painel.

Coleção ilustrativa de capturas de tela mostrando ações, fluxo, padrões e pesquisa.

Gráfico de tela e fluxo de trabalho

Depois de escolher um estado para adicionar ao seu fluxo de trabalho, você pode arrastá-lo para a tela e soltá-lo no gráfico do fluxo de trabalho. Você também pode arrastar e soltar estados para movê-los dentro do seu fluxo de trabalho. Se seu fluxo de trabalho for grande, você pode ampliar ou reduzir para visualizar diferentes partes do gráfico do fluxo de trabalho na tela.

Painel do Inspector

Você pode configurar qualquer estado que você adicione ao seu fluxo de trabalho a partir do painel Inspector à direita. Escolha o estado que deseja configurar e você verá opções de configuração no painel Inspector. Para ver a ASLdefinição gerada automaticamente para o código do seu fluxo de trabalho, ative a opção Definição. A ASL definição associada ao estado que você selecionou aparecerá destacada.

Captura de tela ilustrativa do inspetor do Workflow Studio mostrando o painel de configuração
Captura de tela ilustrativa do painel do inspetor do Workflow Studio mostrando a definição do código

Modo de código

No modo Código do Workflow Studio, você pode usar um editor de código integrado para visualizar, escrever e editar a definição Usando a Amazon States Language para definir fluxos de trabalho do Step Functions (ASL) dos seus fluxos de trabalho no console Step Functions. A captura de tela a seguir mostra os componentes no modo Código.

Captura de tela ilustrativa da edição de uma definição de fluxo de trabalho no modo Código.
  1. Os botões de modo alternam entre os três modos. Você não pode alternar entre os modos se a definição do ASL fluxo de trabalho for inválida.

  2. Editor de códigoÉ aqui que você escreve e edita a ASLdefinição dos seus fluxos de trabalho no Workflow Studio. O editor de código também fornece recursos, como destaque de sintaxe e preenchimento automático.

  3. Visualização de grafos — Mostra uma visualização gráfica em tempo real do fluxo de trabalho.

  4. Botões utilitários — Um conjunto de botões para realizar tarefas, como salvar seus fluxos de trabalho ou exportar suas ASL definições em um arquivo JSON ouYAML.

  5. Barra de ferramentas de código — Contém um conjunto de botões para realizar ações comuns, como desfazer uma ação ou formatar o código.

  6. Barra de ferramentas do gráfico — Contém um conjunto de botões para realizar ações comuns, como ampliar e reduzir o gráfico do fluxo de trabalho.

Editor de código

O editor de código fornece uma experiência IDE semelhante à de escrever e editar suas definições de fluxo de trabalho usando JSON o Workflow Studio. O editor de código inclui vários recursos, como destaque de sintaxe, sugestões de preenchimento automático, validação de ASLdefinições e exibição de ajuda contextual. Conforme você atualiza a definição do fluxo de trabalho, a Visualização de grafos renderiza um gráfico em tempo real do fluxo de trabalho. Você também pode ver o gráfico de fluxo de trabalho atualizado no Modo de design.

Se você selecionar um estado no painel Modo de design ou no painel de visualização do gráfico, a ASL definição desse estado aparecerá destacada no editor de código. A ASL definição do seu fluxo de trabalho é atualizada automaticamente se você reordenar, excluir ou adicionar um estado no modo Design ou no painel de visualização gráfica.

O editor de código pode fazer sugestões para preencher automaticamente campos e estados.

  • Para ver uma lista de campos que você pode incluir em um estado específico, pressione Ctrl+Space.

  • Para gerar um trecho de código para um novo estado em seu fluxo de trabalho, pressione Ctrl+Space após a definição do estado atual.

  • Para exibir uma lista de todos os comandos e atalhos de teclado disponíveis, pressioneF1.

Visualização de grafos

O painel de visualização gráfica mostra seu fluxo de trabalho em formato gráfico. Quando você escreve as definições de fluxo de trabalho no Editor de código do Workflow Studio, o painel de visualização gráfica renderiza um gráfico em tempo real do fluxo de trabalho.

Conforme você reordena, exclui ou duplica um estado no painel de visualização gráfica, a definição do fluxo de trabalho no editor de código é atualizada automaticamente. Da mesma forma, à medida que você atualiza as definições de fluxo de trabalho, reordena, exclui ou adiciona um estado no editor de código, a visualização é atualizada automaticamente.

Se a JSON ASL definição do seu fluxo de trabalho for inválida, o painel de visualização gráfica pausará a renderização e exibirá uma mensagem de status na parte inferior do painel.

Modo de configuração

No modo Config do Workflow Studio, você pode gerenciar a configuração geral de suas máquinas de estado. Nesse modo, você pode especificar configurações, como as seguintes:

  • Detalhes: defina o nome e o tipo do fluxo de trabalho. Observe que ambos não podem ser alterados após a criação da máquina de estado.

  • Permissões: você pode criar uma nova função (recomendada), escolher uma função existente ou inserir uma ARN para uma função específica. Se você selecionar a opção para criar uma nova função, o Step Functions cria uma função de execução para suas máquinas de estado usando o mínimo de privilégios. As IAM funções geradas são válidas para Região da AWS as quais você cria a máquina de estado. Antes da criação, você pode revisar as permissões que o Step Functions gerará automaticamente para sua máquina de estado.

  • Registro: você pode ativar e definir um nível de registro para sua máquina de estado. O Step Functions registra os eventos do histórico de execução com base na seleção. Opcionalmente, você pode usar uma chave gerenciada pelo cliente para criptografar seus registros. Para mais informações sobre níveis de log, consulte Níveis de log para eventos de execução do Step Functions.

Em Configuração adicional, você pode definir uma ou mais das seguintes opções de configuração opcionais:

  • Ativar rastreamento X-Ray: você pode enviar rastreamentos X-Ray para execuções de máquinas de estado, mesmo quando um ID de rastreamento não é passado por um serviço upstream. Para obter mais informações, consulte O Trace Step Functions solicita dados em AWS X-Ray.

  • Publicar versão na criação: uma versão é um snapshot numerado e imutável de uma máquina de estado que você pode executar. Escolha essa opção para publicar uma versão da sua máquina de estado ao criar a máquina de estado. O Step Functions publica a versão 1 como a primeira revisão da máquina de estado. Para obter mais informações sobre versões, consulte Versões da máquina de estado nos fluxos de trabalho do Step Functions.

  • Criptografe com chave gerenciada pelo cliente: você pode fornecer uma chave que você gerencia diretamente para criptografar seus dados. Para obter mais informações, consulte Criptografia de dados em repouso

  • Tags: escolha essa caixa para adicionar tags que podem ajudá-lo a rastrear e gerenciar os custos associados aos seus recursos e fornecer melhor segurança em suas IAM políticas. Para obter mais informações sobre tags, consulte Marcando máquinas de estado e atividades em Step Functions.