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 (tipo V2)
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](action-reference-Commands.md).
**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](tutorials-github-gitclone.md) 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**
1. Crie um arquivo com o seguinte texto:
```
Sample readme file
```
1. 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
```
1. 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
```
1. Execute o seguinte comando para confirmar os arquivos com uma mensagem de confirmação.
```
git commit -m "Added source files"
```
1. 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 Console de gerenciamento da AWS e abra o CodePipeline console em [http://console.aws.amazon. com/codesuite/codepipeline/home](https://console.aws.amazon.com/codesuite/codepipeline/home).
1. Na página **Welcome (Bem-vindo)**, **Getting started (Conceitos básicos)** ou **Pipelines**, selecione **Create pipeline (Criar pipeline)**.
1. 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**.
1. Em **Etapa 2: Escolher as configurações do pipeline**, em **Nome do pipeline**, insira **MyCommandsPipeline**.
1. 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](https://docs.aws.amazon.com/codepipeline/latest/userguide/pipeline-types-planning.html?icmpid=docs_acp_help_panel). Para obter informações sobre preços de CodePipeline, consulte [Preços](https://aws.amazon.com/codepipeline/pricing/).
1. 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](action-reference-Commands.md#action-reference-Commands-policy).
registros: CreateLogGroup
registros: CreateLogStream
registros: PutLogEvents
1. Deixe as configurações em **Advanced settings (Configurações avançadas)** como padrão e escolha **Next (Próximo)**.
1. Na página **Etapa 3: Adicionar etapa de origem**, adicione uma etapa de origem:
1. Em **Provedor de origem**, escolha **GitHub (via GitHub aplicativo)**.
1. 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, consulte[GitHub conexões](connections-github.md).
1. Em **Nome do repositório**, escolha o nome do seu GitHub repositório.com.
1. 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. 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](pipelines-triggers.md).
Escolha **Próximo**.
1. 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**.
![\[A página Etapa 4: Adicionar etapa de compilação de um novo pipeline com a ação Comandos.\]](http://docs.aws.amazon.com/pt_br/codepipeline/latest/userguide/images/commands-wizard-screen.png)
1. Em **Etapa 5: Adicionar etapa de teste**, escolha **Ignorar etapa de teste** e aceite a mensagem de aviso escolhendo **Ignorar** novamente.
Escolha **Próximo**.
1. Na página **Etapa 6: Adicionar etapa de implantação**, escolha **Ignorar etapa de implantação** e aceite a mensagem de aviso escolhendo **Ignorar** novamente.
Escolha **Próximo**.
1. Na **Etapa 7: Revisar**, revise as informações e escolha **Criar funil**.
1. 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\]](http://docs.aws.amazon.com/pt_br/codepipeline/latest/userguide/images/commands-output-edit-var.png)
## 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.
1. 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\]](http://docs.aws.amazon.com/pt_br/codepipeline/latest/userguide/images/commands-output-variable.png)
1. 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\]](http://docs.aws.amazon.com/pt_br/codepipeline/latest/userguide/images/commands-output-logs.png)