Tutorial: Crie um pipeline que use AWS AppConfig como provedor de implantação

Neste tutorial, você configura um pipeline que entrega continuamente arquivos de configuração usando AWS AppConfig como provedor de ação de implantação em seu estágio de implantação.

Importante

Como parte da criação de um pipeline, um bucket de artefatos S3 fornecido pelo cliente será usado CodePipeline por for artefacts. (Isso é diferente do bucket usado 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

Antes de começar, é necessário concluir as seguintes etapas:

• 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 de origem do S3 para seu aplicativo para criar um bucket do S3.

Etapa 1: Crie seus AWS AppConfig recursos

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

• Um aplicativo em AWS AppConfig é uma unidade lógica de código que fornece recursos para seus clientes.

• Um ambiente em AWS AppConfig é um grupo lógico de AppConfig destinos de implantação, como aplicativos em um ambiente beta ou de produção.

• Um perfil de configuração é um conjunto de configurações que influenciam o comportamento do aplicativo. O perfil de configuração AWS AppConfig permite acessar sua configuração em seu local armazenado.

• (Opcional) Uma estratégia de implantação 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 seus recursos em AWS AppConfig.

   • Criar um aplicativo.

   • Crie um ambiente.

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

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

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

Nesta seção, crie um ou mais arquivos de configuração. Em seguida, compacte e envie seus arquivos de origem para o bucket que o pipeline usa na etapa de origem.

Para criar arquivos de configuração

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

   Hello World!

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

Para 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:

• Uma etapa de origem com uma ação do Amazon S3 em que os artefatos de origem são os arquivos da sua configuração.

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

Criar um pipeline com o assistente

1. Faça login no AWS Management Console e abra o CodePipeline console 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, escolha V2. Para obter mais informações, consulte Tipos de pipeline. Escolha Próximo.

5. 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 emIAM.

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, escolha o nome do bucket de origem do S3.

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

   Escolha 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 Próximo.

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

   1. Em Deploy provider, escolha AWS AppConfig.

   2. Em Aplicativo, escolha o nome do aplicativo em que você criou AWS AppConfig. O campo mostra o ID do seu aplicativo.

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

   4. Em Perfil de configuração, escolha o nome do perfil de configuração que você criou 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. Isso pode ser uma estratégia de implantação que você criou AppConfig ou uma que você escolheu entre as estratégias de implantação predefinidas. 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 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 seus arquivos de origem e faça upload da alteração efetuada no bucket de origem. Deste modo, a execução de seu pipeline é acionada. Verifique se a configuração está disponível visualizando a versão.