您正在檢視AWS IoT Greengrass Version 1。AWS IoT Greengrass Version 2是最新的主要版本AWS IoT Greengrass。如需使用AWS IoT Greengrass V2,請參閱AWS IoT Greengrass Version 2開發人員指南。
本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
設定 AWS IoT Greengrass 核心
同時AWS IoT Greengrass核心是AWS IoT做為邊緣環境中的中心或閘道的東西 (裝置)。如同其他 AWS IoT 裝置,核心存在於登錄檔中、具有裝置陰影,並使用裝置憑證向 AWS IoT Core 和 AWS IoT Greengrass 進行身份驗證。核心裝置執行 AWS IoT Greengrass 核心軟體,利其管理 Greengrass 群組的本機步驟,例如,通訊、陰影同步和字符交換。
AWS IoT Greengrass 核心軟體提供以下功能:
-
部署和本機執行連接器和 Lambda 函式。
-
在本機處理資料串流,並自動匯出至AWS 雲端。
-
使用受管訂閱時,裝置、連接器和 Lambda 函數之間在本機網路上的 MQTT 傳訊。
-
MQTT 訊息傳送AWS IoT和裝置、連接器和 Lambda 函數。
-
安全裝置與裝置之間的連線AWS 雲端使用裝置身份驗證和授權。
-
裝置的本機陰影同步。可將陰影設定為與AWS 雲端。
-
對本機裝置和磁碟區資源控制的存取。
-
用於執行本機推論的雲端訓練機器學習模型部署。
-
可讓裝置探索 Greengrass 核心裝置的自動 IP 地址偵測。
-
新的或更新的群組組態的集中部署。下載組態資料之後,核心裝置會自動重新啟動。
-
透過無線 (OTA) 軟體更新保護使用者定義的 Lambda 函數。
-
安全且經過加密的本機秘密儲存空間,並透過連接器和 Lambda 函數控制存取權。
AWS IoT Greengrass 核心組態檔案
AWS IoT Greengrass Core 軟體的組態檔案是 config.json
。它會置放於 /
目錄中。greengrass-root
/config
greengrass-root
代表 AWS IoT Greengrass 核心軟體在裝置上安裝所在的路徑。通常,這是 /greengrass
目錄。
如果您使用預設群組建立選項從AWS IoT Greengrass主控台,則config.json
檔案會部署至核心裝置處於工作狀態。
您可以執行下列命令檢閱此檔案內容:
cat /
greengrass-root
/config/config.json
以下是範例 config.json
檔案。這是您從建立核心時產生的版本。AWS IoT Greengrass主控台。
服務端點必須符合根 CA 憑證類型
您的 AWS IoT Core 和 AWS IoT Greengrass 端點必須對應至裝置上根憑證授權機構憑證的憑證類型。如果端點與憑證類型不相符,則裝置與 AWS IoT Core 或 AWS IoT Greengrass 之間的身份驗證嘗試會失敗。如需詳細資訊,請參閱「」伺服器驗證中的AWS IoT開發人員指南。
如果裝置使用 Amazon Trust Services (ATS) 根憑證授權機構憑證 (偏好的憑證),則也必須將 ATS 端點用於裝置管理和探索資料平面操作。ATS 端點包括 ats
區段,如 AWS IoT Core 端點的下列語法所示。
prefix
-ats.iot.region
.amazonaws.com
如需回溯相容性,AWS IoT Greengrass目前可在某些AWS 區域s。如果您使用的是舊式 VeriSign 根 CA 憑證,我們建議您建立 ATS 端點,並改用 ATS 根 CA 憑證。否則,請務必使用對應的舊式端點。如需詳細資訊,請參閱「」支援的傳統端點中的Amazon Web Services 一般參考。
config.json 中的端點
在 Greengrass 核心裝置上,端點會在coreThing
在中config.jsonfile. iotHost
屬性代表 AWS IoT Core 端點。ggHost
屬性代表 AWS IoT Greengrass 端點。在下列範例程式碼片段中,這些屬性指定 ATS 端點。
{ "coreThing" : { ... "iotHost" : "abcde1234uwxyz-ats.iot.us-west-2.amazonaws.com", "ggHost" : "greengrass-ats.iot.us-west-2.amazonaws.com", ... },
- AWS IoT Core endpoint
-
您可以取得AWS IoT Core端點,方法是執行aws iot describe-endpointCLI 命令,並使用適當的
--endpoint-type
參數。-
若要傳回 ATS 簽署的端點,請執行:
aws iot describe-endpoint --endpoint-type iot:Data-ATS
-
若要傳回舊式 VeriSign 簽署的端點,請執行:
aws iot describe-endpoint --endpoint-type iot:Data
-
- AWS IoT Greengrass endpoint
-
您的AWS IoT Greengrass端點是您的
iotHost
端點,而主機前置詞由greengrass。例如,ATS 簽署的端點是greengrass-ats.iot.
。這使用與 AWS IoT Core 端點相同的區域。region
.amazonaws.com
連線至連接埠 443 或透過網路代理
此功能於AWS IoT Greengrass核心 v1.7 版及更新版本。
Greengrass 核心會透過 TLS 用戶端身份驗證,使用 MQTT 訊息通訊協定與 AWS IoT Core 通訊。根據慣例,透過 TLS 的 MQTT 使用連接埠 8883。不過,做為安全措施之用,受限環境可能會將傳入和傳出流量限制於小範圍的 TCP 連接埠。例如,企業防火牆可能會針對 HTTPS 流量開放連接埠 443,但關閉較不常用之通訊協定的其他連接埠,例如 MQTT 流量的連接埠 8883。其他受限環境可能會要求所有流量先通過 HTTP 連線,再連線至網際網路。
為了在這些案例中啟用通訊,AWS IoT Greengrass 允許下列設定:
-
透過連接埠 443 使用 TLS 用戶端身分驗證的 MQTT。如果您的網路允許對連接埠 443 的連線,您可以將核心設定為針對 MQTT 流量使用連接埠 443,而不使用預設的連接埠 8883。這可以直接連線至連接埠 443,或透過網路代理伺服器連線。
AWS IoT Greengrass 使用 應用程式層通訊協定網路
(ALPN) TLS 延伸以連線。針對預設組態,連接埠 443 上透過 TLS 的 MQTT 使用憑證型的用戶端身分驗證。 設定為使用連接埠 443 的直接連線時,核心支援無線 (OTA) 更新forAWS IoT Greengrass軟體。此支援需要 AWS IoT Greengrass 核心版本 1.9.3 或更高版本。
-
透過連接埠 443 使用 HTTPS 通訊。AWS IoT Greengrass 會根據預設透過連接埠 8443 傳送 HTTPS 流量,但您可以將其設定為使用連接埠 443。
-
透過網路代理的連線。您可以設定網路代理伺服器,做為連線至 Greengrass 核心的中介。僅支援基本身分驗證和 HTTP 與 HTTPS 代理。
代理組態會透過使用者定義的 Lambda 函數傳遞給透過
http_proxy
、https_proxy
,以及no_proxy
環境變數。使用者定義的 Lambda 函數必須使用這些傳入設定,才能透過代理連接。Lambda 函數經常用來連線的程式庫 (例如 boto3 或 cURL 和 python)requests
軟件包)通常使用這些環境變量。如果 Lambda 函數也指定這些相同的環境變數,則AWS IoT Greengrass不會覆蓋它們。重要 設定為使用網路代理的 Greengrass 核心不支援 OTA 更新。
透過連接埠 443 設定 MQTT
此功能需要AWS IoT Greengrass核心 v1.7 版或更新版本。
此程序可讓 Greengrass 核心將連接埠 443 用於與 AWS IoT Core 傳遞 MQTT 訊息。
-
執行下列命令停用 Greengrass 協助程式:
cd /
greengrass-root
/ggc/core/ sudo ./greengrassd stop -
開放
由 su 使用者編輯。greengrass-root
/config/config.json -
在
coreThing
物件中,新增iotMqttPort
屬性,並將值設定為443
,如以下範例所示。{ "coreThing" : { "caPath" : "root.ca.pem", "certPath" : "12345abcde.cert.pem", "keyPath" : "12345abcde.private.key", "thingArn" : "arn:aws:iot:us-west-2:123456789012:thing/core-thing-name", "iotHost" : "abcd123456wxyz-ats.iot.us-west-2.amazonaws.com",
"iotMqttPort" : 443,
"ggHost" : "greengrass-ats.iot.us-west-2.amazonaws.com", "keepAlive" : 600 }, ... } -
啟動協助程式。
cd /
greengrass-root
/ggc/core/ sudo ./greengrassd start
透過連接埠 443 設定 HTTPS
此功能需要AWS IoT Greengrass核心 v1.8 版或更新版本。
此程序會設定核心使用連接埠 443 進行 HTTPS 通訊。
-
執行下列命令停用 Greengrass 協助程式:
cd /
greengrass-root
/ggc/core/ sudo ./greengrassd stop -
開放
由 su 使用者編輯。greengrass-root
/config/config.json -
在
coreThing
物件中,新增iotHttpPort
和ggHttpPort
屬性,如以下範例所示。{ "coreThing" : { "caPath" : "root.ca.pem", "certPath" : "12345abcde.cert.pem", "keyPath" : "12345abcde.private.key", "thingArn" : "arn:aws:iot:us-west-2:123456789012:thing/core-thing-name", "iotHost" : "abcd123456wxyz-ats.iot.us-west-2.amazonaws.com",
"iotHttpPort" : 443,
"ggHost" : "greengrass-ats.iot.us-west-2.amazonaws.com","ggHttpPort" : 443,
"keepAlive" : 600 }, ... } -
啟動協助程式。
cd /
greengrass-root
/ggc/core/ sudo ./greengrassd start
設定網路代理
此功能需要AWS IoT Greengrass核心 v1.7 版或更新版本。
此程序可讓 AWS IoT Greengrass 透過 HTTP 或 HTTPS 網路代理來連線至網際網路。
-
執行下列命令停用 Greengrass 協助程式:
cd /
greengrass-root
/ggc/core/ sudo ./greengrassd stop -
開放
由 su 使用者編輯。greengrass-root
/config/config.json -
使用
coreThing
物件來新增 networkProxy 物件,如以下範例所示。{ "coreThing" : { "caPath" : "root.ca.pem", "certPath" : "12345abcde.cert.pem", "keyPath" : "12345abcde.private.key", "thingArn" : "arn:aws:iot:us-west-2:123456789012:thing/core-thing-name", "iotHost" : "abcd123456wxyz-ats.iot.us-west-2.amazonaws.com", "ggHost" : "greengrass-ats.iot.us-west-2.amazonaws.com", "keepAlive" : 600,
"networkProxy": { "noProxyAddresses" : "http://128.12.34.56,www.mywebsite.com", "proxy" : { "url" : "https://my-proxy-server:1100", "username" : "Mary_Major", "password" : "pass@word1357" } }
}, ... } -
啟動協助程式。
cd /
greengrass-root
/ggc/core/ sudo ./greengrassd start
使用 networkProxy
物件,指定網路代理的相關資訊。此物件具有下列屬性。
欄位 | 描述 |
---|---|
noProxyAddresses |
選用。從代理中免除的 IP 地址或主機名稱清單 (以逗號分隔)。 |
proxy |
要連線至的代理。代理具有以下屬性。
|
允許端點
Greengrass 裝置與 AWS IoT Core 或 AWS IoT Greengrass 之間的通訊必須經過驗證。此身份驗證是根據已註冊的 X.509 裝置憑證和加密金鑰。若要允許經驗證的請求通過代理而不需其他加密,請允許以下端點。
端點 | 連接埠 | 描述 |
---|---|---|
greengrass. |
443 |
用於群組管理的控制平面操作。 |
或
|
MQTT:8883 或 443 HTTPS:8443 或 443 |
用於裝置管理的資料平面操作,例如陰影同步。 允許使用一個或兩個端點,這取決於您的核心和連線裝置是使用 Amazon Trust Services (偏好) 根 CA 憑證、舊版根 CA 憑證,或兩者皆是。如需更多詳細資訊,請參閱 服務端點必須符合根 CA 憑證類型。 |
或
|
8443 或 443 |
用於裝置探索操作。 允許使用一個或兩個端點,這取決於您的核心和連線裝置是使用 Amazon Trust Services (偏好) 根 CA 憑證、舊版根 CA 憑證,或兩者皆是。如需更多詳細資訊,請參閱 服務端點必須符合根 CA 憑證類型。 在連接埠 443 上連線的用戶端必須實作應用程式層通訊協定交涉 (ALPN) |
*.s3.amazonaws.com |
443 |
用於部署操作和無線更新。此格式包括 |
logs. |
443 |
在 Greengrass 群組設定為寫入日誌到 CloudWatch 時為必要。 |
設定 AWS IoT Greengrass 的寫入目錄
此功能於AWS IoT Greengrass核心版及更新版本。
根據預設,AWS IoT Greengrass Core 軟體部署於單一根目錄下,由 AWS IoT Greengrass 執行所有讀取和寫入操作。不過,您可以將 AWS IoT Greengrass 設定為使用單獨目錄進行所有寫入操作,其中也包括建立目錄和檔案。在此情況下,AWS IoT Greengrass 使用兩個頂層目錄:
-
greengrass-root
目錄,可將其保留為可讀寫或選擇為唯讀。這包含 AWS IoT Greengrass Core 軟體和其他應在執行時間保持不可變的重要元件,例如憑證和config.json
。 -
指定的寫入目錄。這包含可寫入的內容,如:日誌、狀態資訊和使用者部署定義的 Lambda 函數。
此組態結果為下列目錄結構。
- Greengrass 根目錄
-
greengrass-root
/ |-- certs/ | |-- root.ca.pem | |--hash
.cert.pem | |--hash
.private.key | |--hash
.public.key |-- config/ | |-- config.json |-- ggc/ | |-- packages/ | |--package-version
/ | |-- bin/ | |-- daemon | |-- greengrassd | |-- lambda/ | |-- LICENSE/ | |-- release_notes_package-version
.html | |-- runtime/ | |-- java8
/ | |-- nodejs8.10
/ | |-- python3.8
/ | |-- core/ - 寫入目錄
-
write-directory
/ |-- packages/ | |--package-version
/ | |-- ggc_root/ | |-- rootfs_nosys/ | |-- rootfs_sys/ | |-- var/ |-- deployment/ | |-- group/ | |-- group.json | |-- lambda/ | |-- mlmodel/ |-- var/ | |-- log/ | |-- state/
設定寫入目錄
-
執行下列命令停用 AWS IoT Greengrass 協助程式:
cd /
greengrass-root
/ggc/core/ sudo ./greengrassd stop -
開放
由 su 使用者編輯。greengrass-root
/config/config.json -
新增
writeDirectory
為參數並指定目標目錄路徑,如下所示。{ "coreThing": { "caPath": "root-CA.pem", "certPath": "hash.pem.crt", ... }, ... "writeDirectory" : "/
write-directory
" }注意 您隨時可以更新
writeDirectory
設定。設定更新後,AWS IoT Greengrass 於下一次開始使用新指定的寫入目錄,但遷移之前寫入目錄中的內容。 -
現在,您的寫入目錄已設定,您可以選擇設定
greengrass-root
目錄為唯讀。如需詳細資訊,請參閱設定 Greengrass 根目錄成為唯讀。否則,請啟動 AWS IoT Greengrass 協助程式:
cd /
greengrass-root
/ggc/core/ sudo ./greengrassd start
將 Greengrass 根目錄設為唯讀
只有在您想要將 Greengrass 根目錄設為唯讀狀態時,才需依照下列步驟執行。開始之前,必須先設定寫入目錄。
-
授與必要目錄的存取許可:
-
將讀取和寫入許可提供給
config.json
擁有者。sudo chmod 0600 /
greengrass-root
/config/config.json -
使 ggc_user 成為憑證和系統 Lambda 目錄的擁有者。
sudo chown -R ggc_user:ggc_group /
greengrass-root
/certs/ sudo chown -R ggc_user:ggc_group /greengrass-root
/ggc/packages/1.11.3/lambda/注意 預設會使用 ggc_user 和 ggc_group 帳戶執行系統 Lambda 函數。如果您設定群組層級的預設存取身分使用不同的帳戶,您應該改將許可提供給該使用者 (UID) 和群組 (GID)。
-
-
使用您偏好的機制將
greengrass-root
目錄設為唯讀。注意 其中一種設定
greengrass-root
目錄為唯讀的方法是掛載目錄為唯讀。不過,若要將無線 (OTA) 更新套用至掛載目錄中的 AWS IoT Greengrass Core 軟體,必須先移除掛載目錄,待更新完成後再次掛載目錄。您可以新增這些umount
和mount
操作到ota_pre_update
和ota_post_update
指令碼中。如需 OTA 更新的詳細資訊,請參閱 Greengrass OTA 更新代理程式 和 透過 OTA 更新受管的 respawn。 -
啟動協助程式。
cd /
greengrass-root
/ggc/core/ sudo ./greengrassd start如果未正確設定步驟 1 的許可,則協助程式不會啟動。
配置 MQTT 設定
在 中AWS IoT Greengrass環境、本機裝置、Lambda 函數、連接器和系統元件可互相通訊以及與AWS IoT Core。所有通訊都經過核心,負責管理授權實體與 MQTT 通訊之間的訂閱。
如需可為 AWS IoT Greengrass 設定 MQTT 設定的相關資訊,請參閱下列各節:
OPC-UA 是一個用於工業通訊的資訊交換標準。若要在 Greengrass 核心上實作 OPC-UA 的支援,您可以使用IoT SiteWise 連接器。此連接器可將產業裝置資料從 OPC-UA 伺服器傳送至 AWS IoT SiteWise 中的資產屬性。
訊息服務品質
AWS IoT Greengrass 支援服務品質 (QoS) 等級 0 或 1,視您的組態和通訊的目標和方向而定。Greengrass 核心做為與 AWS IoT Core 通訊的用戶端,以及區域網路上通訊用的訊息代理程式。

如需 MQTT 和 QoS 的詳細資訊,請參閱」入門
- 與通訊 AWS 雲端
-
-
使用 QoS 1 的傳出訊息
核心發送的消息注定AWS 雲端使用 QoS 1 的目標。AWS IoT Greengrass會使用 MQTT 訊息佇列來處理這些訊息。如果郵件傳遞未AWS IoT,則郵件會多工緩衝處理以便稍後重試。如果佇列已滿,則無法重試郵件。訊息傳遞確認有助於將間歇連線所造成的資料遺失降至最低。
因為輸出郵件AWS IoT使用 QoS 1,Greengrass 核心可以發送消息的最大速率取決於核心和AWS IoT。每次核心發送消息時,它都會等待直到AWS IoT會在訊息傳送下一則訊息之前確認訊息。例如,如果核心之間的往返時間,則AWS 區域為 50 毫秒,則核心每秒最多可傳送 20 封訊息。請考慮這個行為,當您選擇AWS 區域核心連接的位置。若要將大量 IoT 資料內嵌至AWS 雲端,您可以使用串流管理員。
如需 MQTT 訊息佇列的詳細資訊,包括如何設定本機儲存快取以保存送往AWS 雲端目標, 請參閱雲端目標的 MQTT 訊息佇列。
-
使用 QoS 0 (預設值) 或 QoS 1 的傳入訊息
根據預設,核心會以 QoS 0 訂閱來自AWS 雲端來源。如果您啟用持久性工作階段,該核心會使用 QoS 1 進行訂閱。這有助於將間歇連線所造成的資料遺失降至最低。若要管理這些訂閱的 QoS,請在本機多工緩衝處理器系統元件上設定持久性設定。
如需詳細資訊,包括如何讓核心透過AWS 雲端目標, 請參閱與 AWS IoT Core 的 MQTT 持久性工作階段。
-
- 與本機目標的通訊
-
所有本機通訊都使用 QoS 0。核心會嘗試將訊息傳送到本機目標,這些訊息可以是 Greengrass Lambda 函數、連接器或連接裝置。核心不會存放訊息或確認交付。您可以在元件之間任意刪除訊息。
注意 雖然 Lambda 函數之間的直接通訊不會使用 MQTT 傳訊,但行為模式相同。
雲端目標的 MQTT 訊息佇列
通往 MQTT 訊息AWS 雲端目標會加入佇列以等待處理。佇列的訊息依先進先出 (FIFO) 順序處理。當訊息經過處理並發佈至 AWS IoT Core 後,該訊息就會從佇列中移除。
依預設,Greengrass 核心會儲存送往AWS 雲端記憶體中的目標。您可以設定該核心,以將未處理的訊息改存放於本機儲存快取中。與記憶體內儲存不同,本機儲存快取能夠持續跨核心重啟 (例如,在群組部署或重新啟動裝置後),因此 AWS IoT Greengrass 可以繼續處理訊息。您也可以設定儲存大小。
AWS IoT Greengrass使用多工緩衝處理程式系統元件 (GGCloudSpooler
Lambda 函數) 來管理訊息佇列。您可以使用下列 GGCloudSpooler
環境變數來設定儲存設定。
-
GG_CONFIG_STORAGE_TYPE。訊息佇列的位置。以下為有效值:
-
FileSystem
。 將未處理的訊息儲存在實體核心裝置磁碟上的本機儲存快取中。核心重新啟動時,會保留佇列中的訊息以待處理。訊息處理後會移除。 -
Memory
(預設)。將未處理的訊息存放於記憶體。核心重新啟動時,佇列的訊息會遺失。此選項針對具有限硬體功能的裝置進行最佳化。若使用此組態,建議您在服務中斷最低時部署群組或重新啟動裝置。
-
-
GG_CONFIG_MAX_SIZE_BYTES。儲存大小,以位元組計。這個值可以是任何非負的整數,大於或等於 262144 (256 KB);愈小的值可以預防 AWS IoT Greengrass Core 軟體啟動。預設大小為 2.5 MB。超過大小限制時,舊佇列訊息會由新訊息取代。
此功能於AWS IoT Greengrass核心版及更新版本。較早版本使用 2.5 MB 佇列大小的記憶體內儲存容量。您不能設定舊版的儲存設定。
在本機儲存快取訊息
您可以設定 AWS IoT Greengrass 以快取訊息至檔案系統中,讓跨核心重新啟動時能存留。若要執行此操作,請部署函數定義版本,其中 GGCloudSpooler
函數會將儲存類型設定為 FileSystem
。您必須使用 AWS IoT Greengrass API 設定本機儲存快取。您無法在主控台執行這項操作。
下列程序使用 create-function-definition-version
CLI 命令來設定多工緩衝處理區域,以將佇列中的訊息儲存到檔案系統。這還會設定一個 2.6 MB 大小的佇列。
-
取得目標 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 會顯示在群組的 Deployments (部署) 頁面上。
-
從輸出中的目標群組複製
Id
和LatestVersion
值。 -
取得最新的群組版本。
-
Replace
group-id
與Id
您複製的。 -
Replace
最新組版本 ID
與LatestVersion
您複製的。
aws greengrass get-group-version \ --group-id
group-id
\ --group-version-idlatest-group-version-id
-
-
從輸出中的
Definition
物件,複製CoreDefinitionVersionArn
以及所有其他群組元件的 ARN,但FunctionDefinitionVersionArn
除外。建立新群組版本時,您會需要使用這些數值。 -
從輸出中的
FunctionDefinitionVersionArn
,複製函數定義的 ID。該 ID 是 ARN 中跟在functions
區段後面的 GUID,如下列範例所示。arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/bcfc6b49-beb0-4396-b703-6dEXAMPLEcu5/versions/0f7337b4-922b-45c5-856f-1aEXAMPLEsf6
注意 或者,您可以建立函數定義,藉由執行
create-function-definition
命令,然後從輸出複製 ID。 -
新增函數定義版本至函數定義。
-
將
function-definition-id
取代為您為函數定義複製的Id
。 -
將
arbitrary-function-id
取代為函數的名稱,例如spooler-function
。 -
將您想要包含於此版本的任何 Lambda 函數新增至
functions
陣列。您可以使用get-function-definition-version
命令從現有函數定義版本取得 Greengrass Lambda 函數。
警告 務必為
GG_CONFIG_MAX_SIZE_BYTES
指定大於或等於 262144 的值。較小的值可以預防 AWS IoT Greengrass Core 軟體啟動。aws greengrass create-function-definition-version \ --function-definition-id
function-definition-id
\ --functions '[{"FunctionArn": "arn:aws:lambda:::function:GGCloudSpooler:1","FunctionConfiguration": {"Environment": {"Variables":{"GG_CONFIG_MAX_SIZE_BYTES":"2621440","GG_CONFIG_STORAGE_TYPE":"FileSystem"}},"Executable": "spooler","MemorySize": 32768,"Pinned": true,"Timeout": 3},"Id": "arbitrary-function-id
"}]'注意 如果您之前將
GG_CONFIG_SUBSCRIPTION_QUALITY
環境變數設定為支援與 AWS IoT Core 的持久性工作階段,請將其包含在此函數執行個體中。 -
-
從輸出複製函數定義版本的
Arn
。 -
建立包含系統 Lambda 函數的群組版本。
-
為該群組將
group-id
取代為Id
。 -
將
core-definition-version-arn
取代為您從最新群組版本所複製的CoreDefinitionVersionArn
。 -
將
function-definition-version-arn
取代為您為功能定義版本所複製的Arn
。 -
取代您已從最新群組版本複製之其他群組元件 (例如
SubscriptionDefinitionVersionArn
或DeviceDefinitionVersionArn
) 的 ARN。 -
移除任何未使用的參數。比如說若您的群組版本不包含任何資源,則請移除
--resource-definition-version-arn
。
aws greengrass create-group-version \ --group-id
group-id
\ --core-definition-version-arncore-definition-version-arn
\ --function-definition-version-arnfunction-definition-version-arn
\ --device-definition-version-arndevice-definition-version-arn
\ --logger-definition-version-arnlogger-definition-version-arn
\ --resource-definition-version-arnresource-definition-version-arn
\ --subscription-definition-version-arnsubscription-definition-version-arn
-
-
從輸出複製
Version
。這是新群組版本的 ID。 -
部署具有新群組版本的群組。
-
將
group-id
取代為您為群組所複製的Id
。 -
將
group-version-id
取代為您為新群組版本所複製的Version
。
aws greengrass create-deployment \ --group-id
group-id
\ --group-version-idgroup-version-id
\ --deployment-type NewDeployment -
若要更新儲存設定,請使用 AWS IoT Greengrass API 建立新的函數定義版本,其中含有組態已更新的 GGCloudSpooler
函數。然後,請將函數定義版本新增至新群組版本 (以及其他群組元件) 和部署群組的版本中。如果想要還原預設組態,您可以部署一個不包含 GGCloudSpooler
函數的函數定義版本。
此系統 Lambda 函數不會顯示於主控台。然而,在函數新增至最新的群組版本後,除非您使用 API 執行取代或移除作業,否則其將包含在從主控台進行的部署中。
與 AWS IoT Core 的 MQTT 持久性工作階段
只有 AWS IoT Greengrass Core v1.10 與更新版本才提供這項功能。
Greengrass 核心可以建立與 AWS IoT 訊息代理程式的持久性工作階段。持久性工作階段是持續的連線,允許核心在離線時接收傳送的訊息。該核心是連線中的用戶端。
在持久性工作階段中,AWS IoT 訊息代理程式會儲存核心在連線期間所進行的所有訂閱。如果核心中斷連線,AWS IoT訊息代理程式會儲存發佈為 QoS 1 的未確認和新訊息,目的為本機目標,如 Lambda 函數和連接裝置。當核心重新連線時,持久性工作階段會繼續,且 AWS IoT 訊息代理程式會以每秒最多 10 則訊息的速率傳送儲存的訊息至核心。持久性工作階段的預設到期時間為 1 小時,並在訊息代理程式偵測到核心中斷連線時開始。如需詳細資訊,請參閱「」MQTT 持久性工作階段中的AWS IoT開發人員指南。
AWS IoT Greengrass使用多工緩衝處理程式系統元件 (GGCloudSpooler
Lambda 函數)來創建具有AWS IoT作為來源。您可以使用下列 GGCloudSpooler
環境變數來設定持久性工作階段。
-
GG_CONFIG_SUBSCRIPTION_QUALITY。以 AWS IoT 做為來源之訂閱的品質。以下為有效值:
-
AtMostOnce
(預設)。停用持久性工作階段。使用 QoS 0 的訂閱。 -
AtLeastOncePersistent
。 啟用持久性工作階段。在CONNECT
訊息中設定cleanSession
旗標為0
,並以 QoS 1 訂閱。核心接收到的 QoS 1 發佈訊息,會保證達到 Greengrass 協助程式的記憶體內工作佇列。核心會在訊息新增至佇列後確認訊息。從佇列到本機目標 (例如,Greengrass Lambda 函數、連接器或裝置) 的後續通訊會以 QoS 0 傳送。AWS IoT Greengrass並不保證傳遞到本地目標。
注意 您可以使用 maxWorkItemCount 組態屬性來控制工作項目佇列的大小。例如,如果您的工作負載需要大量的 MQTT 流量,您可以提升佇列大小。
持久性工作階段啟用時,核心會開啟至少一個額外的連線以供 MQTT 與 AWS IoT 交換訊息。如需更多詳細資訊,請參閱 使用 AWS IoT 之 MQTT 連線的用戶端 ID。
-
設定 MQTT 持久性工作階段
您可以將 AWS IoT Greengrass 設定為與 AWS IoT Core 之間使用持久性工作階段。若要執行此操作,請部署函數定義版本,其中 GGCloudSpooler
函數會將訂閱品質設定為 AtLeastOncePersistent
。此設定適用於您所有以 AWS IoT Core (cloud
) 做為來源的訂閱。您必須使用 AWS IoT Greengrass API 來設定持久性工作階段。您無法在主控台執行這項操作。
下列程序使用 create-function-definition-version
CLI 指令來設定多工緩衝處理器以使用持久性工作階段。在此程序中,我們假設您正在更新現有群組的最新群組版本設定。
-
取得目標 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 會顯示在群組的 Deployments (部署) 頁面上。
-
從輸出中的目標群組複製
Id
和LatestVersion
值。 -
取得最新的群組版本。
-
Replace
group-id
與Id
您複製的。 -
Replace
最新組版本 ID
與LatestVersion
您複製的。
aws greengrass get-group-version \ --group-id
group-id
\ --group-version-idlatest-group-version-id
-
-
從輸出中的
Definition
物件,複製CoreDefinitionVersionArn
以及所有其他群組元件的 ARN,但FunctionDefinitionVersionArn
除外。建立新群組版本時,您會需要使用這些數值。 -
從輸出中的
FunctionDefinitionVersionArn
,複製函數定義的 ID。該 ID 是 ARN 中跟在functions
區段後面的 GUID,如下列範例所示。arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/bcfc6b49-beb0-4396-b703-6dEXAMPLEcu5/versions/0f7337b4-922b-45c5-856f-1aEXAMPLEsf6
注意 或者,您可以建立函數定義,藉由執行
create-function-definition
命令,然後從輸出複製 ID。 -
新增函數定義版本至函數定義。
-
將
function-definition-id
取代為您為函數定義複製的Id
。 -
將
arbitrary-function-id
取代為函數的名稱,例如spooler-function
。 -
將您想要包含於此版本的任何 Lambda 函數新增至
functions
陣列。您可以使用get-function-definition-version
命令從現有函數定義版本取得 Greengrass Lambda 函數。
aws greengrass create-function-definition-version \ --function-definition-id
function-definition-id
\ --functions '[{"FunctionArn": "arn:aws:lambda:::function:GGCloudSpooler:1","FunctionConfiguration": {"Environment": {"Variables":{"GG_CONFIG_SUBSCRIPTION_QUALITY":"AtLeastOncePersistent"}},"Executable": "spooler","MemorySize": 32768,"Pinned": true,"Timeout": 3},"Id": "arbitrary-function-id
"}]'注意 如果您先前設定
GG_CONFIG_STORAGE_TYPE
或GG_CONFIG_MAX_SIZE_BYTES
環境變數來定義儲存設定,請將它們包含在此函數執行個體中。 -
-
從輸出複製函數定義版本的
Arn
。 -
建立包含系統 Lambda 函數的群組版本。
-
為該群組將
group-id
取代為Id
。 -
將
core-definition-version-arn
取代為您從最新群組版本所複製的CoreDefinitionVersionArn
。 -
將
function-definition-version-arn
取代為您為功能定義版本所複製的Arn
。 -
取代您已從最新群組版本複製之其他群組元件 (例如
SubscriptionDefinitionVersionArn
或DeviceDefinitionVersionArn
) 的 ARN。 -
移除任何未使用的參數。比如說若您的群組版本不包含任何資源,則請移除
--resource-definition-version-arn
。
aws greengrass create-group-version \ --group-id
group-id
\ --core-definition-version-arncore-definition-version-arn
\ --function-definition-version-arnfunction-definition-version-arn
\ --device-definition-version-arndevice-definition-version-arn
\ --logger-definition-version-arnlogger-definition-version-arn
\ --resource-definition-version-arnresource-definition-version-arn
\ --subscription-definition-version-arnsubscription-definition-version-arn
-
-
從輸出複製
Version
。這是新群組版本的 ID。 -
部署具有新群組版本的群組。
-
將
group-id
取代為您為群組所複製的Id
。 -
將
group-version-id
取代為您為新群組版本所複製的Version
。
aws greengrass create-deployment \ --group-id
group-id
\ --group-version-idgroup-version-id
\ --deployment-type NewDeployment -
-
(選用) 提高核心組態檔案中的 maxWorkItemCount 屬性。這有助核心處理增加的 MQTT 流量以及與本機目標之間的通訊。
若要以這些組態變更來更新核心,請使用 AWS IoT Greengrass API 建立新的函數定義版本,此定義版本含有組態已更新的 GGCloudSpooler
函數。然後,請將函數定義版本新增至新群組版本 (以及其他群組元件) 和部署群組的版本中。如果想要還原預設組態,您可以建立一個不包含 GGCloudSpooler
函數的函數定義版本。
此系統 Lambda 函數不會顯示於主控台。然而,在函數新增至最新的群組版本後,除非您使用 API 執行取代或移除作業,否則其將包含在從主控台進行的部署中。
使用 AWS IoT 之 MQTT 連線的用戶端 ID
此功能於AWS IoT Greengrass核心版及更新版本。
Greengrass 核心會開啟與 AWS IoT Core 的 MQTT 連線,以用於陰影同步和憑證管理一類操作。對於這些連線,核心會根據核心物件名稱產生可預測的用戶端 ID。可預測用戶端 ID 也可以用於監控、稽核和定價功能,包括 AWS IoT Device Defender 和 AWS IoT 生命週期事件。您也可以建立關於可預測用戶端 ID 的邏輯 (例如根據憑證屬性建立訂閱政策範本)。
同時連線中使用重複的用戶端 ID,可能會導致連線-中斷連線的無限迴圈。如果另一個裝置已硬式編碼為在連線中使用核心裝置名稱做為用戶端 ID,就會發生這種情形。如需詳細資訊,請參閱此故障診斷步驟。
Greengrass 裝置也與 AWS IoT Device Management 的機群索引服務完全整合。這可讓您根據裝置屬性、影子狀態和雲端連線狀態,索引和搜尋裝置。例如,Greengrass 裝置使用實物名稱當做用戶端 ID 建立至少一個連線,因此您可以使用裝置連線索引,探索哪些 Greengrass 裝置目前與 AWS IoT Core 連線或中斷連線。如需詳細資訊,請參閱「」機群索引服務中的AWS IoT開發人員指南。
設定本機簡訊的 MQTT 連接埠
此功能需要AWS IoT Greengrass核心版 1.10 或更新版本。
Greengrass 核心做為本機 Lambda 函數、連接器和 Greengrass 裝置之間傳遞 MQTT 訊息的本機訊息代理程式。根據預設,核心會使用連接埠 8883 以供區域網路上的 MQTT 流量使用。您可能會想變更連接埠,以避免與在連接埠 8883 上執行的其他軟體發生衝突。
設定核心用於本機 MQTT 流量的連接埠號碼
-
執行下列命令停用 Greengrass 協助程式:
cd /
greengrass-root
/ggc/core/ sudo ./greengrassd stop -
開放
由 su 使用者編輯。greengrass-root
/config/config.json -
在
coreThing
物件中,新增ggMqttPort
屬性並將值設為您要使用的連接埠號碼。有效值為 1024 到 65535。下列範例會將連接埠號碼設定為9000
。{ "coreThing" : { "caPath" : "root.ca.pem", "certPath" : "12345abcde.cert.pem", "keyPath" : "12345abcde.private.key", "thingArn" : "arn:aws:iot:us-west-2:123456789012:thing/core-thing-name", "iotHost" : "abcd123456wxyz-ats.iot.us-west-2.amazonaws.com", "ggHost" : "greengrass-ats.iot.us-west-2.amazonaws.com",
"ggMqttPort" : 9000,
"keepAlive" : 600 }, ... } -
啟動協助程式。
cd /
greengrass-root
/ggc/core/ sudo ./greengrassd start -
如果該核心已啟用自動 IP 偵測,則組態即完成。
如果自動 IP 偵測未啟用,您必須更新核心的連線資訊。這可讓 Greengrass 裝置在探索操作期間接收正確的連接埠號碼,以取得核心連線資訊。您可以使用AWS IoT主控台或AWS IoT GreengrassAPI 來更新核心連線資訊。在此程序中,您只會更新連接埠號碼。核心的本機 IP 地址會保持不變。
- 更新核心 (主控台) 的連線資訊
-
-
在群組配置頁面上,選擇 Cores (核心),然後選擇該核心。
-
在核心詳細資訊頁面上,選擇 Connectivity (連線),然後選擇 Edit (編輯)。
-
選擇 Add another connection (新增另一個連線),輸入您目前的本機 IP 地址和新的連接埠號碼。下列範例會設定 IP 地址
192.168.1.8
的連接埠號碼9000
。 -
移除已淘汰的端點,然後選擇 Update (更新)
-
- 更新核心 (API) 的連線資訊
-
-
使用 UpdateConnectivityInfo 動作。下列範例使用 AWS CLI 中的
update-connectivity-info
來設定 IP 地址192.168.1.8
的連接埠號碼9000
。aws greengrass update-connectivity-info \ --thing-name "MyGroup_Core" \ --connectivity-info "[{\"Metadata\":\"\",\"PortNumber\":9000,\"HostAddress\":\"192.168.1.8\",\"Id\":\"localIP_192.168.1.8\"},{\"Metadata\":\"\",\"PortNumber\":8883,\"HostAddress\":\"127.0.0.1\",\"Id\":\"localhost_127.0.0.1_0\"}]"
-
注意 您也可以設定核心用於與 AWS IoT Core 傳遞 MQTT 訊息的連接埠。如需更多詳細資訊,請參閱 連線至連接埠 443 或透過網路代理。
在 MQTT 連線中發佈、訂閱和取消訂閱操作的逾時AWS 雲端
此功能可在 AWS IoT Greengrass v1.10.2 或更新版本中使用。
您可以設定允許 Greengrass 核心在與 AWS IoT Core 的 MQTT 連線中完成發佈、訂閱或取消訂閱操作的時間量 (以秒為單位)。如果因為頻寬限制或高延遲而造成操作逾時,您可能會想要調整此設定。若要在 config.json 檔案中設定此設定,請新增或變更 coreThing
物件中的 mqttOperationTimeout
屬性。例如:
{ "coreThing": { "mqttOperationTimeout": 10, "caPath": "root-ca.pem", "certPath": "
hash
.cert.pem", "keyPath": "hash
.private.key", ... }, ... }
預設逾時時間為 5 秒。最小逾時為 5 秒。
啟動自動 IP 偵測
您可以設定AWS IoT Greengrass,讓 Greengrass 群組中的裝置自動探索格林草斯核心。啟用時,核心會監控其 IP 位址的變更。如果地址發生變化,核心會發布更新的地址列表。這些位址會提供給與核心位於相同 Greengrass 群組的裝置。
所以此AWS IoT原則必須授與greengrass:Discover
權限,以允許裝置擷取核心的連線資訊。如需有關此政策陳述式的詳細資訊,請參閱Discovery 授權。
若要啟用此功能,請從AWS IoT Greengrass主控台,選擇自動偵測當您第一次部署 Greengrass 群組時。您也可以在群組的設定頁面下核心連線資訊。如果 Automatically detect and override connection information (自動偵測並覆寫連線資訊) 已選取,則自動 IP 偵測已啟用。
若要使用AWS IoT GreengrassAPI,您必須設定IPDetector
系統 Lambda 函數。下列程序說明如何使用創建函數定義版本CLI 命令來配置 Greengrass 核心的自動探索。
-
取得目標 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 會顯示在群組的 Deployments (部署) 頁面上。
-
從輸出中的目標群組複製
Id
和LatestVersion
值。 -
取得最新的群組版本。
-
Replace
group-id
與Id
您複製的。 -
Replace
最新組版本 ID
與LatestVersion
您複製的。
aws greengrass get-group-version \ --group-id
group-id
\ --group-version-idlatest-group-version-id
-
-
從輸出中的
Definition
物件,複製CoreDefinitionVersionArn
以及所有其他群組元件的 ARN,但FunctionDefinitionVersionArn
除外。建立新群組版本時,您會需要使用這些數值。 -
從輸出中的
FunctionDefinitionVersionArn
,複製函數定義的 ID 和函數定義版本:arn:aws:greengrass:
region
:account-id
:/greengrass/groups/function-definition-id
/versions/function-definition-version-id
注意 您可以選擇執行
create-function-definition
命令來建立函數定義,然後從輸出複製 ID。 -
使用
get-function-definition-version
命令來取得目前定義狀態。使用您為函數定義複製的function-definition-id
。例如,4d941bc7-92a1-4f45-8d64-EXAMPLEf76c3
。aws greengrass get-function-definition-version --function-definition-id
function-definition-id
--function-definition-version-idfunction-definition-version-id
請記下列出的函數組態。您需要在建立新的函數定義版本中包含這些組態,以防止目前的定義設定遺失。
-
新增函數定義版本至函數定義。
-
將
function-definition-id
取代為您為函數定義複製的Id
。例如,4d941bc7-92a1-4f45-8d64-EXAMPLEf76c3
。 -
將
arbitrary-function-id
取代為函數的名稱,例如auto-detection-function
。 -
將您想要包含於此版本的所有 Lambda 函數新增至
functions
陣列 (例如之前步驟所列的任何項目)。
aws greengrass create-function-definition-version \ --function-definition-id
function-definition-id
\ --functions '[{"FunctionArn":"arn:aws:lambda:::function:GGIPDetector:1","Id":"arbitrary-function-id
","FunctionConfiguration":{"Pinned":true,"MemorySize":32768,"Timeout":3}}]'\ --region us-west-2 -
-
從輸出複製函數定義版本的
Arn
。 -
建立包含系統 Lambda 函數的群組版本。
-
為該群組將
group-id
取代為Id
。 -
將
core-definition-version-arn
取代為您從最新群組版本所複製的CoreDefinitionVersionArn
。 -
將
function-definition-version-arn
取代為您為功能定義版本所複製的Arn
。 -
取代您已從最新群組版本複製之其他群組元件 (例如
SubscriptionDefinitionVersionArn
或DeviceDefinitionVersionArn
) 的 ARN。 -
移除任何未使用的參數。比如說若您的群組版本不包含任何資源,則請移除
--resource-definition-version-arn
。
aws greengrass create-group-version \ --group-id
group-id
\ --core-definition-version-arncore-definition-version-arn
\ --function-definition-version-arnfunction-definition-version-arn
\ --device-definition-version-arndevice-definition-version-arn
\ --logger-definition-version-arnlogger-definition-version-arn
\ --resource-definition-version-arnresource-definition-version-arn
\ --subscription-definition-version-arnsubscription-definition-version-arn
-
-
從輸出複製
Version
。這是新群組版本的 ID。 -
部署具有新群組版本的群組。
-
將
group-id
取代為您為群組所複製的Id
。 -
將
group-version-id
取代為您為新群組版本所複製的Version
。
aws greengrass create-deployment \ --group-id
group-id
\ --group-version-idgroup-version-id
\ --deployment-type NewDeployment -
如果想要手動輸入 Greengrass 核心的 IP 地址,您可以使用不包含 IPDetector
函數的不同函數定義來完成此教學課程。這可防止偵測功能自動定位和輸入您的 Greengrass 核心 IP 地址。
此系統 Lambda 函數不會顯示於 Lambda 主控台。將函數新增至最新的群組版本後,它會包含在您從主控台執行的部署中,除非您使用 API 將其取代或移除。
設定初始化系統,啟動 Greengrass 協助程式
設定您的初始化系統在開機時啟動 Greengrass 協助程式是很好的實務練習,尤其是在管理大型叢集裝置時。
如果使用 apt
安裝 AWS IoT Greengrass 核心軟體,您可以使用 systemd 指令碼來啟用開機時啟動。如需更多詳細資訊,請參閱 使用 systemd 指令碼以管理 Greengrass 協助程式生命週期。
有不同類型的初始化系統,例如 initd、systemd、SystemV,以及其所使用類似的組態參數。以下範例為 systemd 的服務檔案:此 Type
參數設為 forking
是因為 greengrassd (用於啟動 Greengrass) 分岔 Greengrass 協助程式程序,而 Restart
參數設為 on-failure
,若 Greengrass 故障時將導引 systemd 重新啟動 Greengrass。
若要查看您的裝置是否使用 systemd,請執行check_ggc_dependencies
指令碼,如模組 1。然後要使用 systemd,請確認useSystemd
在中的參數config.json已設定為yes
。
[Unit] Description=Greengrass Daemon [Service] Type=forking PIDFile=/var/run/greengrassd.pid Restart=on-failure ExecStart=/greengrass/ggc/core/greengrassd start ExecReload=/greengrass/ggc/core/greengrassd restart ExecStop=/greengrass/ggc/core/greengrassd stop [Install] WantedBy=multi-user.target
如需在 Raspberry Pi 上如何建立和啟用服務檔案的詳細資訊,請參閱 Raspberry Pi 文件中的 SYSTEMD systemd