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

Usar o AWS AppConfig eventos de implantação na extensão Amazon SNS

A AWS AppConfig deployment events to Amazon SNS extensão é uma extensão AWS criada 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 tópico do Amazon SNS 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 de implantação de configuração.

Se quiser ter mais controle sobre quais pontos de ação enviam notificações do Amazon SNS, você poderá criar uma extensão personalizada e inserir o nome do recurso da Amazon (ARN) de um tópico do Amazon SNS no campo URI. Para obter mais informações sobre como criar uma extensão, consulte Passo a passo: Criação personalizada AWS AppConfig extensões.

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 tópico do Amazon SNS que dê AWS AppConfig (appconfig.amazonaws.com) permissão para publicar mensagens (sns:Publish). Para garantir que somente sua própria conta possa enviar essas mensagens, adicione uma aws:SourceAccount condição à política e defina-a como seu ID de AWS conta. Isso impede que alguém em uma AWS conta diferente use a extensão para enviar mensagens para seu tópico. Para definir um escopo ainda mais rigoroso do acesso, você pode usar uma aws:SourceArn condição definida como o ARN da associação de extensão. Para obter mais informações, consulte Casos de exemplo para controle de acesso do Amazon SNS.

O exemplo de política a seguir permite AWS AppConfig publicar em seu tópico somente quando a solicitação vem de sua própria conta. MySNSTopicSubstitua o exemplo de ID da conta por seus próprios valores.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "AllowAppConfigPublish",
            "Effect": "Allow",
            "Principal": {
                "Service": "appconfig.amazonaws.com"
            },
            "Action": "SNS:Publish",
            "Resource": "arn:aws:sns:us-east-1:111122223333:MySNSTopic",
            "Condition": {
                "StringEquals": {
                    "aws:SourceAccount": "111122223333"
                }
            }
        }
    ]
}

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 ação CreateExtensionAssociation da API. Ao criar a associação, você especifica o ARN de um AWS AppConfig aplicativo, ambiente ou perfil de 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 parâmetro topicArn que contém o ARN do tópico do Amazon SNS 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.

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.

Veja uma amostra da mensagem enviada para o tópico do Amazon SNS 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"
        }
    }
}