Tutorial: Usar uma ação de chamada do AWS Step Functions em um pipeline

É possível usar o 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 no AWS Step Functions.

• Insira o JSON de entrada da máquina de estado diretamente. Faça upload do arquivo para um bucket do Amazon Simple Storage Service (Amazon S3)

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

nota

Esse recurso não está disponível nas regiões Ásia-Pacífico (Hong Kong) e Europa (Milão). Para fazer referência a outras ações disponíveis, consulteIntegrações de produtos e serviços com CodePipeline.

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 (repositório do CodeCommit).

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 do (), localize a função e, depois, adicione as permissões à política da função. Para obter 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 , crie uma máquina de estado usando o modelo de exemplo . Para obter instruções, consulte Criar uma máquina de estado no .

Etapa 2: Adicionar uma ação de chamada do ao pipeline

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

1. Faça login no console em AWS Management Consolehttp://console.aws.amazon.com/codesuite/codepipeline/home.

   Os nomes de todos os pipelines associados à sua conta da AWS 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 Delete (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, escolha AWSAWS 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 em para descrever artefatos de entrada para ações.

    Neste exemplo, insira o seguinte JSON:

    {"IsHelloWorldExample": true}

15. Escolha 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 AWSAWS Step Functions na ação de invocação. No console do AWS Step Functions, visualize o 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