Usando a AWS AppConfig deployment events to Amazon SNS extensão - AWS AppConfig

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

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

A AWS AppConfig deployment events to Amazon SNS 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 publica mensagens em um SNS tópico da Amazon 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, AWS AppConfig publica uma mensagem no tópico após cada início, término e reversão da implantação da configuração.

Se você quiser ter mais controle sobre quais pontos de ação enviam SNS notificações da Amazon, você pode criar uma extensão personalizada e inserir um SNS tópico da Amazon Resource Name (ARN) 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 SNS.

Etapa 1: Configurar AWS AppConfig para publicar mensagens em um tópico

Adicione uma política de controle de acesso ao seu SNS tópico da Amazon concedendo AWS AppConfig (appconfig.amazonaws.com) permissões de publicação (sns:Publish). Para obter mais informações, consulte Exemplos de casos de controle de SNS acesso 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 valor para o topicArn parâmetro que contém o SNS tópico ARN da Amazon que você deseja usar.

Depois de criar a associação, quando uma configuração para o AWS AppConfig recurso especificado é 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á uma amostra da mensagem enviada para o SNS tópico da Amazon quando a extensão é invocada.

{ "Type": "Notification", "MessageId": "ae9d702f-9a66-51b3-8586-2b17932a9f28", "TopicArn": "arn:aws:sns:us-east-1:111122223333:MySNSTopic", "Message": { "InvocationId": "7itcaxp", "Parameters": { "topicArn": "arn:aws:sns:us-east-1:111122223333:MySNSTopic" }, "Application": { "Id": "1a2b3c4d", "Name": MyApp }, "Environment": { "Id": "1a2b3c4d", "Name": MyEnv }, "ConfigurationProfile": { "Id": "1a2b3c4d", "Name": "MyConfigProfile" }, "Description": null, "DeploymentNumber": "3", "ConfigurationVersion": "1", "Type": "OnDeploymentComplete" }, "Timestamp": "2022-06-30T20:26:52.067Z", "SignatureVersion": "1", "Signature": "<...>", "SigningCertURL": "<...>", "UnsubscribeURL": "<...>", "MessageAttributes": { "MessageType": { "Type": "String", "Value": "OnDeploymentStart" } } }