設定 AWS AppConfig 代理程式 Lambda 延伸 - AWS AppConfig

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

設定 AWS AppConfig 代理程式 Lambda 延伸

您可以透過變更下列 AWS Lambda 環境變數來設定擴充功能。如需詳細資訊，請參閱AWS Lambda 開發人員指南中的使用 AWS Lambda 環境變數。

預取組態資料

環境變數AWS_APPCONFIG_EXTENSION_PREFETCH_LIST可以改善函數的啟動時間。初始化 AWS AppConfig 代理程式 Lambda 延伸模組時，它會 AWS AppConfig 在 Lambda 開始初始化函數並叫用您的處理常式之前，擷取指定的組態。在某些情況下，在函數請求之前，配置數據已經在本地緩存中可用。

若要使用預先擷取功能，請將環境變數的值設定為對應於組態資料的路徑。例如，如果您的配置對應於分別名為「我的應用程序」，「我的 _ 環境」和「my_config」的應用程序，環境和配置配置文件，則路徑將是。/applications/my_application/environments/my_environment/configurations/my_configuration_data您可以將多個組態項目列為逗號分隔清單來指定多個組態項目 (如果您的資源名稱包含逗號，請使用資源的 ID 值而非名稱)。

從其他帳戶存取組態資料

AWS AppConfig 代理程式 Lambda 延伸模組可透過指定授與資料權限的IAM角色，從另一個帳戶擷取組態資料。若要進行設定，請依照下列步驟執行：

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

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

  3. (選擇性) 如有需要，可以使用AWS_APPCONFIG_EXTENSION_ROLE_EXTERNAL_ID環境變數指定外部 ID。同樣地，可以使用AWS_APPCONFIG_EXTENSION_ROLE_SESSION_NAME環境變數來配置工作階段名稱。

注意

記下以下資訊。

  • AWS AppConfig 代理程式 Lambda 擴充功能只能從一個帳戶擷取資料。如果您指定IAM角色，擴充功能將無法從執行 Lambda 函數的帳戶擷取組態資料。

  • AWS Lambda 使用 Amazon CloudWatch 日誌記錄 AWS AppConfig 代理程式 Lambda 延伸模組和 Lambda 函數的相關資訊。

環境變數 詳細資訊 預設值

AWS_APPCONFIG_EXTENSION_HTTP_PORT

此環境變數指定主控擴充功能的本機HTTP伺服器執行所在的連接埠。

 2772

AWS_APPCONFIG_EXTENSION_LOG_LEVEL

此環境變數指定要針對 AWS AppConfig 某個函數傳送至 Amazon Logs 的延伸特定 CloudWatch 日誌。有效且不區分大小寫的值為：debug、info、warnerror、和。none調試包括有關擴展程序的詳細信息，包括計時信息。

info

AWS_APPCONFIG_EXTENSION_MAX_CONNECTIONS

此環境變數會設定延伸模組用來擷取組態的連線數目上限。 AWS AppConfig

 3

AWS_APPCONFIG_EXTENSION_POLL_INTERVAL_SECONDS

此環境變數可控制擴充功能輪詢更新組態的頻率 (以秒 AWS AppConfig 為單位)。

 45

AWS_APPCONFIG_EXTENSION_POLL_TIMEOUT_MILLIS

此環境變數控制重新整理快取中的資料時，擴充功能會等待回應的最大 AWS AppConfig 時間量 (以毫秒為單位)。如果在指定的時間量內 AWS AppConfig 沒有回應，擴充功能會略過此輪詢間隔，並傳回先前更新的快取資料。

 3000

AWS_APPCONFIG_EXTENSION_PREFETCH_LIST

此環境變數會指定擴充功能在函數初始化並執行處理常式之前開始擷取的組態資料。它可以顯著減少功能的冷啟動時間。

 無
AWS_APPCONFIG_EXTENSION_PROXY_HEADERS 此環境變數會指定環AWS_APPCONFIG_EXTENSION_PROXY_URL境變數中參照之 Proxy 所需的標頭。該值是以逗號分隔的標頭清單。每個標題使用以下形式：
"header: value"
 無
AWS_APPCONFIG_EXTENSION_PROXY_URL 此環境變數指定URL要用於從 AWS AppConfig 延伸至的連線的 Proxy AWS 服務。 HTTPS並得HTTPURLs到支持。 無
AWS_APPCONFIG_EXTENSION_ROLE_ARN 此環境變數會指定ARN對應IAM角色的角色，該角色應由 AWS AppConfig 延伸模組假定以擷取組態。 無
AWS_APPCONFIG_EXTENSION_ROLE_EXTERNAL_ID 此環境變數會指定要與假定角色搭配使用的外部 ID ARN。 無
AWS_APPCONFIG_EXTENSION_ROLE_SESSION_NAME 此環境變數會指定要與假定IAM角色之認證相關聯的工作階段名稱。 無
AWS_APPCONFIG_EXTENSION_SERVICE_REGION 此環境變數會指定擴充功能用來呼叫 AWS AppConfig 服務的替代區域。未定義時，擴充功能會使用目前「區域」中的端點。 無

AWS_APPCONFIG_EXTENSION_MANIFEST

此環境變數會設定 AWS AppConfig 代理程式，以利用額外的每個組態功能，例如多帳戶擷取，以及將組態儲存至磁碟。您可以輸入下列其中一個值：

  • "app:env:manifest-config"

  • "file:/fully/qualified/path/to/manifest.json"

如需這些功能的詳細資訊，請參閱使用資訊清單啟用其他擷取功能。

 true

AWS_APPCONFIG_EXTENSION_WAIT_ON_MANIFEST

此環境變數會設定 AWS AppConfig 代理程式等到資訊清單處理完成後才完成啟動。

 true