

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

# Passo a passo: Criação de extensões personalizadas AWS AppConfig
<a name="working-with-appconfig-extensions-creating-custom"></a>

Para criar uma AWS AppConfig extensão personalizada, conclua as tarefas a seguir. Cada tarefa é descrita em mais detalhes nos tópicos mais adiante.

**nota**  
Você pode ver exemplos de AWS AppConfig extensões personalizadas em GitHub:  
[Extensão de exemplo que impede implantações com um calendário de moratória `blocked day` usando o calendário de alterações do Systems Manager](https://github.com/aws-samples/aws-appconfig-change-calendar-extn)
[Extensão de exemplo que impede o vazamento de segredos em dados de configuração usando a ferramenta git-secrets](https://github.com/aws-samples/aws-appconfig-git-secrets-extn)
[Extensão de exemplo que impede o vazamento de informações de identificação pessoal (PII) em dados de configuração usando o Amazon Comprehend](https://github.com/aws-samples/aws-appconfig-pii-extn)

**1. [Crie uma AWS Lambda função](https://docs.aws.amazon.com/appconfig/latest/userguide/working-with-appconfig-extensions-creating-custom-lambda.html)**  
Para a maioria dos casos de uso, para criar uma extensão personalizada, você deve criar uma AWS Lambda função para realizar qualquer computação e processamento definidos na extensão. Uma exceção a essa regra é se você criar versões *personalizadas* das [extensões de notificação criadas pela AWS](https://docs.aws.amazon.com/appconfig/latest/userguide/working-with-appconfig-extensions-about-predefined.html) para adicionar ou remover pontos de ação. Para obter mais detalhes sobre esta exceção, consulte [Etapa 3: criar uma AWS AppConfig extensão personalizada](working-with-appconfig-extensions-creating-custom-extensions.md).

**2. [Configure permissões para sua extensão personalizada](https://docs.aws.amazon.com/appconfig/latest/userguide/working-with-appconfig-extensions-creating-custom-permissions.html)**  
Para configurar permissões para sua extensão personalizada, você pode realizar um dos seguintes procedimentos:  
+ Crie uma função de serviço AWS Identity and Access Management (IAM) que inclua `InvokeFunction` permissões. 
+ Crie uma política de recursos usando a ação da [AddPermission](https://docs.aws.amazon.com/lambda/latest/dg/API_AddPermission.html)API Lambda.
Este passo a passo descreve como criar o perfil de serviço do IAM.

**3. [Crie uma extensão](https://docs.aws.amazon.com/appconfig/latest/userguide/working-with-appconfig-extensions-creating-custom-extensions.html)**  
Você pode criar uma extensão usando o AWS AppConfig console ou chamando a ação da [CreateExtension](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_CreateExtension.html)API do AWS CLI, Ferramentas da AWS para PowerShell, ou do SDK. O passo a passo usa o console.

**4. [Crie uma associação de extensão](https://docs.aws.amazon.com/appconfig/latest/userguide/working-with-appconfig-extensions-creating-custom-association.html)**  
Você pode criar uma associação de extensão usando o AWS AppConfig console ou chamando a ação da [CreateExtensionAssociation](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_CreateExtensionAssociation.html)API do AWS CLI, Ferramentas da AWS para PowerShell, ou do SDK. O passo a passo usa o console.

**5. Execute uma ação que invoque a extensão**  
Depois de criar a associação, AWS AppConfig invoca a extensão quando os pontos de ação definidos pela extensão ocorrerem para esse recurso. Por exemplo, se você associar uma extensão que contém uma ação `PRE_CREATE_HOSTED_CONFIGURATION_VERSION`, a extensão será invocada toda vez que você criar uma nova versão de configuração hospedada.

Os tópicos nesta seção descrevem cada tarefa envolvida na criação de uma extensão do AWS AppConfig personalizada. Cada tarefa é descrita no contexto de um caso de uso em que o cliente deseja criar uma extensão que faz backup automático de uma configuração em um bucket do Amazon Simple Storage Service (Amazon S3). A extensão é executada sempre que uma configuração hospedada é criada (`PRE_CREATE_HOSTED_CONFIGURATION_VERSION`) ou implantada (`PRE_START_DEPLOYMENT`).

**Topics**
+ [Etapa 1: criar uma função Lambda para uma extensão personalizada AWS AppConfig](working-with-appconfig-extensions-creating-custom-lambda.md)
+ [Etapa 2: configurar permissões para uma AWS AppConfig extensão personalizada](working-with-appconfig-extensions-creating-custom-permissions.md)
+ [Etapa 3: criar uma AWS AppConfig extensão personalizada](working-with-appconfig-extensions-creating-custom-extensions.md)
+ [Etapa 4: criar uma associação de extensão para uma AWS AppConfig extensão personalizada](working-with-appconfig-extensions-creating-custom-association.md)