AWS AppConfig deployment events to Amazon SQS 拡張機能の使用

AWS AppConfig deployment events to Amazon SQS 拡張機能は、 AWS AppConfig 設定デプロイワークフローのモニタリングと対応に役立つ、 AWS 作成済みの拡張機能です。拡張機能は、設定がデプロイされるたびに Amazon Simple Queue Service (Amazon SQS) キューにメッセージをキューに入れます。拡張機能を AWS AppConfig アプリケーション、環境、または設定プロファイルの 1 AWS AppConfig つに関連付けると、 は設定デプロイの開始、終了、ロールバックのたびにメッセージをキューにキューに入れます。

Amazon SQS通知を送信するアクションポイントをより詳細に制御したい場合は、カスタム拡張機能を作成し、 URI フィールドに Amazon SQSキューの Amazon リソースネーム (ARN) を入力できます。拡張機能の作成の詳細については、「チュートリアル: カスタム AWS AppConfig 拡張機能の作成」を参照してください。

拡張機能の使用

このセクションでは、 AWS AppConfig deployment events to Amazon SQS 拡張機能を使用する方法について説明します。

ステップ 1: メッセージをキューに入れる AWS AppConfig ように を設定する

Amazon SQSポリシーを Amazon SQSキューに追加し AWS AppConfig 、メッセージアクセス許可 (appconfig.amazonaws.com) を送信しますsqs:SendMessage。詳細については、「Amazon SQSポリシーの基本的な例」を参照してください。

ステップ 2: 拡張機能の作成

拡張機能の関連付けを作成して、いずれかの AWS AppConfig リソースに拡張機能をアタッチします。 AWS AppConfig コンソールまたは CreateExtensionAssociationAPIアクションを使用して関連付けを作成します。関連付けを作成するときは、 AWS AppConfig アプリケーション、環境、または設定プロファイルARNの を指定します。エクステンションをアプリケーションまたは環境に関連付けると、指定したアプリケーションまたは環境に含まれるすべての設定プロファイルに通知が送信されます。関連付けを作成するときは、使用する Amazon SQSキューARNの を含むHereパラメータを入力する必要があります。

関連付けを作成した後、指定された AWS AppConfig リソースの設定が作成またはデプロイされると、 は拡張機能を AWS AppConfig 呼び出し、拡張機能で指定されたアクションポイントに従って通知を送信します。

注記

このエクステンションは、以下のアクションポイントによって呼び出されます。

• ON_DEPLOYMENT_START

• ON_DEPLOYMENT_COMPLETE

• ON_DEPLOYMENT_ROLLED_BACK

この拡張機能の使用、カスタマイズはできません。さまざまなアクションポイントを呼び出すための、独自のエクステンションを作成できます。詳細については、「チュートリアル: カスタム AWS AppConfig 拡張機能の作成」を参照してください。

AWS Systems Manager コンソールまたは を使用して AWS AppConfig 拡張機能の関連付けを作成するには、以下の手順に従います AWS CLI。

拡張機能の関連付けを作成します (コンソール)

1. https://console.aws.amazon.com/systems-manager/appconfig/ で AWS Systems Manager コンソールを開きます。

2. ナビゲーションペインで、AWS AppConfig を選択します。

3. エクステンションタブでリソースに追加を選択します。

4. 「拡張リソースの詳細」セクションの「リソースタイプ」で、 AWS AppConfig リソースタイプを選択します。選択したリソースに応じて、 は他のリソースを選択するように AWS AppConfig 促します。

5. リソースとの関連付けを作成 を選択します。

拡張機能が呼び出されたときに Amazon SQSキューに送信されるメッセージの例を次に示します。

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