Greengrass 連接器入門 (CLI)

首先，建立私密。

aws secretsmanager create-secret --name greengrass-TwilioAuthToken --secret-string twilio-auth-token

從輸出複製私密的 ARN。您可以使用此 ARN 來建立私密資源和設定 Twilio 通知連接器。

建立包含最初版本的資源定義。

從輸出複製資源定義的 LatestVersionArn。您可以使用這個值，將資源定義版本新增至您部署到核心的群組版本。

建立含有最初版本的連接器定義。

從輸出複製連接器定義的 LatestVersionArn。您可以使用這個值，將連接器定義版本新增至您部署到核心的群組版本。

來自AWS IoT Greengrass核心開發套件下載頁面，下載AWS IoT Greengrass適用於 Python 的核心 SDK 到您的計算機。

解壓縮下載的封裝，以取得軟體開發套件。SDK 為 greengrasssdk 資料夾。

將以下 Python 程式碼函數儲存在名為 temp_monitor.py 的本機檔案中。

import greengrasssdk
import json
import random

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

# publish to the Twilio Notifications connector through the twilio/txt topic
def function_handler(event, context):
    temp = event['temperature']
    
    # check the temperature
    # if greater than 30C, send a notification
    if temp > 30:
        data = build_request(event)
        client.publish(topic='twilio/txt', payload=json.dumps(data))
        print('published:' + str(data))
        
    print('temperature:' + str(temp))
    return

# build the Twilio request from the input data
def build_request(event):
    to_name = event['to_name']
    to_number = event['to_number']
    temp_report = 'temperature:' + str(event['temperature'])

    return {
        "request": {
            "recipient": {
                "name": to_name,
                "phone_number": to_number,
                "message": temp_report
            }
        },
        "id": "request_" + str(random.randint(1,101))
    }

將下列項目壓縮成名為 temp_monitor_python.zip 的檔案。建立 ZIP 檔案時，只包含程式碼及其依存項目，而不包含資料夾。

這是您的 Lambda 函數部署套件。

建立 IAM 角色，供您建立函數時傳入角色 ARN 中。

從輸出複製 Arn。

使用AWS LambdaAPI 來建立 TempMonitor 函數。以下命令假設 zip 檔是在目前的目錄。

aws lambda create-function \
--function-name TempMonitor \
--zip-file fileb://temp_monitor_python.zip \
--role role-arn \
--handler temp_monitor.function_handler \
--runtime python3.7

發佈函數的一個版本。

aws lambda publish-version --function-name TempMonitor --description 'First version'

建立發佈版本的別名。

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

aws lambda create-alias --function-name TempMonitor --name GG_TempMonitor --function-version 1

從輸出複製 AliasArn。當您為 AWS IoT Greengrass 設定函數和建立訂閱時，您會使用這個值。

建立包含最初版本的函數定義。

從輸出複製 LatestVersionArn。您可以使用這個值，將函數定義版本新增至您部署到核心的群組版本。

從輸出複製 Id。稍後更新函數時，您會使用這個值。

建立包含最初版本的訂閱定義，而此版本包含訂閱。

從輸出複製 LatestVersionArn。您可以使用這個值，將訂閱定義版本新增至您部署到核心的群組版本。

獲取群組 ID 和最新群組版本：

1. 取得目標 Greengrass 群組 ID 和目標群組版本 ID。此程序假設這是最新的群組和群組版本。以下查詢會傳回最近建立的群組。

   aws greengrass list-groups --query "reverse(sort_by(Groups, &CreationTimestamp))[0]"

   或者，您可以依名稱查詢。群組名稱不需要是唯一名稱，因此可能會傳回多個群組。

   aws greengrass list-groups --query "Groups[?Name=='MyGroup']"

   注意

   您也可以在中尋找這些值AWS IoT主控台。群組 ID 會顯示在群組的 Settings (設定) 頁面上。群組版本 ID 會顯示在群組上部署索引標籤。

2. 從輸出複製目標群組的 Id。部署群組時，您可以使用此 ID 取得核心定義版本。

3. 從輸出複製 LatestVersion，這是新增至群組的最新版本 ID。您可以使用此取得核心定義版本。

取得核心定義版本的 ARN：

1. 取得群組版本。在此步驟中，我們假設最新的群組版本包含核心定義版本。

   • 將 group-id 取代為您為群組所複製的 Id。

   • Replacegroup-version-id與LatestVersion您為群組複製的。

   aws greengrass get-group-version \
   --group-id group-id \
   --group-version-id group-version-id

2. 從輸出複製 CoreDefinitionVersionArn。

建立群組版本。

aws greengrass create-group-version \
--group-id group-id \
--core-definition-version-arn core-definition-version-arn \
--resource-definition-version-arn resource-definition-version-arn \
--connector-definition-version-arn connector-definition-version-arn \
--function-definition-version-arn function-definition-version-arn \
--subscription-definition-version-arn subscription-definition-version-arn

複製輸出中的 Version 值。這是群組版本的 ID。您可以使用這個值來部署群組版本。

在核心裝置終端機，請確定 AWS IoT Greengrass 協助程式正在執行。

1. 檢查精靈是否有在運作：

   ps aux | grep -E 'greengrass.*daemon'

   若輸出的 root 含有 /greengrass/ggc/packages/1.11.6/bin/daemon 項目，則精靈有在運作。

2. 若要啟動協助程式：

   cd /greengrass/ggc/core/
   sudo ./greengrassd start

建立部署。

aws greengrass create-deployment \
--deployment-type NewDeployment \
--group-id group-id \
--group-version-id group-version-id

從輸出複製 DeploymentId。

取得部署狀態。

aws greengrass get-deployment-status \
--group-id group-id \
--deployment-id deployment-id

如果狀態為Success，部署成功。如需故障診斷協助，請參閱AWS IoT Greengrass 疑難排解。

在「」AWS IoT主控台首頁，請選擇測試。

適用於訂閱主題，請使用以下數值，然後選擇訂閱。Twilio 通知連接器將狀態資訊發佈到該主題。

適用於發佈到主題，請使用以下數值，然後選擇發布叫用函數。

{
   "to_name": "recipient-name",
   "to_number": "recipient-phone-number",
   "temperature": 31
}

如果成功，收件者將收到文字訊息，主控台會顯示success狀態來自輸出資料。

現在，將輸入訊息中的 temperature 變更為 29 並發佈。因為這是小於 30， TempMonitor 函數不會觸發 Twilio 訊息。