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: Crie um pipeline com AWS CloudFormation
Os exemplos fornecem exemplos de modelos que permitem que você crie um pipeline que implanta seu aplicativo em suas instâncias sempre que o código-fonte for alterado. AWS CloudFormation O modelo de exemplo cria um pipeline que pode ser visualizado no AWS CodePipeline. O pipeline detecta a chegada de uma alteração salva por meio do Amazon CloudWatch Events.
**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.
**Topics**
+ [Exemplo 1: Crie um AWS CodeCommit pipeline com AWS CloudFormation](tutorials-cloudformation-codecommit.md)
+ [Exemplo 2: Crie um pipeline do Amazon S3 com AWS CloudFormation](tutorials-cloudformation-s3.md)
# Exemplo 1: Crie um AWS CodeCommit pipeline com AWS CloudFormation
Este passo a passo mostra como usar o AWS CloudFormation console para criar uma infraestrutura que inclui um pipeline conectado a um repositório de CodeCommit origem. Neste tutorial, você usa o arquivo de modelo de amostra fornecido para criar sua pilha de recursos, que inclui seu armazenamento de artefatos, pipeline e recursos de detecção de alterações, como sua regra Amazon Events. CloudWatch Depois de criar sua pilha de recursos AWS CloudFormation, você pode ver seu pipeline no AWS CodePipeline console. O pipeline é um pipeline de dois estágios com um estágio de CodeCommit origem e um estágio de CodeDeploy implantação.
**Pré-requisitos:**
Você deve ter criado os seguintes recursos para usar com o modelo AWS CloudFormation de amostra:
+ Você deve ter criado um repositório de origem. Você pode usar o AWS CodeCommit repositório em [Tutorial: criar um pipeline simples (CodeCommit repositório)](tutorials-simple-codecommit.md) que você criou.
+ Você deve ter criado um CodeDeploy aplicativo e um grupo de implantação. Você pode usar os recursos do CodeDeploy que você criou em [Tutorial: criar um pipeline simples (CodeCommit repositório)](tutorials-simple-codecommit.md).
+ [Escolha um desses links para baixar o arquivo de AWS CloudFormation modelo de amostra para criar um pipeline: [YAML \$1 JSON](samples/codepipeline-codecommit-events-yaml.zip)](samples/codepipeline-codecommit-events-json.zip)
Descompacte o arquivo e coloque-o em seu computador local.
+ Baixe o [SampleApparquivo de amostra do aplicativo \$1Linux.zip](samples/SampleApp_Linux.zip).
**Crie seu funil em AWS CloudFormation**
1. Descompacte os arquivos do [SampleApp\$1Linux.zip](samples/SampleApp_Linux.zip) e faça o upload dos arquivos para o seu AWS CodeCommit repositório. Você deve carregar os arquivos descompactados no diretório raiz do seu repositório. Você pode seguir as instruções em [Etapa 2: adicionar código de amostra ao seu CodeCommit repositório](tutorials-simple-codecommit.md#codecommit-add-code) para enviar os arquivos para o repositório.
1. Abra o AWS CloudFormation console e escolha **Create Stack**. Escolha **With new resources (standard)** (Com novos recursos [padrão]).
1. Em **Especificar modelo**, escolha **Fazer upload de um modelo**. Selecione **Escolher arquivo** e escolha o arquivo de modelo no seu computador local. Escolha **Próximo**.
1. Em **Stack name (Nome da pilha)**, insira um nome para o pipeline. Os parâmetros especificados pelo modelo de exemplo são exibidos. Insira os seguintes parâmetros:
1. Em **ApplicationName**, insira o nome do seu CodeDeploy aplicativo.
1. Em **BetaFleet**, insira o nome do seu grupo CodeDeploy de implantação.
1. Em **BranchName**, insira a ramificação do repositório que você deseja usar.
1. Em **RepositoryName**, insira o nome do seu repositório CodeCommit de origem.
1. Escolha **Próximo**. Aceite os padrões na página a seguir e selecione **Next (Próximo)**.
1. Em **Capacidades**, selecione **Eu reconheço que AWS CloudFormation pode criar recursos do IAM** e, em seguida, escolha **Criar pilha**.
1. Após a conclusão da criação da pilha, visualize a lista de eventos para verificar se há erros.
**Solução de problemas**
O usuário do IAM que está criando o pipeline em AWS CloudFormation pode precisar de permissões adicionais para criar recursos para o pipeline. As seguintes permissões são necessárias na política para permitir AWS CloudFormation a criação dos recursos necessários da Amazon CloudWatch Events para o CodeCommit pipeline:
```
{
"Effect": "Allow",
"Action": [
"events:PutRule",
"events:PutEvents",
"events:PutTargets",
"events:DeleteRule",
"events:RemoveTargets",
"events:DescribeRule"
],
"Resource": "resource_ARN"
}
```
1. Faça login no Console de gerenciamento da AWS e abra o CodePipeline console em [https://console.aws.amazon.com/codepipeline/](https://console.aws.amazon.com/codepipeline/).
Em **Pipelines**, selecione o pipeline e clique em **View (Visualizar)**. O diagrama mostra os estágios de implantação e a origem do pipeline.
**nota**
Para visualizar o pipeline criado, localize a coluna **ID lógico** na guia **Recursos** da sua pilha no CloudFormation. Anote o nome na coluna **ID físico** do pipeline. Em CodePipeline, você pode visualizar o pipeline com a mesma ID física (nome do pipeline) na região em que criou sua pilha.
1. No seu repositório de origem, confirme e envie uma alteração. Seus recursos de detecção de alterações capturam a alteração, e o pipeline é iniciado.
# Exemplo 2: Crie um pipeline do Amazon S3 com AWS CloudFormation
Este passo a passo mostra como usar o AWS CloudFormation console para criar uma infraestrutura que inclui um pipeline conectado a um bucket de origem do Amazon S3. Neste tutorial, você usa o arquivo de modelo de amostra fornecido para criar sua pilha de recursos, que inclui seu bucket de origem, armazenamento de artefatos, pipeline e recursos de detecção de alterações, como a regra e a trilha do Amazon CloudWatch Events. CloudTrail Depois de criar sua pilha de recursos AWS CloudFormation, você pode ver seu pipeline no AWS CodePipeline console. O pipeline é um pipeline de dois estágios com um estágio de origem do Amazon S3 e CodeDeploy um estágio de implantação.
**Pré-requisitos:**
Você deve ter os seguintes recursos para usar com o modelo AWS CloudFormation de amostra:
+ Você deve ter criado as instâncias do Amazon EC2, onde instalou o CodeDeploy agente nas instâncias. Você deve ter criado um CodeDeploy aplicativo e um grupo de implantação. Use o Amazon EC2 e CodeDeploy os recursos que você criou. [Tutorial: criar um pipeline simples (CodeCommit repositório)](tutorials-simple-codecommit.md)
+ Escolha os links a seguir para baixar os arquivos de AWS CloudFormation modelo de amostra para criar um pipeline com uma fonte do Amazon S3:
+ Faça download do modelo de exemplo para o seu pipeline: [YAML](samples/codepipeline-s3-events-yaml.zip) \$1 [JSON](samples/codepipeline-s3-events-json.zip)
+ [Baixe o modelo de amostra para seu CloudTrail bucket e trilha: [YAML \$1 JSON](samples/codepipeline-s3-cloudtrail-yaml.zip)](samples/codepipeline-s3-cloudtrail-json.zip)
+ Descompacte os arquivos e coloque-os em seu computador local.
+ Baixe o aplicativo de amostra em [SampleApp\$1Linux.zip](samples/SampleApp_Linux.zip).
Salve o arquivo .zip em seu computador local. Você carregará o arquivo .zip após a criação da pilha.
**Crie seu funil em AWS CloudFormation**
1. Abra o AWS CloudFormation console e escolha **Create Stack**. Escolha **With new resources (standard)** (Com novos recursos [padrão]).
1. Em **Escolher um modelo**, escolha **Fazer upload de um modelo**. Selecione **Escolher arquivo** e escolha o arquivo de modelo no seu computador local. Escolha **Próximo**.
1. Em **Stack name (Nome da pilha)**, insira um nome para o pipeline. Os parâmetros especificados pelo modelo de exemplo são exibidos. Insira os seguintes parâmetros:
1. Em **ApplicationName**, insira o nome do seu CodeDeploy aplicativo. É possível substituir o nome padrão do `DemoApplication`.
1. Em **BetaFleet**, insira o nome do seu grupo CodeDeploy de implantação. É possível substituir o nome padrão do `DemoFleet`.
1. Entrar **SourceObjectKey**, entrar`SampleApp_Linux.zip`. Você carrega esse arquivo para o bucket depois que o modelo cria o bucket e o pipeline.
1. Escolha **Próximo**. Aceite os padrões na página a seguir e selecione **Next (Próximo)**.
1. Em **Capacidades**, selecione **Eu reconheço que AWS CloudFormation pode criar recursos do IAM** e, em seguida, escolha **Criar pilha**.
1. Após a conclusão da criação da pilha, visualize a lista de eventos para verificar se há erros.
**Solução de problemas**
O usuário do IAM que está criando o pipeline AWS CloudFormation pode precisar de permissões adicionais para criar recursos para o pipeline. As seguintes permissões são necessárias na política para permitir AWS CloudFormation a criação dos recursos necessários do Amazon CloudWatch Events para o pipeline do Amazon S3:
```
{
"Effect": "Allow",
"Action": [
"events:PutRule",
"events:PutEvents",
"events:PutTargets",
"events:DeleteRule",
"events:RemoveTargets",
"events:DescribeRule"
],
"Resource": "resource_ARN"
}
```
1. Em CloudFormation, na guia **Recursos** da sua pilha, visualize os recursos que foram criados para sua pilha.
**nota**
Para visualizar o pipeline criado, localize a coluna **ID lógico** na guia **Recursos** da sua pilha no CloudFormation. Anote o nome na coluna **ID físico** do pipeline. Em CodePipeline, você pode visualizar o pipeline com a mesma ID física (nome do pipeline) na região em que criou sua pilha.
Escolha o bucket do S3 com um rótulo `sourcebucket` no nome, como `s3-cfn-codepipeline-sourcebucket-y04EXAMPLE.`. Não escolha o bucket de artefato do pipeline.
O bucket de origem está vazio porque o recurso foi criado recentemente pelo CloudFormation. Abra o console do Amazon S3 e localize seu bucket do `sourcebucket`. Escolha **Upload (Fazer upload)** e siga as instruções para carregar seu arquivo.zip `SampleApp_Linux.zip`.
**nota**
Quando o Amazon S3 é o provedor de origem do pipeline, você deve fazer upload de todos os arquivos de origem compactados em seu bucket como um único arquivo .zip. Caso contrário, a ação da origem falhará.
1. Faça login no Console de gerenciamento da AWS e abra o CodePipeline console em [https://console.aws.amazon.com/codepipeline/](https://console.aws.amazon.com/codepipeline/).
Em **Pipelines**, selecione o pipeline e clique em **View (Visualizar)**. O diagrama mostra os estágios de implantação e a origem do pipeline.
1. Conclua as etapas dos procedimentos a seguir para criar seus recursos do AWS CloudTrail .
**Crie seus AWS CloudTrail recursos em AWS CloudFormation**
1. Abra o AWS CloudFormation console e escolha **Create Stack**.
1. Em **Choose a template (Selecionar um modelo)**, selecione **Upload a template to Amazon S3 (Carregar um modelo no Amazon S3)**. Escolha **Procurar e, em** seguida, selecione o arquivo de modelo para os AWS CloudTrail recursos do seu computador local. Escolha **Próximo**.
1. Em **Stack name (Nome da pilha)**, informe um nome para sua pilha de recursos. Os parâmetros especificados pelo modelo de exemplo são exibidos. Insira os seguintes parâmetros:
1. Em **SourceObjectKey**, aceite o padrão para o arquivo zip do aplicativo de amostra.
1. Escolha **Próximo**. Aceite os padrões na página a seguir e selecione **Next (Próximo)**.
1. Em **Capacidades**, selecione **Eu reconheço que AWS CloudFormation pode criar recursos do IAM** e, em seguida, escolha **Criar**.
1. Após a conclusão da criação da pilha, visualize a lista de eventos para verificar se há erros.
As seguintes permissões são necessárias na política para permitir AWS CloudFormation a criação dos CloudTrail recursos necessários para o pipeline do Amazon S3:
```
{
"Effect": "Allow",
"Action": [
"cloudtrail:CreateTrail",
"cloudtrail:DeleteTrail",
"cloudtrail:StartLogging",
"cloudtrail:StopLogging",
"cloudtrail:PutEventSelectors"
],
"Resource": "resource_ARN"
}
```
1. Faça login no Console de gerenciamento da AWS e abra o CodePipeline console em [https://console.aws.amazon.com/codepipeline/](https://console.aws.amazon.com/codepipeline/).
Em **Pipelines**, selecione o pipeline e clique em **View (Visualizar)**. O diagrama mostra os estágios de implantação e a origem do pipeline.
1. No seu bucket de origem, confirme e envie uma alteração. Seus recursos de detecção de alterações capturam a alteração e o pipeline é iniciado.