Tutorial: Criar um pipeline que usa o AWS AppConfig como provedor de implantação - AWS CodePipeline
Pré-requisitosEtapa 1: Criar recursos do AWS AppConfigEtapa 2|: Fazer upload de arquivos para o bucket de origem do S3Etapa 3: Criar o pipeline Etapa 4: Realizar uma alteração em qualquer arquivo de origem e verificar a implantação

Tutorial: Criar um pipeline que usa o AWS AppConfig como 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.

Importante

Como parte da criação de um pipeline, um bucket de artefatos do S3 fornecido pelo cliente será usado pelo CodePipeline para artefatos. (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 pipeline, garanta que o bucket de artefatos do S3 seja de propriedade de Contas da AWS seguras e confiáveis.

Pré-requisitos

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

Etapa 1: Criar recursos do AWS AppConfig

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

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

  • Um ambiente no AWS AppConfig é um grupo de implantação lógica de destinos do AppConfig, 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. Um perfil de configuração permite que o AWS AppConfig acesse a configuração em seu 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 Console de gerenciamento da AWS.

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

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 de implantação do AppConfig.

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

  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, escolha Novo perfil de serviço para permitir que o CodePipeline crie um perfil de serviço no IAM.

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

  8. Em Etapa 3: Adicionar etapa de origem, em 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.

  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 Provedor da implantação, escolha AWS AppConfig.

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

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

  12. Em Etapa 7: 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.