AWS AppConfig エージェントローカル開発モードの使用

AWS AppConfig エージェントはローカル開発モード をサポートします。ローカル開発モードを有効にすると、エージェントはディスク上の指定されたディレクトリから設定データを読み取ります。から設定データを取得しません AWS AppConfig。指定したディレクトリ内のファイルを更新することで、設定のデプロイをシミュレートできます。次のユースケースでは、ローカル開発モードをお勧めします。

• を使用してデプロイする前に、さまざまな設定バージョンをテストします AWS AppConfig。

• コードリポジトリに変更をコミットする前に、新機能のさまざまな設定オプションをテストします。

• さまざまな設定シナリオをテストして、期待どおりに動作することを確認します。

警告

本番環境ではローカル開発モードを使用しないでください。このモードは、デプロイの検証や自動ロールバックなどの重要な AWS AppConfig 安全機能をサポートしていません。

エージェントをローカル開発モードに設定する AWS AppConfig には、次の手順に従います。

AWS AppConfig エージェントをローカル開発モードに設定するには

1. コンピューティング環境で説明されている方法を使用して エージェントをインストールします。 AWS AppConfig エージェントは次の で動作します AWS のサービス。

   • AWS Lambda

   • Amazon EC2

   • Amazon ECS と Amazon EKS

2. エージェントが実行中の場合は、停止します。

3. 環境変数のリストLOCAL_DEVELOPMENT_DIRECTORYに を追加します。読み取りアクセス許可をエージェントに提供するファイルシステム上のディレクトリを指定します。例えば、/tmp/local_configs と指定します。

4. ディレクトリに ファイルを作成します。ファイル名は次の形式を使用する必要があります。

   application_name:environment_name:configuration_profile_name

   以下がその例です。

   Mobile:Development:EnableMobilePaymentsFeatureFlagConfiguration

   注記

   （オプション) 指定した拡張子に基づいて、エージェントが設定データに対して返すコンテンツタイプを制御できます。例えば、ファイルに .json 拡張子を付けると、アプリケーションがリクエストapplication/jsonしたときにエージェントはコンテンツタイプ を返します。拡張機能を省略すると、エージェントはコンテンツタイプapplication/octet-streamに を使用します。正確な制御が必要な場合は、 形式で拡張機能を提供できます.type%subtype。エージェントはコンテンツタイプ を返します.type/subtype。

5. 次のコマンドを実行してエージェントを再起動し、設定データをリクエストします。

   curl http://localhost:2772/applications/application_name/environments/environment_name/configurations/configuration_name

エージェントは、エージェントに指定されたポーリング間隔でローカルファイルへの変更をチェックします。ポーリング間隔が指定されていない場合、エージェントはデフォルトの間隔である 45 秒を使用します。ポーリング間隔でのこのチェックにより、エージェントはローカル開発環境で、 AWS AppConfig サービスとやり取りするように設定されたときと同じように動作します。

注記

ローカル開発設定ファイルの新しいバージョンをデプロイするには、新しいデータでファイルを更新します。