Amazon EC2およびオンプレミスマシンでの AWS AppConfig Agent の使用

AWS AppConfig エージェントを使用して、Amazon Elastic Compute Cloud (Amazon EC2) Linux インスタンスで実行されているアプリケーション AWS AppConfig と統合できます。エージェントは、次の方法でアプリケーションの処理と管理を強化します。

*AWS AppConfig エージェントは、サービスが設定データを初めて取得したときにデータをキャッシュします。このため、データを取得する最初の呼び出しは、それ以降の呼び出しよりも時間がかかります。

ステップ 1: (必須) リソースの作成と権限の設定

Amazon EC2インスタンスで実行されているアプリケーション AWS AppConfig と統合するには、特徴量フラグやフリーフォーム設定データを含む AWS AppConfig アーティファクトと設定データを作成する必要があります。詳細については、「で機能フラグとフリーフォーム設定データを作成する AWS AppConfig」を参照してください。

がホストする設定データを取得するには AWS AppConfig、アプリケーションが AWS AppConfig データプレーンへのアクセスで設定されている必要があります。アプリケーションにアクセスを許可するには、Amazon EC2インスタンスロールに割り当てられたIAMアクセス許可ポリシーを更新します。具体的には、 appconfig:StartConfigurationSession と appconfig:GetLatestConfiguration ポリシーにとアクションを追加する必要があります。以下がその例です。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "appconfig:StartConfigurationSession",
                "appconfig:GetLatestConfiguration"
            ],
            "Resource": "*"
        }
    ]
}

ポリシーへのアクセス許可の追加の詳細については、IAM「 ユーザーガイド」のIAM「ID アクセス許可の追加と削除」を参照してください。

ステップ 2: (必須) Amazon EC2インスタンスでの AWS AppConfig エージェントのインストールと起動

AWS AppConfig エージェントは、 によって管理される Amazon Simple Storage Service (Amazon S3) バケットでホストされます AWS。Linuxインスタンスで最新バージョンの エージェントをダウンロードしてインストールするには、次の手順を使用します。アプリケーションが複数のインスタンスに分散されている場合は、アプリケーションをホストする各インスタンスでこの手順を実行する必要があります。

sudo systemctl stop aws-appconfig-agent

ステップ 3: (オプションですが推奨) ログファイルを CloudWatch ログに送信する

デフォルトでは、 AWS AppConfig Agent はログを に発行しますSTDERR。Systemd は、Linux STDERR インスタンスで実行されているすべてのサービスの STDOUTと を systemd ジャーナルにリダイレクトします。 AWS AppConfig エージェントを 1 つまたは 2 つのインスタンスでのみ実行している場合は、Systemd ジャーナルのログデータを表示および管理できます。分散アプリケーションに強く推奨されるより良いソリューションとして、ログファイルをディスクに書き込み、Amazon CloudWatch エージェントを使用してログデータを AWS クラウドにアップロードします。さらに、インスタンスから古いログファイルを削除するように CloudWatch エージェントを設定できます。これにより、インスタンスのディスク容量が不足しなくなります。

ディスクへのロギングを有効にするには、 LOG_PATH で説明されているように「ステップ 4: (オプション) 環境変数を使用して AWS AppConfig Agent for Amazon を設定する EC2」環境変数を設定する必要があります。

CloudWatch エージェントの使用を開始するには、「Amazon ユーザーガイド」の「Amazon EC2インスタンスとオンプレミスサーバーから CloudWatch エージェントを使用してメトリクスとログを収集する」を参照してください。 CloudWatch Systems Manager の一機能であるクイックセットアップを使用して、 CloudWatch エージェントをすばやくインストールできます。詳細については、AWS Systems Manager ユーザーガイドの Quick Setup Host Managementを参照してください。

エージェントをインスタンス CloudWatch にインストールしたら、 CloudWatch エージェント設定ファイルを作成します。設定ファイルは、 CloudWatch エージェントログファイルの操作方法を AWS AppConfig エージェントに指示します。 CloudWatch エージェント設定ファイルの作成の詳細については、 CloudWatch 「 エージェント設定ファイルの作成」を参照してください。

次のlogsセクションをインスタンスの CloudWatch エージェント設定ファイルに追加し、変更を保存します。

"logs": {
  "logs_collected": {
    "files": {
      "collect_list": [
        {
          "file_path": "/path_you_specified_for_logging",
          "log_group_name": "${YOUR_LOG_GROUP_NAME}/aws-appconfig-agent.log",
          "auto_removal": true
        },
        ...
      ]
    },
    ...
  },
  ...
}

の値が の場合auto_removaltrue、 CloudWatch エージェントはローテーションされた AWS AppConfig エージェントログファイルを自動的に削除します。

ステップ 4: (オプション) 環境変数を使用して AWS AppConfig Agent for Amazon を設定する EC2

AWS AppConfig Agent for Amazon は、環境変数EC2を使用して設定できます。systemd サービスの環境変数を設定するには、ドロップインユニットファイルを作成します。次の例は、ドロップインユニットファイルを作成して AWS AppConfig エージェントのログ記録レベルを に設定する方法を示していますDEBUG。

AWS AppConfig Agent for Amazon は、ドロップインユニットファイルで次の環境変数を指定EC2することで設定できます。

GET /applications/my_app/...
                  Host: localhost:2772
                  Authorization: Bearer <token value>

"header: value"

ステップ 5: (必須) 設定データの取得

HTTP ローカルホストコールを使用して、 AWS AppConfig エージェントから設定データを取得できます。次の例は、 HTTP クライアントcurlで を使用します。アプリケーション言語または を含む使用可能なライブラリでサポートされている使用可能なHTTPクライアントを使用して、 エージェントを呼び出すことができます AWS SDK。

デプロイされた設定内容をすべて取得するには

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

AWS AppConfig タイプの Feature Flag 設定から個々のフラグとその属性を取得します。

$ curl "http://localhost:2772/applications/application_name/environments/environment_name/configurations/configuration_name?flag=flag_name"

AWS AppConfig タイプの Feature Flag 設定から複数のフラグとその属性にアクセスします。

$ curl "http://localhost:2772/applications/application_name/environments/environment_name/configurations/configuration_name?flag=flag_name_one&flag=flag_name_two"

ステップ 6 (オプション、推奨): AWS AppConfig エージェントの更新を自動化する

AWS AppConfig エージェントは定期的に更新されます。インスタンスで最新バージョンの AWS AppConfig エージェントを実行していることを確認するには、Amazon EC2 ユーザーデータに次のコマンドを追加することをお勧めします。コマンドは、インスタンスまたは EC2 Auto Scaling グループのユーザーデータに追加できます。このスクリプトは、インスタンスが起動または再起動するたびに、最新バージョンのエージェントをインストールして起動します。

#!/bin/bash
# install the latest version of the agent
yum install -y https://s3.amazonaws.com/aws-appconfig-downloads/aws-appconfig-agent/linux/x86_64/latest/aws-appconfig-agent.rpm
# optional: configure the agent
mkdir /etc/systemd/system/aws-appconfig-agent.service.d
echo "${MY_AGENT_CONFIG}" > /etc/systemd/system/aws-appconfig-agent.service.d/overrides.conf 
systemctl daemon-reload
# start the agent
systemctl start aws-appconfig-agent