使用 AWS AppConfig 代理程式 Lambda 延伸模組擷取組態

AWS Lambda 擴充功能是增強 Lambda 函數功能的伴隨程序。擴展可以在調用函數之前啟動，與函數 parallel 運行，並在處理函數調用後繼續運行。實質上，Lambda 擴充功能就像是與 Lambda 叫用 parallel 執行的用戶端。此平行用戶端可在其生命週期中的任何時間點與您的功能連接。

如果您在 Lambda 函數中使用 AWS AppConfig 功能旗標或其他動態組態資料，建議您將 AWS AppConfig 代理程式 Lambda 延伸模組新增為 Lambda 函數的層。這使得調用功能標誌更簡單，擴展本身包括簡化使用， AWS AppConfig 同時降低成本的最佳實踐。由於對 AWS AppConfig 服務的 API 呼叫次數減少，並縮短 Lambda 函數處理時間，可降低成本。如需 Lambda 擴充的詳細資訊，請參閱AWS Lambda 開發人員指南中的 Lambda 擴充功能

本主題包括 AWS AppConfig 代理程式 Lambda 延伸模組的相關資訊，以及如何設定擴充功能以使用 Lambda 函數的程序。

運作方式

如果您使 AWS AppConfig 用不含 Lambda 擴充功能的 Lambda 函數管理組態，則必須將 Lambda 函數設定為透過與StartConfigurationSession和 GetLatestConfigurationAPI 動作整合來接收組態更新。

將 AWS AppConfig 代理程式 Lambda 延伸模組與 Lambda 函數整合，可簡化此程序 擴充功能負責呼叫 AWS AppConfig 服務、管理擷取資料的本機快取、追蹤下一次服務呼叫所需的組態 Token，以及定期在背景中檢查組態更新。下圖顯示了它是如何工作的。

開始之前

啟用 AWS AppConfig 代理程式 Lambda 延伸模組之前，請執行下列動作：

新增 AWS AppConfig 代理程式 Lambda 延伸

若要使用 AWS AppConfig 代理程式 Lambda 延伸模組，您需要將擴充功能新增至您的 Lambda。這可以透過將 AWS AppConfig 代理程式 Lambda 延伸模組新增至 Lambda 函數作為層，或在 Lambda 函數上啟用擴充功能做為容器映像來完成。

使用層和 ARN 新增 AWS AppConfig 代理程式 Lambda 延伸模組

若要使用 AWS AppConfig 代理程式 Lambda 延伸模組，您可以將擴充功能新增至 Lambda 函數做為一個層。有關如何向函數添加圖層的詳細信息，請參閱AWS Lambda 開發人員指南中的配置擴展。 AWS Lambda 控制台中擴展名的名稱是 AWS AppConfig-擴展名。另請注意，當您將擴充功能新增為 Lambda 的層時，必須指定 Amazon 資源名稱 (ARN)。從下列其中一個與平台對應的清單中選擇 ARN，以及您建立 Lambda 的 AWS 區域 位置。

如果您想在將擴充功能新增至函式之前先測試擴充功能，您可以使用下列程式碼範例來驗證其運作正常。

import urllib.request
                

def lambda_handler(event, context):
    url = f'http://localhost:2772/applications/application_name/environments/environment_name/configurations/configuration_name'
    config = urllib.request.urlopen(url).read()
    return config

要對其進行測試，請為 Python 創建一個新的 Lambda 函數，添加擴展名，然後運行 Lambda 函數。執行 Lambda 函數之後， AWS AppConfig Lambda 函數會傳回您為 http://localhost:2772 路徑指定的組態。如需建立 Lambda 函數的詳細資訊，請參閱AWS Lambda 開發人員指南中的使用主控台建立 Lambda 函數。

若要將 AWS AppConfig 代理程式 Lambda 延伸模組新增為容器映像檔，請參閱使用容器映像檔新增 AWS AppConfig 代理程式 Lambda 延伸模組。

設定 AWS AppConfig 代理程式 Lambda 延伸

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

預取組態資料

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

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

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

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

"header: value"

從功能旗標組態擷取一或多個旗標

對於功能旗標組態 (類型的組態AWS.AppConfig.FeatureFlags)，Lambda 擴充功能可讓您擷取組態中的單一旗標或旗標子集。如果 Lambda 只需要使用組態設定檔中的幾個旗標，擷取一或兩個旗標就很有用。下面的實例使用 Python。

您可以從本機 HTTP 端點擷取 AWS AppConfig 組態資料。若要存取特定旗標或旗標清單，請使用 AWS AppConfig 組態設定檔的 ?flag=flag_name query 參數。

若要存取單一旗標及其屬性

import urllib.request

def lambda_handler(event, context):
    url = f'http://localhost:2772/applications/application_name/environments/environment_name/configurations/configuration_name?flag=flag_name'
    config = urllib.request.urlopen(url).read()
    return config

若要存取多個旗標及其屬性

import urllib.request

def lambda_handler(event, context):
    url = f'http://localhost:2772/applications/application_name/environments/environment_name/configurations/configuration_name?flag=flag_name_one&flag=flag_name_two'
    config = urllib.request.urlopen(url).read()
    return config

檢視 AWS AppConfig 代理程式 Lambda 延伸

您可以在記錄中檢視 AWS AppConfig 代理程式 Lambda 延伸模組的 AWS Lambda 記錄資料。記錄項目前面加上。appconfig agent範例如下。

[appconfig agent] 2024/05/07 04:19:01 ERROR retrieve failure for 'SourceEventConfig:SourceEventConfigEnvironment:SourceEventConfigProfile': StartConfigurationSession: api error AccessDenied: User: arn:aws:sts::0123456789:assumed-role/us-east-1-LambdaRole/extension1 is not authorized to perform: sts:AssumeRole on resource: arn:aws:iam::0123456789:role/test1 (retry in 60s)