翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# AWS AppConfig 拡張機能について
<a name="working-with-appconfig-extensions-about"></a>

このトピックでは、 AWS AppConfig 拡張機能の概念と用語について説明します。この情報は、 AWS AppConfig 拡張機能の設定と使用に必要な各ステップのコンテキストで説明されています。

**Topics**
+ [ステップ 1: 拡張機能を使用する操作を決定します](#working-with-appconfig-extensions-how-it-works-step-1)
+ [ステップ 2: 拡張機能をいつ実行するかを決める](#working-with-appconfig-extensions-how-it-works-step-2)
+ [ステップ 3: 拡張機能の作成](#working-with-appconfig-extensions-how-it-works-step-3)
+ [ステップ 4: 設定をデプロイし、拡張機能のアクションが実行されたことを確認する](#working-with-appconfig-extensions-how-it-works-step-4)

## ステップ 1: 拡張機能を使用する操作を決定します
<a name="working-with-appconfig-extensions-how-it-works-step-1"></a>

 AWS AppConfig デプロイが完了するたびに Slack にメッセージを送信するウェブフックに通知を受け取りますか? 設定をデプロイする前に、設定プロファイルを Amazon Simple Storage Service (Amazon S3) バケットにバックアップしますか? 設定をデプロイする前に、設定データから機密情報を削除したいですか？ 拡張機能を使用すると、これらのタイプのタスクだけでなく、その他のタスクも実行できます。カスタム拡張機能を作成することも、含まれているオー AWS サリングされた拡張機能を使用することもできます AWS AppConfig。

**注記**  
ほとんどのユースケースでは、カスタム拡張機能を作成するには、拡張機能で定義された計算と処理を実行する AWS Lambda 関数を作成する必要があります。詳細については、「[チュートリアル: カスタム AWS AppConfig 拡張機能の作成](working-with-appconfig-extensions-creating-custom.md)」を参照してください。

次の AWS 作成された拡張機能は、設定デプロイを他の サービスとすばやく統合するのに役立ちます。これらの拡張機能は、 AWS AppConfig コンソールで、または 、 AWS CLI AWS Tools for PowerShell、 SDK から直接拡張機能 [API アクション](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_Operations.html)を呼び出すことで使用できます。


****  

| 拡張機能 | 説明 | 
| --- | --- | 
| [AWS AppConfig EventBridge へのイベントのデプロイ](https://docs.aws.amazon.com/appconfig/latest/userguide/working-with-appconfig-extensions-about-predefined-notification-eventbridge.html) | 設定がデプロイされると、この拡張機能は EventBridge のデフォルトのイベントバスにイベントを送信します。 | 
| [AWS AppConfig Amazon Simple Notification Service (Amazon SNS) への デプロイイベント](https://docs.aws.amazon.com/appconfig/latest/userguide/working-with-appconfig-extensions-about-predefined-notification-sns.html) | この拡張機能は、設定のデプロイ時に指定した Amazon SNS トピックにメッセージを送信します。 | 
| [AWS AppConfig Amazon Simple Queue Service (Amazon SQS) へのデプロイイベント](https://docs.aws.amazon.com/appconfig/latest/userguide/working-with-appconfig-extensions-about-predefined-notification-sqs.html) | この拡張機能は、設定がデプロイされるとメッセージを Amazon SQS キューにエンキューします。 | 
| [「インテグレーションエクステンション — アトラシアン Jira」](https://docs.aws.amazon.com/appconfig/latest/userguide/working-with-appconfig-extensions-about-jira.html) | この拡張機能を使用すると AWS AppConfig 、[機能フラグ](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-configuration-and-profile.html#appconfig-creating-configuration-and-profile-feature-flags)を変更するたびに問題を作成および更新できます。 | 

## ステップ 2: 拡張機能をいつ実行するかを決める
<a name="working-with-appconfig-extensions-how-it-works-step-2"></a>

拡張機能は、 AWS AppConfig ワークフロー中に実行する 1 つ以上のアクションを定義します。たとえば、 AWS 作成された`AWS AppConfig deployment events to Amazon SNS`拡張機能には、Amazon SNS トピックに通知を送信するアクションが含まれています。各アクションは、 を操作するとき、 AWS AppConfig または AWS AppConfig がユーザーに代わってプロセスを実行するときに呼び出されます。これらは*アクションポイント*と呼ばれます。 AWS AppConfig 拡張機能は次のアクションポイントをサポートします。

**PRE\_\* アクションポイント**: `PRE_*` アクションポイントで設定された拡張機能アクションは、リクエストの検証後に適用されますが、 AWS AppConfig がアクションポイント名に対応するアクティビティが実行される前に適用されます。これらのアクション呼び出しはリクエストと同時に処理されます。複数のリクエストが行われた場合、アクション呼び出しは順番に実行されます。また、`PRE_*` アクションポイントは設定を受け取り、設定の内容を変更できることにも注意してください。`PRE_*` アクションポイントはエラーに応答してアクションが起こらないようにすることもできます。
+ `PRE_CREATE_HOSTED_CONFIGURATION_VERSION`
+ `PRE_START_DEPLOYMENT`

**ON\_\* アクションポイント**: 拡張機能は、`ON_*`アクションポイントを使用して AWS AppConfig ワークフローと並行して実行することもできます。 `ON_*` アクションポイントは非同期的に呼び出されます。 `ON_*`アクションポイントは設定の内容を受信しません。`ON_*` アクションポイント中に拡張機能でエラーが発生した場合、サービスはそのエラーを無視してワークフローを続行します。
+ `ON_DEPLOYMENT_START`
+ `ON_DEPLOYMENT_STEP`
+ `ON_DEPLOYMENT_BAKING`
+ `ON_DEPLOYMENT_COMPLETE`
+ `ON_DEPLOYMENT_ROLLED_BACK`

**AT\_\* アクションポイント**: `AT_*` アクションポイントに設定された拡張機能アクションは、 AWS AppConfig ワークフローと同期的かつ並行して呼び出されます。`AT_*` アクションポイント中に拡張機能でエラーが発生した場合、サービスはワークフローを停止し、デプロイをロールバックします。
+ `AT_DEPLOYMENT_TICK`

## ステップ 3: 拡張機能の作成
<a name="working-with-appconfig-extensions-how-it-works-step-3"></a>

拡張機能を作成したり、 AWS 作成した拡張機能を設定したりするには、特定の AWS AppConfig リソースが使用されているときに拡張機能を呼び出すアクションポイントを定義します。たとえば、特定のアプリケーションの設定デプロイが開始されるたびに、`AWS AppConfig deployment events to Amazon SNS` 拡張機能を実行して Amazon SNS トピックに関する通知を受信するように選択できます。特定の AWS AppConfig リソースの拡張機能を呼び出すアクションポイントの定義は、*拡張機能の関連付け*と呼ばれます。拡張機能の関連付けは、アプリケーションや設定プロファイルなど、拡張機能と AWS AppConfig リソース間の指定された関係です。

1 つの AWS AppConfig アプリケーションに複数の環境と設定プロファイルを含めることができます。拡張機能をアプリケーションまたは環境に関連付けると、 は、該当する場合、アプリケーションまたは環境リソースに関連するワークフローの拡張機能を AWS AppConfig 呼び出します。

たとえば、AccessList という設定プロファイルを含む MobileApps という AWS AppConfig アプリケーションがあるとします。また、MobileApps アプリケーションにはベータ、インテグレーション、プロダクション環境が含まれているとします。 AWS 作成した Amazon SNS 通知拡張機能の拡張機能関連付けを作成し、その拡張機能を MobileApps アプリケーションに関連付けます。Amazon SNS 通知拡張は、3 つの環境のいずれかにアプリケーションの設定がデプロイされるたびに呼び出されます。

**注記**  
 AWS オーサリングされた拡張機能を使用するには拡張機能を作成する必要はありませんが、拡張機能の関連付けを作成する必要があります。

## ステップ 4: 設定をデプロイし、拡張機能のアクションが実行されたことを確認する
<a name="working-with-appconfig-extensions-how-it-works-step-4"></a>

関連付けを作成した後、ホストされた設定が作成されるか、設定がデプロイされると、 は拡張機能を AWS AppConfig 呼び出し、指定されたアクションを実行します。拡張機能が呼び出されると、`PRE-*`アクションポイント中にシステムにエラーが発生した場合、 はそのエラーに関する情報 AWS AppConfig を返します。