AWS IoT Greengrass Version 1 於 2023 年 6 月 30 日進入延長壽命階段。如需詳細資訊，請參閱 AWS IoT Greengrass V1 維護政策 。在此日期之後， AWS IoT Greengrass V1 不會發佈提供功能、增強功能、錯誤修正或安全修補程式的更新。在 上執行的裝置 AWS IoT Greengrass V1 不會中斷，並會繼續運作和連線至雲端。我們強烈建議您遷移至 AWS IoT Greengrass Version 2，這會新增重要的新功能，並支援其他平台 。

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

在AWS IoT Greengrass核心上執行 Lambda 函數

AWS IoT Greengrass為您撰寫的使用者定義程式碼提供容器化 Lambda 執行階段環境。AWS Lambda部署至核心本機 Lambda 執行階段中AWS IoT Greengrass核心執行階段的 Lambda 函數。本機 Lambda 函數可由本機事件、來自雲端的訊息以及其他來源觸發，這些函數可為用戶端裝置帶來本機運算功能。例如，您可以使用 Greengrass Lambda 函數來篩選裝置資料，然後再將資料傳輸到雲端。

若要將 Lambda 函數部署到核心，您可以將函數新增至 Greengrass 群組 (透過參考現有的 Lambda 函數)，為函數設定群組特定的設定，然後部署群組。如果函數存取AWS服務，您也必須將任何必要的權限新增至 Greengrass 群組角色。

您可以設定參數來決定 Lambda 函數的執行方式，包括權限、隔離、記憶體限制等。如需詳細資訊，請參閱 使用群組特定組態來控制 Greengrass Lambda 函數的執行。

下表列出支援的 AWS Lambda 執行時間，和它們可以執行所在的 AWS IoT Greengrass Core 軟體版本。

* 您可以在受支援的版本上執行使用這些執行階段的 Lambda 函數AWS IoT Greengrass，但無法在AWS Lambda. 如果裝置上的執行階段與為該函數指定的 AWS Lambda 執行階段不同，您可以使用 FunctionRuntimeOverride in 來選擇自己的執行階段FunctionDefintionVersion。如需詳細資訊，請參閱CreateFunctionDefinition。如需支援的執行階段的詳細資訊，請參閱AWS Lambda開發人員指南中的執行階段支援政策。

適用於 Greengrass Lambda 函數的 SDK

AWS提供三個 SDK，可供核心上執行的 Greengrass Lambda 函式使用。AWS IoT Greengrass這些軟體開發套件包含在不同的套裝服務中，因此函數可以同時使用它們。若要在 Greengrass Lambda 函數中使用 SDK，請將其包含在您上傳至的 Lambda 函數部署套件中。AWS Lambda

如需有關建立部署套件的詳細資訊，請參閱《開AWS Lambda發人員指南》建立 Lambda 函數中的〈入門〉自學課程或〈建立部署套件〉。

遷移以雲端為 Lambda 礎的

AWS IoT Greengrass核心 SDK 遵循 AWS SDK 程式設計模型，這可讓您輕鬆將針對雲端開發的 Lambda 函數移植到AWS IoT Greengrass核心上執行的 Lambda 函數。

例如，下列 Python Lambda 函數會使AWS SDK for Python (Boto3)用將訊息發佈至雲端some/topic中的主題：

import boto3

iot_client = boto3.client("iot-data")
response = iot_client.publish(
    topic="some/topic", qos=0, payload="Some payload".encode()
)

若要移植AWS IoT Greengrass核心的函數，請在import陳述式和client初始化中，將boto3模組名稱變更為greengrasssdk，如下列範例所示：

import greengrasssdk

iot_client = greengrasssdk.client("iot-data")
iot_client.publish(topic="some/topic", qos=0, payload="Some payload".encode())

程式設計模型之間的相似性也讓您能夠在雲端中開發 Lambda 函數，然後以最少的努力將它們遷移到AWS IoT Greengrass。Lambda 可執行檔不會在雲端中執行，因此您無法在部署之前使用 AWS SDK 在雲端中開發它們。

依別名或版本參考 Lambda 函數

Greengrass 組可以通過別名（推薦）或版本引用 Lambda 函數。使用別名可讓您更輕鬆地管理程式碼更新，因為當函數程式碼更新時，您不需要變更訂閱資料表或群組定義。相反，您只需將別名指向新函數版本即可。在群組部署期間，別名會解析為版本號碼。當您使用別名會更新解析的版本別名，此別名會指向部署的時間。

AWS IoT Greengrass不支持 $ 最新版本的 Lambda 別名。$LATEST 版本不綁定到不可變的發布函數版本，並且可以隨時更改，這與版本不變性的AWS IoT Greengrass原則相反。

使用程式碼變更來保持 Greengrass Lambda 函數更新的常見做法是使用 Greengrass 群組和訂閱PRODUCTION中指定的別名。當您將 Lambda 函數的新版本升級至生產環境時，請將別名指向最新的穩定版本，然後重新部署群組。您也可以使用此方法轉返至舊版本。

Greengrass Lambda 函數的通訊流程

Greengrass Lambda 函數支援多種與AWS IoT Greengrass群組的其他成員、本機服務和雲端服務 (包括AWS服務) 通訊的方法。

使用 MQTT 訊息進行通訊

Lambda 函數可以使用由訂閱控制的發佈-訂閱模式來傳送和接收 MQTT 訊息。

此通訊流程可讓 Lambda 函數與下列實體交換訊息：

訂閱會定義將訊息從來源路由到目標時所用的訊息來源、訊息目標和主題 (或主體)。發佈至 Lambda 函數的訊息會傳遞至函數的註冊處理常式。訂閱啟用更多安全性，和提供可預測的互動。如需詳細資訊，請參閱 MQTT 簡訊工作流程中的受管訂閱。

其他通訊流程

擷取輸入 MQTT 主題 (或主旨)

AWS IoT Greengrass使用訂閱來控制群組中用戶端裝置、Lambda 函數和連接器之間的 MQTT 訊息交換，以及與AWS IoT或本機陰影服務的交換。訂閱會定義訊息來源、訊息目標，以及用於路由訊息的 MQTT 主題。當目標是 Lambda 函數時，會在來源發佈訊息時叫用函數的處理常式。如需詳細資訊，請參閱 使用 MQTT 訊息進行通訊。

下列範例顯示 Lambda 函數如何從傳遞至處理常式的context輸入主題取得輸入主題。方式是從內容階層 (context.client_context.custom['subject']) 存取 subject 金鑰。範例也會剖析輸入 JSON 訊息，並發佈剖析的主題和訊息。

import greengrasssdk
import logging

client = greengrasssdk.client('iot-data')

OUTPUT_TOPIC = 'test/topic_results'

def get_input_topic(context):
    try:
        topic = context.client_context.custom['subject']
    except Exception as e:
        logging.error('Topic could not be parsed. ' + repr(e))
    return topic
    
def get_input_message(event):
    try:
        message = event['test-key']
    except Exception as e:
        logging.error('Message could not be parsed. ' + repr(e))
    return message

def function_handler(event, context):
    try:
        input_topic = get_input_topic(context)
        input_message = get_input_message(event)
        response = 'Invoked on topic "%s" with message "%s"' % (input_topic, input_message)
        logging.info(response)
    except Exception as e:
        logging.error(e)

    client.publish(topic=OUTPUT_TOPIC, payload=response)

    return

若要測試函數，請使用預設的組態設定將其新增至群組。接著，新增以下訂閱並部署群組。如需說明，請參閱第三單元 (第 1 部分)：Lambda 函數AWS IoT Greengrass。

部署完成後，呼叫該函數。

Greengrass Lambda 函數的生命週期組態

Greengrass Lambda 函數生命週期會決定函數的啟動時間，以及它如何建立和使用容器。生命週期也可決定在函數處理常式外所保留的變數和預先處理邏輯。

AWS IoT Greengrass 支援隨需 (預設) 或長期生命週期：

如需容器重複使用的詳細資訊，請參閱了解 AWS Compute 部落格AWS Lambda中的容器重複使用。

Lambda 可執行檔

此功能適用於AWS IoT Greengrass核心 v1.6 及更高版本。

Lambda 可執行檔是一種 Greengrass Lambda 函數，可用來在核心環境中執行二進位程式碼。它使您可以本地執行特定於設備的功能，並從編譯代碼的較小佔用空間中受益。Lambda 可執行檔可由事件叫用、叫用其他函數，以及存取本機資源。

Lambda 可執行文件僅支持二進制編碼類型（不是 JSON），但否則您可以在 Greengrass 組中管理它們，並像其他 Greengrass Lambda 函數一樣部署它們。不過，建立 Lambda 可執行檔的程序與建立 Python、Java 和 Node.js Lambda 函數不同：

Lambda 可執行檔必須在其函數程式碼中實作某些呼叫和程式設計模式。例如，main 方法必須：

下列程式碼片段是上的簡單處理程式碼範例中的main方法。 GitHub

int main() {
    gg_error err = GGE_SUCCESS;

    err = gg_global_init(0);
    if(err) {
        gg_log(GG_LOG_ERROR, "gg_global_init failed %d", err);
        goto cleanup;
    }

    gg_runtime_start(handler, 0);

cleanup:
    return -1;
}

如需需求、條件約束和其他實作詳細資訊的詳細資訊，請參閱適用於 C 的 AWS IoT Greengrass Core SDK。

建立 Lambda 可執行檔

在您與 SDK 一起編譯程式碼之後，請使用 AWS Lambda API 建立 Lambda 函數，並上傳已編譯的可執行檔。

下列範例會使用建立函數 CLI 命令來建立 L ambda 可執行檔。此命令指定：

aws lambda create-function \
--region aws-region \
--function-name function-name \
--handler executable-name \
--role role-arn \
--zip-file fileb://file-name.zip \
--runtime arn:aws:greengrass:::runtime/function/executable

接著，請使用 AWS Lambda API 發佈版本並建立別名。

然後，將 Lambda 可執行檔新增至 Greengrass 群組，將其設定為在其群組特定設定中接受二進位輸入資料，然後部署該群組。透過 AWS IoT Greengrass 主控台或使用 AWS IoT Greengrass API 皆可執行這項作業。