將 AWS AppConfig 代理程式搭配 Amazon EC2 和現場部署機器

您可以使用 AWS AppConfig 代理程式 AWS AppConfig 與在 Amazon 彈性運算雲端 (AmazonEC2) Linux 執行個體上執行的應用程式整合。代理程式可透過下列方式加強應用程式處理與管理：

*AWS AppConfig 代理程式會在服務第一次擷取您的組態資料時快取資料。因此，第一次檢索數據的調用比後續調用慢。

步驟 1：(必要) 建立資源和設定權限

若要 AWS AppConfig 與 Amazon EC2 執行個體上執行的應用程式整合，您必須建立成 AWS AppConfig 品和組態資料，包括功能旗標或自由格式組態資料。如需詳細資訊，請參閱在中建立特徵旗標和任意格式組態資料 AWS AppConfig。

若要擷取由託管的組態資料 AWS AppConfig，您的應用程式必須設定為具有 AWS AppConfig 資料平面的存取權。若要授予應用程式存取IAM權，請更新指派給 Amazon EC2 執行個體角色的許可政策。具體而言，您必須將appconfig:StartConfigurationSession和appconfig:GetLatestConfiguration動作新增至策略。請見此處範例：

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

如需有關新增權限至策略的詳細資訊，請參閱《IAM使用指南》中的新增和移除IAM身分識別權限。

步驟 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 代理程式會將記錄檔發佈到STDERR。Systemd 會將 Linux 執STDOUT行STDERR個體上執行的所有服務重新導向至 systemd 日誌。如果您只在一或兩個執行個體上執行 AWS AppConfig 代理程式，則可以在 systemd 日誌中檢視和管理記錄資料。更好的解決方案是我們強烈推薦用於分散式應用程式的解決方案，是將日誌檔寫入磁碟，然後使用 Amazon CloudWatch Agent 將日誌資料上傳到 AWS 雲端。此外，您可以設定 CloudWatch 代理程式刪除執行個體中的舊記錄檔，以防止執行個體磁碟空間不足。

若要啟用記錄到磁碟，您必須設定LOG_PATH環境變數，如中所述步驟 4：(選用) 使用環境變數設定 Amazon 的 AWS AppConfig 代理程式 EC2。

若要開始使用 CloudWatch 代理程式，請參閱 Amazon 使用者指南中的代理 CloudWatch 程式從 Amazon EC2 執行個體和現場部署伺服器收集 CloudWatch 指標和日誌。您可以使用「快速設定」，這是一種「Systems Manager」功能來快速安裝 CloudWatch 代理程式。如需詳細資訊，請參閱AWS Systems Manager 使用指南中的快速設定主機管理。

在執行個體上安裝 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_removal為true， CloudWatch 代理程式會自動刪除輪換的 AWS AppConfig 代理程式記錄檔。

步驟 4：(選用) 使用環境變數設定 Amazon 的 AWS AppConfig 代理程式 EC2

您可以使用環境變數為 Amazon EC2 設定 AWS AppConfig 代理程式。若要設定systemd服務的環境變數，您可以建立嵌入式單位檔案。下列範例顯示如何建立插入式單元檔案，以將 AWS AppConfig 代理程式記錄層級設定為DEBUG。

您可以在插入式單元檔案中指定下列環境變數，以設定 Amazon EC2 的 AWS AppConfig 代理程式。

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

"header: value"

步驟 5：(必要) 擷取組態資料

您可以使用HTTP本機主機呼叫，從 AWS AppConfig 代理程式擷取組態資料。下列範例會curl與用HTTP戶端搭配使用。您可以使用應用程式語言或可用程式庫支援的任何可用用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 使用者資料。您可以將這些指令新增至執行個體或「EC2Auto 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