AWS AppConfig エージェント Lambda 拡張機能の設定 - AWS AppConfig

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

AWS AppConfig エージェント Lambda 拡張機能の設定

以下の AWS Lambda 環境変数を変更することで、拡張機能を設定できます。詳細については、「 デベロッパーガイド」のAWS Lambda 「環境変数の使用」を参照してください。 AWS Lambda

設定データのプリフェッチ

環境変数 AWS_APPCONFIG_EXTENSION_PREFETCH_LIST は、関数の起動時間を大幅に改善できます。 AWS AppConfig エージェント Lambda 拡張機能が初期化されると、 AWS AppConfig Lambda が関数の初期化とハンドラーの呼び出しを開始する前に、 から指定された設定を取得します。場合によっては、関数が要求する前に、設定データがローカルキャッシュで既に利用可能になっていることがあります。

プリフェッチ機能を使用するには、設定データに対応するパスに、環境変数の値を設定します。例えば、設定がそれぞれ「my_application」、「my_environment」、「my_configuration_data」という名前のアプリケーション、環境、および設定プロファイルに対応している場合、パスは /applications/my_application/environments/my_environment/configurations/my_configuration_data のようになります。設定項目をカンマ区切りのリストとして列挙することで、複数の設定項目を指定できます (カンマを含むリソース名がある場合は、リソースの名前ではなく ID 値を使用します)。

別のアカウントから設定データへアクセスします

AWS AppConfig エージェント Lambda 拡張機能は、データへのアクセス許可を付与するIAMロールを指定することで、別のアカウントから設定データを取得できます。これを設定するには、次の手順に従います。

  1. AWS AppConfig が設定データの管理に使用されるアカウントで、Lambda 関数を実行しているアカウントに appconfig:StartConfigurationSession および appconfig:GetLatestConfigurationアクションへのアクセスを許可する信頼ポリシーと、 AWS AppConfig 設定リソースARNsに対応する部分的または完全なロールを作成します。

  2. Lambda 関数を実行しているアカウントで、ステップ 1 で作成したロールARNの を使用してAWS_APPCONFIG_EXTENSION_ROLE_ARN、環境変数を Lambda 関数に追加します。

  3. (オプショナル) 必要に応じて、AWS_APPCONFIG_EXTENSION_ROLE_EXTERNAL_ID 環境変数を使用して外部 ID を指定できます。同様に、 AWS_APPCONFIG_EXTENSION_ROLE_SESSION_NAME セッション名は環境変数を使用して設定できます。

注記

以下の情報に注意してください。

  • AWS AppConfig エージェント Lambda 拡張機能は、1 つのアカウントからのみデータを取得できます。IAM ロールを指定すると、拡張機能は Lambda 関数が実行されているアカウントから設定データを取得できなくなります。

  • AWS Lambda は、Amazon CloudWatch Logs を使用して AWS AppConfig Agent Lambda 拡張機能と Lambda 関数に関する情報をログに記録します。

環境変数 詳細 デフォルト値

AWS_APPCONFIG_EXTENSION_HTTP_PORT

この環境変数は、拡張機能をホストするローカルHTTPサーバーを実行するポートを指定します。

2772

AWS_APPCONFIG_EXTENSION_LOG_LEVEL

この環境変数は、関数の Amazon CloudWatch Logs に送信する AWS AppConfig 拡張固有のログを指定します。大文字と小文字を区別しない有効な値は debuginfowarnerror、および none です。デバッグには、タイミング情報など、拡張機能に関する詳細情報が含まれます。

info

AWS_APPCONFIG_EXTENSION_MAX_CONNECTIONS

この環境変数は、拡張機能が AWS AppConfigから設定を取得するために使用する最大接続数を設定します。

3

AWS_APPCONFIG_EXTENSION_POLL_INTERVAL_SECONDS

この環境変数は、更新された設定 AWS AppConfig の拡張ポーリングの頻度を秒単位で制御します。

45

AWS_APPCONFIG_EXTENSION_POLL_TIMEOUT_MILLIS

この環境変数は、キャッシュ内のデータを更新する AWS AppConfig ときに からのレスポンスを待機する最大時間をミリ秒単位で制御します。 AWS AppConfig が指定された時間内に応答しない場合、拡張機能はこのポーリング間隔をスキップし、以前に更新されたキャッシュデータを返します。

3000

AWS_APPCONFIG_EXTENSION_PREFETCH_LIST

この環境変数は、関数が初期化されてハンドラーが実行される前に、拡張機能が取得を開始する設定データを指定します。これにより、機能のコールドスタート時間を大幅に短縮できます。

なし
AWS_APPCONFIG_EXTENSION_PROXY_HEADERS この環境変数は、AWS_APPCONFIG_EXTENSION_PROXY_URL 環境変数で参照されるプロキシに必要なヘッダーを指定します。値は、コンマで区切られたヘッダーの一覧です。各ヘッダーは次の形式を使用します。
"header: value"
なし
AWS_APPCONFIG_EXTENSION_PROXY_URL この環境変数は、 AWS AppConfig 拡張機能から への接続URLに使用するプロキシを指定します AWS のサービス。 HTTPSおよび HTTPURLsがサポートされています。 なし
AWS_APPCONFIG_EXTENSION_ROLE_ARN この環境変数は、設定を取得するために AWS AppConfig 拡張機能が引き受ける必要があるIAMロールARNに対応するロールを指定します。 なし
AWS_APPCONFIG_EXTENSION_ROLE_EXTERNAL_ID この環境変数は、引き受けたロール と組み合わせて使用する外部 ID を指定しますARN。 なし
AWS_APPCONFIG_EXTENSION_ROLE_SESSION_NAME この環境変数は、引き受けたIAMロールの認証情報に関連付けるセッション名を指定します。 なし
AWS_APPCONFIG_EXTENSION_SERVICE_REGION この環境変数は、拡張機能が AWS AppConfig サービスを呼び出すために使用する代替リージョンを指定します。未定義の場合、拡張機能は現在のリージョンのエンドポイントを使用します。 なし

AWS_APPCONFIG_EXTENSION_MANIFEST

この環境変数は、マルチアカウントの取得ディスク への設定の保存など、設定ごとに追加の機能を利用するように AWS AppConfig エージェントを設定します。次のいずれかの値を入力できます。

  • "app:env:manifest-config"

  • "file:/fully/qualified/path/to/manifest.json"

これらの機能の詳細については、「マニフェストを使用して追加の取得機能を有効にする」を参照してください。

true

AWS_APPCONFIG_EXTENSION_WAIT_ON_MANIFEST

この環境変数は、起動を完了する前にマニフェストが処理されるまで待機するように AWS AppConfig エージェントを設定します。

true