マニフェストを使用して追加の取得機能を有効にする - AWS AppConfig

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

マニフェストを使用して追加の取得機能を有効にする

AWS AppConfig エージェントには、アプリケーションの設定を取得するのに役立つ以下の追加機能があります。

エージェントマニフェストについて

これらの AWS AppConfig エージェント機能を有効にするには、マニフェストを作成します。マニフェストは、エージェントが実行できるアクションを制御するために提供する設定データのセットです。マニフェストは JSON で記述されます。これには、 を使用してデプロイしたさまざまな設定に対応する一連の最上位キーが含まれています AWS AppConfig。

マニフェストには複数の設定を含めることができます。さらに、マニフェスト内の各設定は、指定された設定に使用する 1 つ以上のエージェント機能を識別できます。マニフェストのコンテンツは、次の形式を使用します。

{ "application_name:environment_name:configuration_name": { "agent_feature_to_enable_1": { "feature-setting-key": "feature-setting-value" }, "agent_feature_to_enable_2": { "feature-setting-key": "feature-setting-value" } } }

以下は、2 つの設定を持つマニフェストの JSON の例です。最初の設定 (MyApp) では、 AWS AppConfig エージェント機能は使用されません。2 番目の設定 (My2ndApp) では、ディスクへの書き込み設定コピーマルチアカウント取得機能を使用します。

{ "MyApp:Test:MyAllowListConfiguration": {}, "My2ndApp:Beta:MyEnableMobilePaymentsFeatureFlagConfiguration": { "credentials": { "roleArn": "arn:us-west-1:iam::123456789012:role/MyTestRole", "roleExternalId": "00b148e2-4ea4-46a1-ab0f-c422b54d0aac", "roleSessionName": "AwsAppConfigAgent", "credentialsDuration": "2h" }, "writeTo": { "path": "/tmp/aws-appconfig/my-2nd-app/beta/my-enable-payments-feature-flag-configuration.json" } } }
エージェントマニフェストを提供する方法

マニフェストは、 AWS AppConfig エージェントが読み取れる場所にファイルとして保存できます。または、マニフェストを AWS AppConfig 設定として保存し、エージェントに指定することもできます。エージェントマニフェストを指定するには、MANIFEST 環境変数を次のいずれかの値で設定する必要があります。

マニフェストの場所 環境変数の値 ユースケース

ファイル

file:/path/to/agent-manifest.json

マニフェストが頻繁に変更されない場合は、この方法を使用します。

AWS AppConfig 設定

application-name:environment-name:configuration-name

動的な更新には、この方法を使用します。他の設定を保存するのと同じ方法で AWS AppConfig 、設定 AWS AppConfig として に保存されているマニフェストを更新してデプロイできます。

環境変数

マニフェストコンテンツ (JSON)

マニフェストが頻繁に変更されない場合は、この方法を使用します。この方法は、ファイルを公開するよりも環境変数を設定する方が簡単なコンテナ環境に役立ちます。

AWS AppConfig エージェントの変数の設定の詳細については、ユースケースに関連するトピックを参照してください。