Tutorial: Criar um pipeline que usa o AWS AppConfig como um provedor de implantação

Neste tutorial, você vai configurar um pipeline que fornece continuamente arquivos usando o AWS AppConfig como o provedor de ação de implantação no estágio de implantação.

Pré-requisitos

Antes de começar, é necessário concluir o seguinte:

• Este exemplo usa uma origem do S3 para o pipeline. Crie ou use um bucket do Amazon S3 com o versionamento habilitado. Você pode seguir as instruções em Etapa 1: Criar um bucket do S3 para o aplicativo para criar um bucket do S3.

Etapa 1: Criar os recursos do AWS AppConfig

Nesta seção, você vai criar os seguintes recursos:

• Aplicação no AWS AppConfig é uma unidade lógica de código que fornece recursos para os clientes.

• Um ambiente no AWS AppConfig é um grupo de implantação lógica de destinos do AppConfig, como aplicações em um ambiente beta ou de produção.

• Perfil de configuração é um conjunto de definições que influenciam o comportamento da aplicação. O perfil de configuração permite que o AWS AppConfig acesse a configuração no local armazenado.

• (Opcional) Uma estratégia de implantação no AWS AppConfig define o comportamento de uma implantação de configuração, como a porcentagem de clientes que devem receber a nova configuração implantada a qualquer momento durante a implantação.

Como criar uma aplicação, um ambiente, um perfil de configuração e uma estratégia de implantação

1. Faça login no AWS Management Console.

2. Use as etapas nos tópicos a seguir para criar os recursos no AWS AppConfig.

   • Crie uma aplicação.

   • Crie um ambiente.

   • Crie um perfil de configuração do AWS CodePipeline.

   • (Opcional) Selecione uma estratégia de implantação predefinida ou crie a própria.

Etapa 2: Fazer upload de arquivos para o bucket de origem do S3

Nesta seção, crie o arquivo ou os arquivos de configuração. Depois, compacte e envie os arquivos de origem para o bucket que o pipeline usa para o estágio de origem.

Como criar arquivos de configuração

1. Crie um arquivo configuration.json para cada configuração em cada região. Inclua o seguinte conteúdo:

   Hello World!

2. Use as etapas a seguir para compactar e fazer upload dos arquivos de configuração.

Como compactar e fazer upload de arquivos de origem

1. Crie um arquivo .zip com os arquivos e nomeie-o como configuration-files.zip. Por exemplo, o arquivo .zip pode usar a seguinte estrutura:

   .
   └── appconfig-configurations
       └── MyConfigurations
           ├── us-east-1
           │   └── configuration.json
           └── us-west-2
               └── configuration.json

2. No console do Amazon S3 para o bucket, selecione Carregar e siga as instruções para fazer upload do arquivo .zip.

Etapa 3: Criar o pipeline

Nesta seção, você criará um pipeline com as seguintes ações:

• Um estágio de origem com uma ação do Amazon S3 em que os artefatos de origem são os arquivos para a configuração.

• Um estágio de implantação com uma ação de implantação do AppConfig.

Criar um pipeline com o assistente

1. Faça login no AWS Management Console 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. Em Step 1: Choose pipeline settings (Etapa 1: selecionar as configurações do pipeline), em Pipeline name (Nome do pipeline), insira MyAppConfigPipeline.

4. Em Tipo de pipeline, selecione V1 para os fins deste tutorial. Também é possível selecionar V2; no entanto, observe que os tipos de pipeline diferem em características e preços. Para obter mais informações, consulte Tipos de Pipeline.

5. Em Perfil de serviço, selecione Novo perfil de serviço para permitir que o CodePipeline crie um perfil de serviço no IAM.

6. Deixe as configurações em Advanced settings (Configurações avançadas) como padrão e escolha Next (Próximo).

7. Em Step 2: Add source stage (Etapa 2: adicionar estágio de origem), em Source provider (Provedor de origem), escolha Amazon S3. Em Bucket, selecione o nome do bucket de origem do S3.

   Em Chave de objeto do S3, insira o nome do arquivo .zip: configuration-files.zip

   Escolha Next (Próximo).

8. Em Step 3: Add build stage (Etapa 3: Adicionar estágio de construção), selecione Skip build stage (Pular estágio de compilação) e aceite a mensagem de aviso ao clicar novamente em Skip (Pular).

   Escolha Next (Próximo).

9. Em Step 4: Add deploy stage (Etapa 4: Adicionar estágio de implantação):

   1. No Provedor de implantação, selecione AWS AppConfig.

   2. Em Aplicação, selecione o nome da aplicação que você criou no AWS AppConfig. O campo mostra o ID da aplicação.

   3. Em Ambiente, selecione o nome do ambiente que você criou no AWS AppConfig. O campo mostra o ID do ambiente.

   4. Em Perfil de configuração, selecione o nome do perfil de configuração que você criou no AWS AppConfig. O campo mostra o ID do perfil de configuração.

   5. Em Estratégia de implantação, selecione o nome da estratégia de implantação. Pode ser uma estratégia de implantação criada no AppConfig ou uma escolhida entre as estratégias de implantação predefinidas no AppConfig. O campo mostra o ID da estratégia de implantação.

   6. Em Caminho de configuração do artefato de entrada, insira o caminho do arquivo. O caminho de configuração do artefato de entrada deve corresponder à estrutura de diretórios no arquivo .zip do bucket do S3. Neste exemplo, insira o seguinte caminho de arquivo: appconfig-configurations/MyConfigurations/us-west-2/configuration.json.

   7. Escolha Next (Próximo).

10. Em Etapa 5: Revisar, revise as informações e, então selecione Criar pipeline.

Etapa 4: Realizar uma alteração em qualquer arquivo de origem e verificar a implantação

Faça uma alteração nos arquivos de origem e faça upload da alteração para o bucket. Deste modo, a execução de seu pipeline é acionada. Verifique se a configuração está disponível visualizando a versão.