Exemplo 1: Criar um pipeline do AWS CodeCommit com o AWS CloudFormation
Este passo a passo mostra como usar o console do AWS CloudFormation para criar uma infraestrutura que inclui um pipeline conectado a um repositório de origem do CodeCommit. Neste tutorial, você utiliza o arquivo de modelo de exemplo para criar sua pilha de recursos, que inclui o armazenamento de artefatos, o pipeline e os recursos de detecção de alterações, como a regra do Amazon CloudWatch Events. Depois de criar sua pilha de recursos no AWS CloudFormation, você pode visualizar seu pipeline no console do AWS CodePipeline. O pipeline é composto por dois estágios, com um estágio de origem do CodeCommit e um estágio de implantação do CodeDeploy.
Pré-requisitos:
Você deve ter criado os seguintes recursos para uso com o modelo do AWS CloudFormation de exemplo:
-
Você deve ter criado um repositório de origem. Você pode usar o repositório do AWS CodeCommit que você criou em Tutorial: Criar um pipeline simples (repositório do CodeCommit).
-
Você deve ter criado um grupo de implantação e um aplicativo do CodeDeploy. Você pode usar os recursos do CodeDeploy criados em Tutorial: Criar um pipeline simples (repositório do CodeCommit).
-
Escolha um desses links para fazer download do arquivo de exemplo do modelo do AWS CloudFormation para criar um pipeline: YAML | JSON
Descompacte o arquivo e coloque-o em seu computador local.
-
Baixe o arquivo do aplicativo de exemplo SampleApp_Linux.zip.
Criar o pipeline no AWS CloudFormation
-
Descompacte os arquivos do SampleApp_Linux.zip e faça upload deles no repositório do AWS CodeCommit. Você deve carregar os arquivos descompactados no diretório raiz do seu repositório. Você pode seguir as instruções em Etapa 2: Adicionar um código de exemplo ao repositório do CodeCommit para enviar os arquivos para o repositório.
-
Abra o console do AWS CloudFormation e selecione Create Stack (Criar pilha). Escolha With new resources (standard) (Com novos recursos [padrão]).
-
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.
-
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:
-
Em ApplicationName, insira o nome de seu aplicativo do CodeDeploy.
-
Em BetaFleet, insira o nome do seu grupo de implantação existente do CodeDeploy.
-
Em BranchName, informe a ramificação do repositório que você deseja usar.
-
Em RepositoryName, insira o nome do seu repositório de origem do CodeCommit.
-
-
Escolha Próximo. Aceite os padrões na página a seguir e selecione Next (Próximo).
-
Em Capacidades, selecione Reconheço que o AWS CloudFormation pode criar recursos do IAM e escolha Criar pilha.
-
Após a conclusão da criação da pilha, visualize a lista de eventos para verificar se há erros.
Solução de problemas do
O usuário do IAM que está criando o pipeline no AWS CloudFormation pode exigir permissões adicionais a fim de criar recursos para o pipeline. As seguintes permissões são necessárias na política para permitir que o AWS CloudFormation crie os recursos necessários do Amazon CloudWatch Events para o pipeline do CodeCommit:
{ "Effect": "Allow", "Action": [ "events:PutRule", "events:PutEvents", "events:PutTargets", "events:DeleteRule", "events:RemoveTargets", "events:DescribeRule" ], "Resource": "resource_ARN" } -
Faça login no Console de gerenciamento da AWS e abra o console do CodePipeline em https://console.aws.amazon.com/codesuite/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. No CodePipeline, você pode visualizar o pipeline com o mesmo ID físico (nome do pipeline) na região em que criou sua pilha.
-
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.