As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# 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. (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 seu pipeline, certifique-se de que o bucket de artefatos do S3 Contas da AWS seja de propriedade de quem é seguro e confiável.
**Topics**
+ [Pré-requisitos](#tutorials-AppConfig-prereq)
+ [Etapa 1: Crie seus AWS AppConfig recursos](#tutorials-AppConfig-application)
+ [Etapa 2\$1: Fazer upload de arquivos para o bucket de origem do S3](#tutorials-AppConfig-bucket)
+ [Etapa 3: Criar o pipeline](#tutorials-AppConfig-pipeline)
+ [Etapa 4: Realizar uma alteração em qualquer arquivo de origem e verificar a implantação](#tutorials-AppConfig-verify)
## 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 a aplicação](tutorials-simple-s3.md#s3-create-s3-bucket) 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 Console de gerenciamento da AWS.
1. Use as etapas nos tópicos a seguir para criar seus recursos em AWS AppConfig.
+ [Criar um aplicativo](https://docs.aws.amazon.com/systems-manager/latest/userguide/appconfig-creating-application.html).
+ [Crie um ambiente](https://docs.aws.amazon.com/systems-manager/latest/userguide/appconfig-creating-environment.html).
+ [Crie um perfil AWS CodePipeline de configuração](https://docs.aws.amazon.com/systems-manager/latest/userguide/appconfig-creating-configuration-and-profile.html).
+ (Opcional) [Escolha uma estratégia de implantação predefinida ou crie sua própria](https://docs.aws.amazon.com/systems-manager/latest/userguide/appconfig-creating-deployment-strategy.html).
## Etapa 2\$1: 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!
```
1. 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
```
1. 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 Console de gerenciamento da AWS e abra o CodePipeline console em [http://console.aws.amazon. com/codesuite/codepipeline/home](https://console.aws.amazon.com/codesuite/codepipeline/home).
1. Na página **Welcome (Bem-vindo)**, **Getting started (Conceitos básicos)** ou **Pipelines**, selecione **Create pipeline (Criar pipeline)**.
1. 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**.
1. Em **Etapa 2: Escolher as configurações do pipeline**, em **Nome do pipeline**, insira **MyAppConfigPipeline**.
1. CodePipeline fornece tubulações do tipo V1 e V2, que diferem em características e preço. O tipo V2 é o único tipo que você pode escolher no console. Para ter mais informações, consulte [Pipeline types](https://docs.aws.amazon.com/codepipeline/latest/userguide/pipeline-types-planning.html?icmpid=docs_acp_help_panel). Para obter informações sobre preços de CodePipeline, consulte [Preços](https://aws.amazon.com/codepipeline/pricing/).
1. 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 no IAM.
1. Deixe as configurações em **Advanced settings (Configurações avançadas)** como padrão e escolha **Next (Próximo)**.
1. 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**.
1. 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**.
1. Em **Etapa 5: Adicionar etapa de teste**, escolha **Ignorar etapa de teste** e aceite a mensagem de aviso escolhendo **Ignorar** novamente.
Escolha **Próximo**.
1. Na **Etapa 6: Adicionar estágio de implantação**:
1. Em **Deploy provider**, escolha **AWS AppConfig**.
1. Em **Aplicativo**, escolha o nome do aplicativo em que você criou AWS AppConfig. O campo mostra o ID do seu aplicativo.
1. Em **Ambiente**, escolha o nome do ambiente em que você criou AWS AppConfig. O campo mostra o ID do ambiente.
1. 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.
1. 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.
1. 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`.
1. Escolha **Próximo**.
1. Na **Etapa 7: Revisar**, revise as informações e escolha **Criar funil**.
## 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.