本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# （選用） 使用環境變數來設定 AWS AppConfig Agent for Amazon ECS 和 Amazon EKS
<a name="appconfig-integration-containers-agent-configuring"></a>

您可以變更 AWS AppConfig 代理程式容器的下列環境變數來設定代理程式。

**注意**  
下表包含**範例值**欄。根據您的監視器解析度，您可能需要捲動至資料表底部，然後向右捲動以檢視資料欄。


****  

| 環境變數 | 詳細資訊 | 預設值 | 範例值 (s) | 
| --- | --- | --- | --- | 
|  `ACCESS_TOKEN`  |  此環境變數定義從代理程式 HTTP 伺服器請求組態資料時必須提供的字符。字符的值必須在 HTTP 請求授權標頭中設定，授權類型為 `Bearer`。請見此處範例。 <pre>GET /applications/my_app/...<br />                  Host: localhost:2772<br />                  Authorization: Bearer <token value></pre>  | 無 | MyAccessToken | 
|  `BACKUP_DIRECTORY`  |  此環境變數可讓 AWS AppConfig 客服人員將擷取的每個組態備份儲存至指定的目錄。  備份到磁碟的組態不會加密。如果您的組態包含敏感資料， AWS AppConfig 建議您使用檔案系統許可來實作最低權限原則。如需詳細資訊，請參閱[中的安全性 AWS AppConfig](appconfig-security.md)。   | 無 | /path/to/backups | 
|  `HTTP_PORT`  |  此環境變數會指定代理程式 HTTP 伺服器執行所在的連接埠。  | 2772 | 2772 | 
|  `HTTP_HOST`  |  HTTP\$1HOST 變數控制 AWS AppConfig 代理程式如何繫結至網路介面。繫結行為會根據執行時間環境而有所不同，以確保最佳的安全性和可存取性。  |   ECS、EKS  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/appconfig/latest/userguide/appconfig-integration-containers-agent-configuring.html) EC2 和內部部署 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/appconfig/latest/userguide/appconfig-integration-containers-agent-configuring.html)  |  自訂組態選項。您可以使用這些值覆寫預設行為： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/appconfig/latest/userguide/appconfig-integration-containers-agent-configuring.html)  | 
|  `LOG_LEVEL`  |  此環境變數會指定代理程式所記錄的詳細資訊層級。每個關卡都包含目前關卡和所有更高關卡。此值不區分大小寫。從最詳細到最不詳細，日誌層級為：`trace`、`debug`、`info`、`warn`、`fatal`、 `error`和 `none`。`trace` 日誌包含有關代理程式的詳細資訊，包括時間資訊。  |  info  |  追蹤 偵錯 info 警告 error 嚴重 無  | 
|  `LOG_PATH`  |  寫入日誌的磁碟位置。如果未指定，日誌會寫入 stderr。  |  無  | /path/to/logs/agent.log | 
|  `MANIFEST`  |  此環境變數會設定 AWS AppConfig 代理程式，以利用其他每個組態的功能，例如多帳戶擷取，並將組態儲存至磁碟。如需這些功能的詳細資訊，請參閱[使用資訊清單來啟用其他擷取功能](appconfig-agent-how-to-use-additional-features.md)。  | 無 | 使用 AWS AppConfig 組態做為資訊清單時：`MyApp:MyEnv:MyManifestConfig`。從磁碟載入資訊清單時： `file:/path/to/manifest.json` | 
|  `MAX_CONNECTIONS`  |  此環境變數會設定代理程式用來從中擷取組態的連線數目上限 AWS AppConfig。  | 3 | 3 | 
|  `POLL_INTERVAL`  |  此環境變數控制代理程式輪詢 AWS AppConfig 更新組態資料的頻率。您可以指定間隔的秒數。您也可以指定具有時間單位的數字：秒為 s，分鐘為 m，小時為 h。如果未指定單位，代理程式預設為秒。例如，60、60 和 1 公尺會產生相同的輪詢間隔。  | 45 秒 | 4545 秒5m1 小時 | 
|  `PREFETCH_LIST`  |  此環境變數會指定代理程式啟動 AWS AppConfig 時從中請求的組態資料。逗號分隔清單中可能會提供多個組態識別符。  | 無 | MyApp：MyEnv：MyConfigabcd123：efgh456：ijkl789MyApp：MyEnv：Config1，MyApp：MyEnv：Config2 | 
|  `PRELOAD_BACKUPS`  |  如果設定為 `true`， AWS AppConfig 代理程式會將 中找到的組態備份載入`BACKUP_DIRECTORY`記憶體，並立即檢查服務是否存在較新的版本。如果設定為 `false`， AWS AppConfig 代理程式只會在無法從服務擷取組態資料時從組態備份載入內容，例如您的網路發生問題時。  | true | true false  | 
| PROXY\$1HEADERS | 此環境變數會指定PROXY\$1URL環境變數中參考的代理所需的標頭。值是以逗號分隔的標頭清單。 | 無 |  標頭：值 h1：v1、h2：v2  | 
| PROXY\$1URL | 此環境變數會指定代理程式連線所用的代理 URL AWS 服務，包括支援 AWS AppConfigHTTPS和 HTTP URL。 URLs  | 無 | http：//localhost：7474https://my-proxy.example.com | 
|  `REQUEST_TIMEOUT`  |  此環境變數控制代理程式等待回應的時間量 AWS AppConfig。如果服務未回應，請求會失敗。 如果請求是用於初始資料擷取，代理程式會傳回錯誤到您的應用程式。 如果在背景檢查更新的資料期間發生逾時，代理程式會記錄錯誤，並在短暫延遲後再次嘗試。 您可以指定逾時的毫秒數。您也可以指定具有時間單位的數字：毫秒為 毫秒，秒為 。如果未指定單位，代理程式預設為毫秒。例如，5000、5000ms 和 5s 會產生相同的請求逾時值。  | 3000 毫秒 | 30003000 毫秒5 秒 | 
| ROLE\$1ARN | 此環境變數會指定 IAM 角色的 Amazon Resource Name (ARN)。 AWS AppConfig Agent 會擔任此角色來擷取組態資料。 | 無 | arn：aws：iam：：123456789012：role/MyRole | 
| ROLE\$1EXTERNAL\$1ID | 此環境變數會指定要與擔任的角色 ARN 搭配使用的外部 ID。 | 無 | MyExternalId | 
| ROLE\$1SESSION\$1NAME | 此環境變數會指定要與擔任 IAM 角色的登入資料建立關聯的工作階段名稱。 | 無 | AWSAppConfigAgentSession | 
| SERVICE\$1REGION | 此環境變數指定 AWS 區域 代理程式用來呼叫 AWS AppConfig 服務的替代方案 AWS AppConfig 。如果未定義，代理程式會嘗試判斷目前的區域。如果無法啟動，則代理程式無法啟動。 | 無 | us-east-1eu-west-1 | 
|  `WAIT_ON_MANIFEST`  |  此環境變數會將 AWS AppConfig 代理程式設定為等到資訊清單處理完畢，再完成啟動。  | true | truefalse |