Tutorial: criar um pipeline que executa comandos com computação - 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: criar um pipeline que executa comandos com computação

Neste tutorial, você vai configurar um pipeline que realiza a execução contínua de comandos de compilação fornecidos usando a ação Commands em um estágio de compilação. Para ter mais informações sobre a ação Commands, consulte Referência da ação Commands.

Importante

Como parte da criação de um pipeline, um bucket de artefatos S3 fornecido pelo cliente será usado CodePipeline por for artefacts. (Este bucket não é o mesmo utilizado para uma ação de origem do S3.) Se o bucket de artefatos do S3 estiver em uma conta diferente da conta do seu pipeline, certifique-se de que o bucket de artefatos do S3 Contas da AWS seja de propriedade de quem é seguro e confiável.

Pré-requisitos

Você já deve ter o seguinte:

Etapa 1: criar arquivos de origem e enviar para o seu GitHub repositório

Nesta seção, você cria e envia seus arquivos de origem de exemplo para o repositório que o pipeline usa para seu estágio de origem. Neste exemplo, você produz e envia o seguinte:

  • Um arquivo README.txt.

Como criar arquivos de origem
  1. Crie um arquivo com o seguinte texto:

    Sample readme file
  2. Salve o arquivo como README.txt.

Para enviar arquivos para o seu GitHub repositório
  1. Enviar ou carregar os arquivos ao repositório do . Esses arquivos são o artefato de origem gerado pelo assistente Create Pipeline (Criar pipeline) para a ação de implantação no AWS CodePipeline. Os arquivos devem ter a seguinte aparência em seu diretório local:

    README.txt
  2. Para usar a linha de comando Git a partir de um repositório clonado no computador local:

    1. Execute o seguinte comando para organizar todos os seus arquivos de uma só vez:

      git add -A
    2. Execute o seguinte comando para confirmar os arquivos com uma mensagem de confirmação.

      git commit -m "Added source files"
    3. Execute o seguinte comando para enviar os arquivos de seu repositório local para seu repositório do :

      git push

Etapa 2: Criar o pipeline

Nesta seção, você criará um pipeline com as seguintes ações:

  • Um estágio de origem com uma ação GitHub (via GitHub aplicativo) para o repositório em que os arquivos de origem são armazenados.

  • Um estágio de compilação com a ação Commands.

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

  2. Na página Welcome (Bem-vindo), Getting started (Conceitos básicos) ou Pipelines, selecione Create pipeline (Criar pipeline).

  3. Na página Etapa 1: Escolher opção de criação, em Opções de criação, selecione a opção Criar pipeline personalizado. Escolha Próximo.

  4. Em Etapa 2: Escolher as configurações do pipeline, em Nome do pipeline, insira MyCommandsPipeline.

  5. CodePipeline fornece tubulações do tipo V1 e V2, que diferem em características e preço. O tipo V2 é o único tipo que você pode escolher no console. Para ter mais informações, consulte Pipeline types. Para obter informações sobre preços de CodePipeline, consulte Preços.

  6. Em Função de serviço, escolha Nova função de serviço para permitir CodePipeline a criação de uma função de serviço no IAM.

    nota

    Caso utilize um perfil de serviço já existente, será preciso incluir as permissões a seguir ao perfil de serviço para habilitar o uso da ação Commands. Restrinja as permissões ao nível de recurso do pipeline aplicando permissões baseadas em recurso na declaração de política do perfil de serviço. Para ter mais informações, consulte o exemplo de política em Permissões de política de perfil de serviço.

    • troncos: CreateLogGroup

    • troncos: CreateLogStream

    • troncos: PutLogEvents

  7. Deixe as configurações em Advanced settings (Configurações avançadas) como padrão e escolha Next (Próximo).

  8. Na página Etapa 3: Adicionar etapa de origem, adicione uma etapa de origem:

    1. Em Provedor de origem, escolha GitHub (via GitHub aplicativo).

    2. Em Conexão, escolha uma conexão existente ou crie uma nova. Para criar ou gerenciar uma conexão para sua ação GitHub de origem, consulteGitHub conexões.

    3. Em Nome do repositório, escolha o nome do seu GitHub repositório.com. Especifique uma ramificação para o padrão ou você pode especificar gatilhos. Para obter mais informações, consulte Automatizar a inicialização de pipelines usando gatilhos e filtragem.

    Escolha Próximo.

  9. Em Etapa 4: adicionar estágio de compilação, escolha Comandos.

    nota

    A execução da ação Commands acarretará cobranças separadas em AWS CodeBuild.

    Insira os comandos a seguir:

    ls echo hello world cat README.txt echo pipeline Execution Id is #{codepipeline.PipelineExecutionId}

    Escolha Próximo.

    Etapa 4: Adicionar página de estágio de construção para um novo pipeline com a ação Comandos
  10. Na Etapa 5: Adicionar estágio de teste, escolha Ignorar estágio de teste e, em seguida, aceite a mensagem de aviso escolhendo Ignorar novamente.

    Escolha Próximo.

  11. Na Etapa 6: Adicionar estágio de implantação, escolha Ignorar estágio de implantação e, em seguida, aceite a mensagem de aviso escolhendo Ignorar novamente.

    Escolha Próximo.

  12. Na Etapa 7: Revisar, revise as informações e escolha Criar funil.

  13. Como etapa final para criar a ação, adicione uma variável de ambiente à ação que resultará em uma variável de saída para a ação. Na ação Commands, selecione Editar. Na tela Editar, especifique um namespace de variável para sua ação inserindo compute no campo Namespace de variável.

    Adicione a variável CodeBuild AWS_Default_Region de saída e escolha Adicionar variável.

    A página Editar para a ação Commands

Etapa 3: executar o pipeline e verificar os comandos de compilação

Implemente uma alteração para iniciar a execução do pipeline. Verifique se os comandos de compilação foram executados visualizando o histórico de execução, os logs de compilação e as variáveis ​​de saída.

Como visualizar logs de ação e variáveis ​​de saída
  1. Após a execução bem-sucedida do pipeline, você poderá visualizar os logs e a saída da ação.

  2. Para visualizar as variáveis de saída da ação, escolha Histórico > Linha do tempo.

    Visualize a variável de saída que foi adicionada à ação. A saída da ação Commands exibe a variável de saída resolvida para a região da ação.

    A saída da ação Commands exibindo a variável de saída resolvida para a ação Região
  3. Para visualizar os logs da ação, escolha Visualizar detalhes na ação Commands bem-sucedida. Visualize os logs da ação Commands.

    Logs de exemplo para a ação Commands