AWS AppConfig エージェント Lambda 拡張機能を使用した設定データの取得

AWS Lambda 拡張機能は、Lambda 関数の機能を強化するコンパニオンプロセスです。拡張機能は、関数が呼び出される前に開始し、関数と並行して実行し、関数の呼び出しが処理された後も引き続き実行できます。本質的に、Lambda 拡張機能は Lambda 呼び出しと並行して実行されるクライアントのようなものです。この並列クライアントは、ライフサイクル中の任意の時点で関数とインターフェイスできます。

Lambda 関数で AWS AppConfig 機能フラグやその他の動的設定データを使用する場合は、 AWS AppConfig エージェント Lambda 拡張機能を Lambda 関数のレイヤーとして追加することをお勧めします。これにより、機能フラグの呼び出しが簡単になり、拡張機能自体には、コストを削減 AWS AppConfig しながら の使用を簡素化するベストプラクティスが含まれています。 AWS AppConfig サービスへの API コールが少なくなり、Lambda 関数の処理時間が短縮されるため、コストを削減できます。Lambda 拡張機能の詳細については、「AWS Lambda デベロッパーガイド」の「Lambda 拡張機能」を参照してください。

このトピックでは、 AWS AppConfig エージェント Lambda 拡張機能に関する情報と、Lambda 関数で動作するように拡張機能を設定する手順について説明します。

仕組み

AWS AppConfig を使用して Lambda 拡張機能のない Lambda 関数の設定を管理する場合は、 StartConfigurationSessionおよび GetLatestConfiguration API アクションと統合して、Lambda 関数が設定更新を受け取るように設定する必要があります。

AWS AppConfig エージェント Lambda 拡張機能を Lambda 関数と統合すると、このプロセスが簡素化されます。拡張機能は、 AWS AppConfig サービスの呼び出し、取得されたデータのローカルキャッシュの管理、次のサービス呼び出しに必要な設定トークンの追跡、バックグラウンドでの設定更新の定期的なチェックを行います。次の図は、その仕組みを示しています。

開始する前に

AWS AppConfig エージェント Lambda 拡張機能を有効にする前に、次の操作を行います。

AWS AppConfig エージェント Lambda 拡張機能の追加

AWS AppConfig エージェント Lambda 拡張機能を使用するには、拡張機能を Lambda に追加する必要があります。これは、 AWS AppConfig エージェント Lambda 拡張機能を Lambda 関数にレイヤーとして追加するか、Lambda 関数で拡張機能をコンテナイメージとして有効にすることで実行できます。

レイヤーと AWS AppConfig ARN を使用してエージェント Lambda 拡張機能を追加します。

AWS AppConfig エージェント Lambda 拡張機能を使用するには、拡張機能をレイヤーとして Lambda 関数に追加します。関数にレイヤーを追加する方法については、「AWS Lambda デベロッパーガイド」の「拡張機能の設定」を参照してください。 AWS Lambda コンソールの拡張機能の名前は AWS-AppConfig-Extension です。また、拡張機能を Lambda にレイヤーとして追加する場合は、Amazon リソースネーム (ARN) を指定する必要があることにも注意してください。プラットフォームと Lambda を作成した AWS リージョン 場所に対応する次のいずれかのリストから ARN を選択します。

拡張機能を関数に追加する前にテストする場合は、次のコード例を使用して拡張機能が機能することを確認できます。

import urllib.request
                

def lambda_handler(event, context):
    url = f'http://localhost:2772/applications/application_name/environments/environment_name/configurations/configuration_name'
    config = urllib.request.urlopen(url).read()
    return config

これをテストするには、Python 用の新しい Lambda 関数を作成し、拡張機能を追加して Lambda 関数を実行します。Lambda 関数を実行すると、Lambda AWS AppConfig 関数は http://localhost:2772 パスに指定した設定を返します。Lambda 関数の作成については、「AWS Lambda デベロッパーガイド」の「コンソールで Lambda の関数の作成」を参照してください。

AWS AppConfig エージェント Lambda 拡張機能をコンテナイメージとして追加するには、「」を参照してくださいコンテナイメージを使用して AWS AppConfig エージェント Lambda 拡張機能を追加する。

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

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

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

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

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

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

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

"header: value"

機能フラグ設定から 1 つ以上のフラグを取得する

機能フラグ設定 (AWS.AppConfig.FeatureFlags タイプの設定) の場合、Lambda 拡張機能を使用すると、設定内の単一のフラグまたはフラグのサブセットを取得できます。1 つまたは 2 つのフラグを取得すると、Lambda で設定プロファイルからいくつかのフラグのみを使用する必要がある場合に便利です。次の例では Python を使用しています。

ローカル HTTP エンドポイントから AWS AppConfig 設定データを取得できます。特定のフラグまたはフラグのリストにアクセスするには、?flag=flag_name 設定プロファイルの AWS AppConfig クエリパラメータを使用します。

1 つのフラグとその属性にアクセスする方法

import urllib.request

def lambda_handler(event, context):
    url = f'http://localhost:2772/applications/application_name/environments/environment_name/configurations/configuration_name?flag=flag_name'
    config = urllib.request.urlopen(url).read()
    return config

複数のフラグとその属性にアクセスする方法

import urllib.request

def lambda_handler(event, context):
    url = f'http://localhost:2772/applications/application_name/environments/environment_name/configurations/configuration_name?flag=flag_name_one&flag=flag_name_two'
    config = urllib.request.urlopen(url).read()
    return config

AWS AppConfig エージェント Lambda 拡張機能ログの表示

AWS AppConfig エージェント Lambda 拡張機能の AWS Lambda ログデータは、 ログで表示できます。ログエントリの先頭には が付きますappconfig agent。以下に例を示します。

[appconfig agent] 2024/05/07 04:19:01 ERROR retrieve failure for 'SourceEventConfig:SourceEventConfigEnvironment:SourceEventConfigProfile': StartConfigurationSession: api error AccessDenied: User: arn:aws:sts::0123456789:assumed-role/us-east-1-LambdaRole/extension1 is not authorized to perform: sts:AssumeRole on resource: arn:aws:iam::0123456789:role/test1 (retry in 60s)