設定 Agent Lambda 延伸模組 AWS AppConfig

您可以變更下列 AWS Lambda 環境變數來設定延伸模組。如需詳細資訊，請參閱《 AWS Lambda 開發人員指南》中的使用 AWS Lambda 環境變數。

預先擷取組態資料

環境變數AWS_APPCONFIG_EXTENSION_PREFETCH_LIST可以改善函數的啟動時間。初始化 AWS AppConfig Agent Lambda 延伸模組時，它會在 Lambda 開始初始化函數並叫用處理常式 AWS AppConfig 之前，從 擷取指定的組態。在某些情況下，組態資料在函式請求之前已在本機快取中可用。

若要使用預先擷取功能，請將環境變數的值設定為對應於您組態資料的路徑。例如，如果您的組態對應至分別名為 "my_application"、"my_environment" 和 "my_configuration_data" 的應用程式、環境和組態設定檔，則路徑將為 /applications/my_application/environments/my_environment/configurations/my_configuration_data。您可以透過將多個組態項目列出為逗號分隔清單來指定它們 （如果您的資源名稱包含逗號，請使用資源的 ID 值，而不是其名稱）。

從另一個帳戶存取組態資料

AWS AppConfig Agent Lambda 延伸模組可以透過指定授予資料許可的 IAM 角色，從另一個帳戶擷取組態資料。若要設定，請依照下列步驟進行：

1. 在 AWS AppConfig 用於管理組態資料的帳戶中，建立具有信任政策的角色，以授予執行 Lambda 函數的帳戶存取 appconfig:StartConfigurationSession和 appconfig:GetLatestConfiguration動作，以及對應至 AWS AppConfig 組態資源的部分或完整 ARNs。

2. 在執行 Lambda 函數的帳戶中，使用步驟 1 中建立的角色 ARN 將AWS_APPCONFIG_EXTENSION_ROLE_ARN環境變數新增至 Lambda 函數。

3. （選用） 如有需要，可以使用 AWS_APPCONFIG_EXTENSION_ROLE_EXTERNAL_ID環境變數指定外部 ID。同樣地，可以使用 AWS_APPCONFIG_EXTENSION_ROLE_SESSION_NAME環境變數來設定工作階段名稱。

注意

記下以下資訊。

• AWS AppConfig Agent Lambda 延伸模組只能從一個帳戶擷取資料。如果您指定 IAM 角色，延伸模組將無法從執行 Lambda 函數的帳戶擷取組態資料。

• AWS Lambda 會使用 Amazon CloudWatch Logs 記錄有關 AWS AppConfig Agent Lambda 延伸模組和 Lambda 函數的資訊。

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

環境變數	詳細資訊	預設值	範例值
AWS_APPCONFIG_EXTENSION_HTTP_PORT	此環境變數會指定託管擴充功能的本機 HTTP 伺服器執行所在的連接埠。	2772	2772
AWS_APPCONFIG_EXTENSION_LOG_LEVEL	此環境變數會指定代理程式記錄的詳細資訊層級。每個關卡都包含目前關卡和所有更高關卡。值不區分大小寫。從最詳細到最不詳細，日誌層級為：trace、debug、info、warn、error、 fatal和 none。trace 日誌包含有關代理程式的詳細資訊，包括計時資訊。	info	追蹤 偵錯 info 警告 error 嚴重 無
AWS_APPCONFIG_EXTENSION_MAX_CONNECTIONS	此環境變數會設定延伸模組用來從中擷取組態的連線數目上限 AWS AppConfig。	3	3
AWS_APPCONFIG_EXTENSION_POLL_INTERVAL_SECONDS	此環境變數控制代理程式輪詢 AWS AppConfig 更新組態資料的頻率。您可以指定間隔的秒數。您也可以指定具有時間單位的數字：秒為 s，分鐘為 m，小時為 h。如果未指定單位，代理程式預設為秒。例如，60、60 和 1 公尺會產生相同的輪詢間隔。	45	45 45 秒 5m 1 小時
AWS_APPCONFIG_EXTENSION_POLL_TIMEOUT_MILLIS	此環境變數會控制在重新整理快取中的資料 AWS AppConfig 時，延伸模組等待回應的時間上限，以毫秒為單位。如果 AWS AppConfig 未在指定的時間內回應，延伸項目會略過此輪詢間隔，並傳回先前更新的快取資料。	3000 毫秒	3000 300 毫秒 5 秒
AWS_APPCONFIG_EXTENSION_PREFETCH_LIST	此環境變數會指定代理程式在啟動 AWS AppConfig 時從中請求的組態資料。逗號分隔清單中可能會提供多個組態識別符。從 預先擷取組態資料 AWS AppConfig 可以大幅縮短函數的冷啟動時間。	無	MyApp：MyEnv：MyConfig abcd123：efgh456：ijkl789 MyApp：MyEnv：Config1，MyApp：MyEnv：Config2
AWS_APPCONFIG_EXTENSION_PROXY_HEADERS	此環境變數指定AWS_APPCONFIG_EXTENSION_PROXY_URL環境變數中參考的代理所需的標頭。值是逗號分隔的標頭清單。	無	標頭：值 h1：v1、h2：v2
AWS_APPCONFIG_EXTENSION_PROXY_URL	此環境變數會指定要用於延伸 AWS AppConfig 模組連線的代理 URL AWS 服務。支援 HTTPS和 HTTP URL。 URLs	無	http：//localhost：7474 https://my-proxy.example.com
AWS_APPCONFIG_EXTENSION_ROLE_ARN	此環境變數會指定對應至 角色的 IAM 角色 ARN，該角色應由 AWS AppConfig 延伸模組擔任以擷取組態。	無	arn：aws：iam：：123456789012：role/MyRole
AWS_APPCONFIG_EXTENSION_ROLE_EXTERNAL_ID	此環境變數會指定要與擔任的角色 ARN 搭配使用的外部 ID。	無	MyExternalId
AWS_APPCONFIG_EXTENSION_ROLE_SESSION_NAME	此環境變數會指定要與擔任 IAM 角色的登入資料建立關聯的工作階段名稱。	無	AWSAppConfigAgentSession
AWS_APPCONFIG_EXTENSION_SERVICE_REGION	此環境變數指定擴充功能應該用來呼叫 AWS AppConfig 服務的替代區域。未定義時，延伸模組會使用目前區域中的端點。	無	us-east-1 eu-west-1
AWS_APPCONFIG_EXTENSION_MANIFEST	此環境變數會設定 AWS AppConfig 代理程式，以利用其他每個組態的功能，例如多帳戶擷取，並將組態儲存至磁碟。如需這些功能的詳細資訊，請參閱使用資訊清單來啟用其他擷取功能。	無	使用 AWS AppConfig 組態做為資訊清單時：MyApp:MyEnv:MyManifestConfig。 從磁碟載入資訊清單時： file:/path/to/manifest.json
AWS_APPCONFIG_EXTENSION_WAIT_ON_MANIFEST	此環境變數會將 AWS AppConfig 代理程式設定為等待資訊清單處理完畢，再完成啟動。	true	true false