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

# （選用） 使用環境變數來設定 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\_HOST 變數控制 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)<br />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 | 追蹤<br />偵錯<br />info<br />警告<br />error<br />嚴重<br />無 | 
| `LOG_PATH` | 寫入日誌的磁碟位置。如果未指定，日誌會寫入 stderr。 | 無 | /path/to/logs/agent.log | 
| `MANIFEST` | 此環境變數會將 AWS AppConfig 代理程式設定為利用其他每個組態功能，例如多帳戶擷取，並將組態儲存至磁碟。如需這些功能的詳細資訊，請參閱[使用資訊清單來啟用其他擷取功能](appconfig-agent-how-to-use-additional-features.md)。 | 無 | 使用 AWS AppConfig 組態做為資訊清單時：`MyApp:MyEnv:MyManifestConfig`。<br />從磁碟載入資訊清單時： `file:/path/to/manifest.json` | 
| `MAX_CONNECTIONS` | 此環境變數會設定代理程式用來從中擷取組態的連線數目上限 AWS AppConfig。 | 3 | 3 | 
| `POLL_INTERVAL` | 此環境變數控制代理程式輪詢 AWS AppConfig 更新組態資料的頻率。您可以指定間隔的秒數。您也可以指定具有時間單位的數字：秒為 s，分鐘為 m，小時為 h。如果未指定單位，代理程式預設為秒。例如，60、60 和 1 公尺會產生相同的輪詢間隔。 | 45 秒 | 45<br />45 秒<br />5m<br />1h | 
| `PREFETCH_LIST` | 此環境變數會在代理程式啟動時 AWS AppConfig 指定代理程式請求的組態資料。逗號分隔清單中可能會提供多個組態識別符。 | 無 | MyApp：MyEnv：MyConfig<br />abcd123：efgh456：ijkl789<br />MyApp：MyEnv：Config1，MyApp：MyEnv：Config2 | 
| `PRELOAD_BACKUPS` | 如果設定為 `true`， AWS AppConfig 代理程式會將 中找到的組態備份載入`BACKUP_DIRECTORY`記憶體，並立即檢查服務是否存在較新的版本。如果設定為 `false`， AWS AppConfig 代理程式只會在無法從服務擷取組態資料時從組態備份載入內容，例如您的網路發生問題時。 | true | true<br />false | 
| PROXY\_HEADERS | 此環境變數會指定PROXY\_URL環境變數中參考的代理所需的標頭。值是以逗號分隔的標頭清單。 | 無 | 標頭：值<br />h1：v1、h2：v2 | 
| PROXY\_URL | 此環境變數會指定代理程式連線所用的代理 URL AWS 服務，包括支援 AWS AppConfigHTTPS和 HTTP URL。 URLs  | 無 | http：//localhost：7474<br />https://my-proxy.example.com | 
| `REQUEST_TIMEOUT` | 此環境變數控制代理程式等待回應的時間長度 AWS AppConfig。如果服務未回應，請求會失敗。<br />如果請求是用於初始資料擷取，代理程式會傳回錯誤到您的應用程式。<br />如果在更新資料的背景檢查期間發生逾時，代理程式會記錄錯誤，並在短暫延遲後重試。<br />您可以指定逾時的毫秒數。您也可以指定具有時間單位的數字：毫秒為 毫秒，秒為 。如果未指定單位，代理程式預設為毫秒。例如，5000、5000ms 和 5s 會產生相同的請求逾時值。 | 3000 毫秒 | 3000<br />3000 毫秒<br />5 秒 | 
| ROLE\_ARN | 此環境變數會指定 IAM 角色的 Amazon Resource Name (ARN)。 AWS AppConfig Agent 會擔任此角色來擷取組態資料。 | 無 | arn：aws：iam：：123456789012：role/MyRole | 
| ROLE\_EXTERNAL\_ID | 此環境變數會指定要與擔任的角色 ARN 搭配使用的外部 ID。 | 無 | MyExternalId | 
| ROLE\_SESSION\_NAME | 此環境變數會指定要與擔任 IAM 角色的登入資料建立關聯的工作階段名稱。 | 無 | AWSAppConfigAgentSession | 
| SERVICE\_REGION | 此環境變數指定 AWS 區域 代理程式用來呼叫 AWS AppConfig 服務的替代方案 AWS AppConfig 。如果未定義，代理程式會嘗試判斷目前的區域。如果無法啟動，則代理程式無法啟動。 | 無 | us-east-1<br />eu-west-1 | 
| `WAIT_ON_MANIFEST` | 此環境變數會將 AWS AppConfig 代理程式設定為等到資訊清單處理完畢，再完成啟動。 | true | true<br />false |