Tutorial: Criar um pipeline que usa variáveis de ações de implantação do AWS CloudFormation

1. Navegue até o modelo de amostra da região. Por exemplo, use a tabela em https://docs.aws.amazon.com/documentdb/latest/developerguide/quick_start_cfn.html#quick_start_cfn-launch_stack para escolher a região e baixar o modelo. Baixe o modelo de um cluster do Amazon DocumentDB. O nome do arquivo é documentdb_full_stack.yaml.

2. Descompacte o arquivo documentdb_full_stack.yaml e abra-o em um editor de texto. Faça as alterações a seguir.

   1. Para este exemplo, adicione o parâmetro Purpose: a seguir à seção Parameters no modelo.

        Purpose:
          Type: String
          Default: testing
          AllowedValues:
            - testing
            - production
          Description: The purpose of this instance.

   2. Para este exemplo, adicione a saída StackName a seguir à seção Outputs: no modelo.

        StackName:
          Value: !Ref AWS::StackName

3. Faça upload do arquivo de modelo para o repositório do AWS CodeCommit. É necessário fazer upload do arquivo de modelo descompactado e editado para o diretório raiz do repositório.

   Para usar o console do CodeCommit para fazer upload dos arquivos:

   1. Abra o console do CodeCommit e selecione o repositório na lista Repositórios.

   2. Selecione Add file (Adicionar arquivo) e clique em Upload file (Carregar arquivo).

   3. Selecione Choose file (Escolher arquivo) e procure o arquivo. Informe seu nome de usuário e endereço de e-mail para confirmar a alteração. Escolha Commit changes (Confirmar alterações).

   Seu arquivo deve ser parecido com isto no nível raiz do repositório:

   documentdb_full_stack.yaml

Criar um pipeline com o assistente

1. Faça login no Console de gerenciamento da AWS e abra o console do CodePipeline 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 MyCFNDeployPipeline.

5. O CodePipeline disponibiliza pipelines dos tipos V1 e V2, que apresentam características e custos diferentes. 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 do CodePipeline, consulte Preços.

6. Em Perfil de serviço, faça um dos seguintes procedimentos:

   • Selecione Novo perfil de serviço para permitir que o CodePipeline crie um perfil de serviço no IAM.

   • Escolha Existing service role (Função de serviço existente). Em Role name (Nome da função), selecione a função de serviço na lista.

7. Em Artifact store (Armazenamento de artefatos):

   1. Selecione Local padrão para usar o armazenamento de artefatos padrão, como o bucket de artefatos do Amazon S3 designado como padrão, para o pipeline na região selecionada para o pipeline.

   2. Selecione Local personalizado se você já tiver um armazenamento de artefatos, como um bucket de artefatos do Amazon S3 na mesma região do pipeline.

   nota

   Este não é o bucket de origem para seu código-fonte. Este é o armazenamento de artefatos para o pipeline. Um armazenamento de artefatos separado, como um bucket do S3, é necessário para cada pipeline. Ao criar ou editar um pipeline, é necessário ter um bucket de artefatos na região do pipeline e um bucket de artefatos por região da AWS na qual você está executando uma ação.

   Para obter mais informações, consulte Artefatos de entrada e saída e CodePipeline referência de estrutura de tubulação.

   Escolha Próximo.

8. Em Etapa 3: Adicionar um estágio de origem:

   1. Em Source provider (Provedor de código-fonte), selecione AWS CodeCommit.

   2. Em Nome do repositório, escolha o nome do repositório do CodeCommit criado em Etapa 1: criar um CodeCommit repositório.

   3. Em Nome do ramo, selecione o nome do ramo que contém a última atualização do código.

   Assim que selecionar o nome do repositório e a ramificação, a regra do Amazon CloudWatch Events a ser criada para esse pipeline será exibida.

   Escolha Próximo.

9. Em Etapa 4: Adicionar etapa de compilação, escolha Ignorar etapa de compilação e aceite a mensagem de aviso escolhendo Ignorar novamente.

   Escolha Próximo.

10. Em Etapa 5: Adicionar etapa de teste, escolha Ignorar etapa de teste e aceite a mensagem de aviso escolhendo Ignorar novamente.

    Escolha Próximo.

11. Em Etapa 6: Adicionar etapa de implantação:

    1. Em Nome da ação, escolha Implantar. Em Provedor da implantação, escolha CloudFormation.

    2. No Modo de ação, escolha Criar ou atualizar uma pilha.

    3. Em Nome da pilha, insira um nome para a pilha. Esse é o nome da pilha que será criada pelo modelo.

    4. Em Nome do arquivo de saída, insira um nome para o arquivo de saída, como outputs. Esse é o nome do arquivo que será criado pela ação após a criação da pilha.

    5. Expanda Advanced. Em Substituições de parâmetros, insira suas substituições de modelo como pares de chave/valor. Por exemplo, este modelo requer as substituições a seguir.

       {
       "DBClusterName": "MyDBCluster",
       "DBInstanceName": "MyDBInstance",
       "MasterUser": "UserName",
       "MasterPassword": "Password",
       "DBInstanceClass": "db.r4.large",
       "Purpose": "testing"}

       Se você não inserir substituições, o modelo criará uma pilha com valores padrão.

    6. Escolha Próximo.

    7. Em Etapa 7: revisar, escolha Criar pipeline. Você deve ver um diagrama que mostra os estágios do pipeline. Deixe que o pipeline seja executado. O pipeline de dois estágios está completo e pronto para os estágios adicionais a serem incluídos.

1. 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.

2. Escolha editar o pipeline ou continue exibindo o pipeline no modo Editar.

3. Opte por editar o estágio de implantação.

4. Adicione uma ação de implantação que criará um conjunto de alterações para a pilha criada na ação anterior. Você deve adicionar essa ação após a ação existente no estágio.

   1. Em Nome da ação, insira Change_Set. Em Provedor de ação, selecione AWS CloudFormation .

   2. Em Artefato de entrada, escolha SourceArtifact.

   3. Em Action mode (Modo de ação), escolha Create or replace a change set (Criar ou substitui um conjunto de alterações).

   4. Em Nome da pilha, insira a sintaxe da variável como mostrado. Esse é o nome da pilha para a qual o conjunto de alterações foi criado, em que o namespace padrão DeployVariables é atribuído à ação.

      #{DeployVariables.StackName}

   5. Em Alterar nome do conjunto, insira o nome do conjunto de alterações.

      my-changeset

   6. Em Substituições de parâmetros, altere o parâmetro Purpose de testing para production.

      {
      "DBClusterName": "MyDBCluster",
      "DBInstanceName": "MyDBInstance",
      "MasterUser": "UserName",
      "MasterPassword": "Password",
      "DBInstanceClass": "db.r4.large",
      "Purpose": "production"}

   7. Escolha Concluído para salvar a ação.

1. Escolha editar o pipeline ou continue exibindo o pipeline no modo Editar.

2. Opte por editar o estágio de implantação.

3. Adicione uma ação de aprovação manual após a ação de implantação que cria o conjunto de alterações. Essa ação permite verificar o conjunto de alterações de recurso criado no CloudFormation antes que o pipeline execute o conjunto de alterações.

1. 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.

2. Escolha editar o pipeline ou continue exibindo o pipeline no modo Editar.

3. Opte por editar o estágio de implantação.

4. Adicione uma ação de implantação que executará o conjunto de alterações aprovado na ação manual anterior:

   1. Em Nome da ação, insira Execute_Change_Set. Em Provedor de ação, selecione AWS CloudFormation.

   2. Em Artefato de entrada, escolha SourceArtifact.

   3. Em Action mode (Modo de ação), escolha Execute a change set (Executar um conjunto de alterações).

   4. Em Nome da pilha, insira a sintaxe da variável como mostrado. Esse é o nome da pilha para a qual o conjunto de alterações é criado.

      #{DeployVariables.StackName}

   5. Em Nome do conjunto de alterações, insira o nome do conjunto de alterações criado na ação anterior.

      my-changeset

   6. Escolha Concluído para salvar a ação.

   7. Continue a execução do pipeline.

1. 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.

2. Escolha editar o pipeline.

3. Opte por editar o estágio de implantação.

4. Adicione uma ação de implantação que excluirá a pilha:

   1. Em Nome da ação, escolha DeleteStack. Em Provedor da implantação, escolha CloudFormation.

   2. Em Modo de ação, escolha Excluir uma pilha.

   3. Em Nome da pilha, insira a sintaxe da variável como mostrado. Esse é o nome da pilha que será excluída pela ação.

   4. Escolha Concluído para salvar a ação.

   5. Escolha Salvar para salvar o pipeline.

   O pipeline é executado quando ele é salvo.