Menggunakan peristiwa AWS AppConfig penerapan ke ekstensi Amazon SNS

AWS AppConfig deployment events to Amazon SNSEkstensi adalah ekstensi yang AWS ditulis yang membantu Anda memantau dan bertindak pada alur kerja penerapan AWS AppConfig konfigurasi. Ekstensi menerbitkan pesan ke topik Amazon SNS setiap kali konfigurasi diterapkan. Setelah Anda mengaitkan ekstensi ke salah satu AWS AppConfig aplikasi, lingkungan, atau profil konfigurasi, AWS AppConfig menerbitkan pesan ke topik setelah setiap penerapan konfigurasi dimulai, diakhiri, dan dikembalikan.

Jika ingin lebih mengontrol titik tindakan mana yang mengirim notifikasi Amazon SNS, Anda dapat membuat ekstensi khusus dan memasukkan topik Amazon SNS Nama Sumber Daya Amazon (ARN) untuk bidang URI. Untuk informasi tentang membuat ekstensi, lihatWalkthrough: Membuat ekstensi khusus AWS AppConfig.

Menggunakan ekstensi

Bagian ini menjelaskan cara menggunakan AWS AppConfig deployment events to Amazon SNS ekstensi.

Langkah 1: Konfigurasikan AWS AppConfig untuk mempublikasikan pesan ke topik

Tambahkan kebijakan kontrol akses ke topik Amazon SNS Anda yang memberikan () izin publikasi AWS AppConfig (appconfig.amazonaws.com). sns:Publish Untuk informasi selengkapnya, lihat Contoh kasus untuk kontrol akses Amazon SNS.

Langkah 2: Buat asosiasi ekstensi

Lampirkan ekstensi ke salah satu AWS AppConfig sumber daya Anda dengan membuat asosiasi ekstensi. Anda membuat asosiasi menggunakan AWS AppConfig konsol atau aksi CreateExtensionAssociationAPI. Saat Anda membuat asosiasi, Anda menentukan ARN AWS AppConfig aplikasi, lingkungan, atau profil konfigurasi. Jika Anda mengaitkan ekstensi ke aplikasi atau lingkungan, pemberitahuan dikirim untuk profil konfigurasi apa pun yang terdapat dalam aplikasi atau lingkungan yang ditentukan. Saat Anda membuat asosiasi, Anda harus memasukkan nilai untuk topicArn parameter yang berisi ARN topik Amazon SNS yang ingin Anda gunakan.

Setelah Anda membuat asosiasi, ketika konfigurasi untuk AWS AppConfig sumber daya yang ditentukan diterapkan, AWS AppConfig memanggil ekstensi dan mengirim pemberitahuan sesuai dengan titik tindakan yang ditentukan dalam ekstensi.

catatan

Ekstensi ini dipanggil oleh poin tindakan berikut:

• ON_DEPLOYMENT_START

• ON_DEPLOYMENT_COMPLETE

• ON_DEPLOYMENT_ROLLED_BACK

Anda tidak dapat menyesuaikan titik tindakan untuk ekstensi ini. Untuk memanggil titik tindakan yang berbeda, Anda dapat membuat ekstensi Anda sendiri. Untuk informasi selengkapnya, lihat Walkthrough: Membuat ekstensi khusus AWS AppConfig.

Gunakan prosedur berikut untuk membuat asosiasi AWS AppConfig ekstensi dengan menggunakan AWS Systems Manager konsol atau AWS CLI.

Untuk membuat asosiasi ekstensi (konsol)

1. Buka AWS Systems Manager konsol di https://console.aws.amazon.com/systems-manager/appconfig/.

2. Di panel navigasi, pilih AWS AppConfig.

3. Pada tab Ekstensi, pilih Tambahkan ke sumber daya.

4. Di bagian Detail sumber daya ekstensi, untuk jenis sumber daya, pilih jenis AWS AppConfig sumber daya. Bergantung pada sumber daya yang Anda pilih, AWS AppConfig meminta Anda untuk memilih sumber daya lain.

5. Pilih Buat asosiasi ke sumber daya.

Berikut adalah contoh pesan yang dikirim ke topik Amazon SNS saat ekstensi dipanggil.

{
    "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"
        }
    }
}