Usando a AWS AppConfig deployment events to Amazon SQS extensão

A AWS AppConfig deployment events to Amazon SQS extensão é uma extensão AWS criada por você que ajuda você a monitorar e agir no fluxo de trabalho de implantação da AWS AppConfig configuração. A extensão enfileira mensagens em sua fila do Amazon Simple Queue Service (AmazonSQS) sempre que uma configuração é implantada. Depois de associar a extensão a um de seus AWS AppConfig aplicativos, ambientes ou perfis de configuração, coloca uma mensagem na AWS AppConfig fila após cada início, término e reversão de implantação da configuração.

Se você quiser ter mais controle sobre quais pontos de ação enviam SQS notificações da Amazon, você pode criar uma extensão personalizada e inserir um Amazon Resource Name (ARN) na SQS fila da Amazon para o URI campo. Para obter mais informações sobre como criar uma extensão, consulte Passo a passo: Criação de extensões personalizadas AWS AppConfig.

Como usar a extensão

Esta seção descreve como usar a extensão AWS AppConfig deployment events to Amazon SQS.

Etapa 1: Configurar AWS AppConfig para enfileirar mensagens

Adicione uma SQS política da Amazon à sua SQS fila da Amazon concedendo AWS AppConfig (appconfig.amazonaws.com) permissões de envio de mensagens (sqs:SendMessage). Para obter mais informações, consulte Exemplos básicos das SQS políticas da Amazon.

Etapa 2: crie uma associação de extensão

Anexe a extensão a um de seus AWS AppConfig recursos criando uma associação de extensão. Você cria a associação usando o AWS AppConfig console ou a CreateExtensionAssociationAPIação. Ao criar a associação, você especifica o perfil ARN de um AWS AppConfig aplicativo, ambiente ou configuração. Se você associar a extensão a um aplicativo ou ambiente, uma notificação será enviada para qualquer perfil de configuração contido no aplicativo ou ambiente especificado. Ao criar a associação, você deve inserir um Here parâmetro que contenha a SQS fila ARN da Amazon que você deseja usar.

Depois de criar a associação, quando uma configuração para o AWS AppConfig recurso especificado é criada ou implantada, AWS AppConfig invoca a extensão e envia notificações de acordo com os pontos de ação especificados na extensão.

nota

Esta extensão é invocada pelos seguintes pontos de ação:

• ON_DEPLOYMENT_START

• ON_DEPLOYMENT_COMPLETE

• ON_DEPLOYMENT_ROLLED_BACK

Não é possível personalizar os pontos de ação desta extensão. Para invocar pontos de ação diferentes, você pode criar sua própria extensão. Para obter mais informações, consulte Passo a passo: Criação de extensões personalizadas AWS AppConfig.

Use os procedimentos a seguir para criar uma associação de AWS AppConfig extensão usando o AWS Systems Manager console ou AWS CLI o.

Para criar uma associação de extensão (console)

1. Abra o AWS Systems Manager console em https://console.aws.amazon.com/systems-manager/appconfig/.

2. No painel de navegação, escolha AWS AppConfig.

3. Na guia Extensões, escolha Adicionar ao recurso.

4. Na seção Detalhes do recurso de extensão, em Tipo de recurso, escolha um tipo de AWS AppConfig recurso. Dependendo do recurso escolhido, AWS AppConfig solicita que você escolha outros recursos.

5. Escolha Criar associação ao recurso.

Aqui está um exemplo da mensagem enviada para a SQS fila da Amazon quando a extensão é invocada.

{
   "InvocationId":"7itcaxp",
   "Parameters":{
      "queueArn":"arn:aws:sqs:us-east-1:111122223333:MySQSQueue"
   },
   "Application":{
      "Id":"1a2b3c4d",
      "Name":MyApp
   },
   "Environment":{
      "Id":"1a2b3c4d",
      "Name":MyEnv
   },
   "ConfigurationProfile":{
      "Id":"1a2b3c4d",
      "Name":"MyConfigProfile"
   },
   "Description":null,
   "DeploymentNumber":"3",
   "ConfigurationVersion":"1",
   "Type":"OnDeploymentComplete"
}