Tutorial: Usar umaAWS Step FunctionsAção de invocação do em pipeline - AWS CodePipeline

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

Tutorial: Usar umaAWS Step FunctionsAção de invocação do em 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. Também é possível fazer upload do arquivo de entrada da 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: Crie ou escolha 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 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 oAWS Identity and Access ManagementConsole do (IAM), localize a função e, em seguida, adicione as permissões à política da função. Para obter mais informações, consulte Adicionar permissões à função de serviço CodePipeline.

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

No console do Step Functions, crie uma máquina de estado usando oHelloWorldModelo de exemplo. Para obter instruções, consulteCriar uma máquina de estadonoAWS Step FunctionsGuia do desenvolvedor.

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

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

  1. Faça login noAWS Management Consolee abra o console do CodePipeline emhttp://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 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 no CodePipeline para descrever artefatos de entrada para ações.

    Neste exemplo, insira o seguinte JSON:

    {"IsHelloWorldExample": true}
    
            Captura de tela do console mostrando detalhes da adição de uma ação de invocação do Step Functions.
  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).

    
            Captura de tela do console mostrando o pipeline concluído com êxito com o ID de execução do pipeline.
  18. No pipeline concluído, escolha AWS 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