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á.
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:
-
Um GitHub repositório. Você pode usar o GitHub repositório em Tutorial: use o clone completo com uma fonte de GitHub pipeline que você criou.
Etapa 1: criar arquivos de origem e enviar para 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
-
Crie um arquivo com o seguinte texto:
Sample readme file -
Salve o arquivo como
README.txt.
Para enviar arquivos para o seu GitHub repositório
-
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 -
Para usar a linha de comando Git a partir de um repositório clonado no computador local:
-
Execute o seguinte comando para organizar todos os seus arquivos de uma só vez:
git add -A -
Execute o seguinte comando para confirmar os arquivos com uma mensagem de confirmação.
git commit -m "Added source files" -
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
Faça login no AWS Management Console e abra o CodePipeline console em http://console.aws.amazon. com/codesuite/codepipeline/home
. -
Na página Welcome (Bem-vindo), Getting started (Conceitos básicos) ou Pipelines, selecione Create pipeline (Criar pipeline).
-
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.
-
Em Etapa 2: Escolher as configurações do pipeline, em Nome do pipeline, insira
MyCommandsPipeline. -
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
. -
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
-
-
Deixe as configurações em Advanced settings (Configurações avançadas) como padrão e escolha Next (Próximo).
-
Na página Etapa 3: Adicionar etapa de origem, adicione uma etapa de origem:
-
Em Provedor de origem, escolha GitHub (via GitHub aplicativo).
-
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.
-
Em Nome do repositório, escolha o nome do seu GitHub repositório.com.
-
Em Ramificação padrão, selecione a ramificação que você deseja especificar quando o pipeline é iniciado manualmente ou com um evento de origem que não seja uma tag do Git. Se a origem da alteração não for o gatilho ou se a execução de um pipeline tiver sido iniciada manualmente, a alteração usada será a confirmação HEAD da ramificação padrão. Opcionalmente, você também pode especificar webhooks com filtragem (acionadores). Para obter mais informações, consulte Automatizar a inicialização de pipelines usando gatilhos e filtragem.
Escolha Próximo.
-
-
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.
-
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.
-
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.
-
Na Etapa 7: Revisar, revise as informações e escolha Criar funil.
-
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
computeno campo Namespace de variável.Adicione a variável CodeBuild
AWS_Default_Regionde saída e escolha Adicionar variável.
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
-
Após a execução bem-sucedida do pipeline, você poderá visualizar os logs e a saída da ação.
-
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.
-
Para visualizar os logs da ação, escolha Visualizar detalhes na ação Commands bem-sucedida. Visualize os logs da ação Commands.
