Tutorial: use uma ação de AWS Step Functions invocação em um pipeline

Você pode usar AWS Step Functions para criar e configurar máquinas de estado. Este tutorial mostra como adicionar uma ação de invocação a um pipeline que ativa execuções de máquina de estado do pipeline.

Neste tutorial, você executará as seguintes tarefas:

• Crie uma máquina de estado padrão em AWS Step Functions.

• Insira o JSON de entrada da máquina de estado diretamente. Você também pode fazer upload do arquivo de entrada de máquina de estado para um bucket do Amazon Simple Storage Service (Amazon S3).

• Atualize o pipeline adicionando a ação da máquina de estado.

Pré-requisito: criar ou escolher um pipeline simples

Neste tutorial, você adicionará uma ação de invocação a um pipeline existente. É possível usar o pipeline criado em Tutorial: Criar um pipeline simples (bucket do S3) ou em Tutorial: criar um pipeline simples (CodeCommitrepositório).

Use um pipeline existente com uma ação de origem e pelo menos uma estrutura de duas etapas, mas não use artefatos de origem para este exemplo.

nota

Talvez seja necessário atualizar a função de serviço usada pelo pipeline com permissões adicionais necessárias para executar essa ação. Para fazer isso, abra o console AWS Identity and Access Management (IAM), encontre a função e adicione as permissões à política da função. Para ter mais informações, consulte Adicionar permissões à função de serviço do CodePipeline.

Etapa 1: Criar a máquina de estado de exemplo

No console do Step Functions, crie uma máquina de estado usando o modelo de exemplo HelloWorld. Para obter instruções, consulte Criar uma máquina de estado no Guia do desenvolvedor do AWS Step Functions .

Etapa 2: Adicionar uma ação de invocação do Step Functions ao pipeline

Adicione uma ação de invocação do Step Functions ao pipeline da seguinte maneira:

1. Faça login no AWS Management Console e abra o CodePipeline console em http://console.aws.amazon.com/codesuite/codepipeline/home.

   Os nomes de todos os pipelines associados à sua AWS conta são exibidos.

2. Em Nome, selecione o nome do pipeline que você deseja editar. Isso abrirá um visão detalhada do pipeline, incluindo o estado de cada uma das ações em cada estágio do pipeline.

3. Na página de detalhes do pipeline, selecione Editar.

4. Na segunda etapa do pipeline simples, escolha Editar etapa. Escolha Excluir. Isso exclui a segunda etapa agora que você não precisa mais dela.

5. Na parte inferior do diagrama, escolha + Add stage (+ Adicionar estágio).

6. Em Nome da etapa, insira um nome para a etapa, como Invoke, e escolha Adicionar etapa.

7. Escolha + Add action group (Adicionar grupo de ação).

8. Em Nome da ação, insira um nome, como Invoke.

9. Em Provedor de ação, selecione AWS Step Functions. Permita que Region (Região) seja definida para a região do pipeline.

10. Em Artefatos de entrada, selecione SourceArtifact.

11. No ARN da máquina de estado, escolha o Nome de recurso da Amazon (ARN) para a máquina de estado criada anteriormente.

12. (Opcional) Em Prefixo de nome de execução, insira um prefixo a ser adicionado ao ID de execução da máquina de estado.

13. Em Tipo de entrada, escolha Literal.

14. Em Entrada, insira o JSON de entrada que é esperado pela máquina de estado de exemplo HelloWorld.

    nota

    A entrada para a execução da máquina de estado é diferente do termo usado CodePipeline para descrever artefatos de entrada para ações.

    Neste exemplo, insira o seguinte JSON:

    {"IsHelloWorldExample": true}

15. Selecione Done (Concluído).

16. Na etapa que está sendo editada, escolha Concluído. No painel do AWS CodePipeline , escolha Save (Salvar) e selecione Save (Salvar) na mensagem de aviso.

17. Para enviar as alterações e iniciar uma execução de pipeline, selecione Release change (Liberar alteração) e Release (Liberar).

18. No pipeline concluído, escolha AWS Step Functions na ação de invocação. No AWS Step Functions console, visualize seu ID de execução da máquina de estado. O ID mostra o nome da máquina de estado HelloWorld e o ID de execução da máquina de estado com o prefixo my-prefix.

    arn:aws:states:us-west-2:account-ID:execution:HelloWorld:my-prefix-0d9a0900-3609-4ebc-925e-83d9618fcca1