支援終止通知：2026 年 10 月 7 日 AWS 將停止 的支援 AWS IoT Greengrass Version 1。2026 年 10 月 7 日之後，您將無法再存取 AWS IoT Greengrass V1 資源。如需詳細資訊，請造訪[從 遷移 AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html)。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用 Greengrass 連接器來整合服務和通訊協定
此功能適用於 AWS IoT Greengrass Core v1.7 和更新版本。
中的連接器 AWS IoT Greengrass 是預先建置的模組，可讓您更有效率地與本機基礎設施 AWS、裝置通訊協定和其他雲端服務互動。透過使用連接器，您可以花較少的時間學習新的通訊協定和 APIs並有更多時間專注於對您業務至關重要的邏輯。
下圖顯示連接器可以適應 AWS IoT Greengrass 環境的位置。
![\[連接器連接到裝置、服務和本機資源。\]](http://docs.aws.amazon.com/zh_tw/greengrass/v1/developerguide/images/connectors/connectors-arch.png)
許多連接器使用 MQTT 訊息與群組中的用戶端裝置和 Greengrass Lambda 函數，或與 AWS IoT 和本機影子服務通訊。在下列範例中，Twilio Notifications 連接器會從使用者定義的 Lambda 函數接收 MQTT 訊息、使用來自秘密的本機參考 AWS Secrets Manager，並呼叫 Twilio API。
![\[從 Lambda 函數接收 MQTT 訊息並呼叫服務的連接器。\]](http://docs.aws.amazon.com/zh_tw/greengrass/v1/developerguide/images/connectors/twilio-solution.png)
如需建立此解決方案的教學課程，請參閱 [Greengrass 連接器入門 (主控台)](connectors-console.md) 和 [Greengrass 連接器入門 (CLI)](connectors-cli.md)。
Greengrass 連接器可協助您擴展裝置功能或建立單一用途裝置。透過使用連接器，您可以：
+ 實作可重複使用的商業邏輯。
+ 與雲端和本機服務互動，包括 AWS 和第三方服務。
+ 擷取和處理裝置資料。
+ 使用 MQTT 主題訂閱和使用者定義的 Lambda 函數啟用device-to-device呼叫。
AWS 提供一組 Greengrass 連接器，可簡化與常見服務和資料來源的互動。這些預先建置的模組可提供記錄和診斷、補充、產業資料處理及警示和簡訊的案例。如需詳細資訊，請參閱[AWS提供的 Greengrass 連接器](connectors-list.md)。
## 需求
若要使用連接器，請謹記以下幾點：
+ 您使用的每個連接器都有您必須符合的要求。這些要求可能包括最低 AWS IoT Greengrass Core 軟體版本、裝置先決條件、必要的許可和限制。如需詳細資訊，請參閱[AWS提供的 Greengrass 連接器](connectors-list.md)。
+ Greengrass 群組只能包含指定連接器的一個已設定執行個體。不過，您可以在多個訂閱中使用執行個體。如需詳細資訊，請參閱[組態參數](#connectors-parameters)。
+ 當 Greengrass 群組的預設容器化設定為 [No container (無容器)](lambda-group-config.md#lambda-containerization-groupsettings) 時，群組中的**連接器**必須在沒有容器化的情況下執行。若要尋找支援 **No container (無容器)** 模式的連接器，請參閱 [AWS提供的 Greengrass 連接器](connectors-list.md)。
## 使用 Greengrass 連接器
連接器是一種群組元件。與其他群組元件一樣，例如用戶端裝置和使用者定義的 Lambda 函數，您可以將連接器新增至群組、設定其設定，並將它們部署到 AWS IoT Greengrass 核心。連接器在核心環境中執行。
您可以將某些連接器部署為簡單的獨立應用程式。例如，Device Defender 連接器會從核心裝置讀取系統指標，並將其傳送至 AWS IoT Device Defender 進行分析。
您可以在較大的解決方案中新增其他連接器做為建置區塊。下列範例解決方案使用 Modbus-RTU 通訊協定轉接器連接器來處理來自感應器的訊息，並使用 Twilio Notifications 連接器啟動 Twilio 訊息。
![\[從 Lambda 函數到 Modbus-RTU 通訊協定轉接器連接器到 Lambda 函數到 Twilio Notifications 連接器到 Twilio 的資料流程。\]](http://docs.aws.amazon.com/zh_tw/greengrass/v1/developerguide/images/connectors/modbus-twilio-solution.png)
解決方案通常包含使用者定義的 Lambda 函數，這些函數位於連接器旁邊，並處理連接器傳送或接收的資料。在此範例中，TempMonitor 函數會從 Modbus-RTU 通訊協定轉接器接收資料、執行一些商業邏輯，然後將資料傳送至 Twilio Notifications。
若要建立和部署解決方案，請依照此一般程序：
1. 規劃高階資料流程。識別您需要使用的資料來源、資料管道、服務、通訊協定和資源。在範例解決方案中，這包括經過 Modbus RTU 通訊協定、實體 Modbus 序列埠和 Twilio 的資料。
1. 識別要在解決方案中包含的連接器，並將其新增到群組。範例解決方案使用 Modbus-RTU 通訊協定轉接器和 Twilio Notifications。為了協助尋找適用您情境的連接器並了解其個別要求，請參閱 [AWS提供的 Greengrass 連接器](connectors-list.md)。
1. 識別是否需要使用者定義的 Lambda 函數、用戶端裝置或資源，然後建立它們並將其新增至群組。這可能包括包含了商業邏輯的函數，或將資料處理成解決方案中另一個實體所需的格式。範例解決方案使用 函數傳送 Modbus RTU 請求並啟動 Twilio 通知。此外也包含 Modbus RTU 序列埠的本機裝置資源和 Twilio 驗證字符的私密資源。
**注意**
私密資源會參考來自 AWS Secrets Manager的密碼、字符和其他私密。連接器和 Lambda 函數可以使用秘密來驗證 服務和應用程式。根據預設， AWS IoT Greengrass 可以存取名稱開頭為 "*greengrass-*" 的秘密。如需詳細資訊，請參閱[將秘密部署到 AWS IoT Greengrass 核心](secrets.md)。
1. 建立訂閱以允許解決方案中的實體交換 MQTT 訊息。若訂閱中使用連接器，則連接器和訊息來源或目標必須使用連接器支援的預先定義主題語法。如需詳細資訊，請參閱[輸入和輸出](#connectors-inputs-outputs)。
1. 將群組部署至 Greengrass 核心。
如需有關建立和部署連接器的資訊，請參閱下列教學課程：
+ [Greengrass 連接器入門 (主控台)](connectors-console.md)
+ [Greengrass 連接器入門 (CLI)](connectors-cli.md)
## 組態參數
許多連接器會提供參數讓您自訂行為或輸出。這些參數用於連接器生命週期的初始化期間、執行時間或其他時間。
參數類型和用法依連接器而有不同。例如，SNS 連接器具有設定預設 SNS 主題的參數，而 Device Defender 具有設定資料取樣率的參數。
一個群組版本可以包含多個連接器，但特定連接器一次只能有一個執行個體。這表示群組中的每個連接器都僅會有一個作用中的組態。然而，連接器執行個體可在群組中的多個訂閱中使用。例如，您可以建立訂閱，允許許多裝置將資料傳送至 Kinesis Firehose 連接器。
### 用於存取群組資源的參數
Greengrass 連接器使用群組資源存取核心裝置上的檔案系統、連接埠、周邊設備和其他本機資源。如果連接器需要存取群組資源，則會提供相關的組態參數。
群組資源包括：
+ [本機資源](access-local-resources.md)。Greengrass 核心裝置上存在的目錄、檔案、連接埠、接腳和周邊設備。
+ [機器學習資源](ml-inference.md)。在雲端中訓練並部署至核心的機器學習模型，用於本機推論。
+ [私密資源](secrets.md)。密碼、金鑰、字符或任意文字的本機加密副本 AWS Secrets Manager。連接器可以安全地存取這些本機私密，並使用它們來向服務或本機基礎設施進行驗證。
例如，Device Defender 的參數可讓您存取主機`/proc`目錄中的系統指標，而 Twilio Notifications 的參數可讓您存取本機儲存的 Twilio 身分驗證字符。
### 更新連接器參數
參數是在連接器新增到 Greengrass 群組時設定。新增連接器之後，您可以變更參數值。
+ 在主控台中：從群組組態頁面，開啟 **Connectors (連接器)**，並從連接器的內容選單選擇 **Edit (編輯)**。
**注意**
如果連接器使用的私密資源後來變更為參考不同的私密，則您必須編輯連接器的參數並確認變更。
+ 在 API 中：建立連接器的另一個版本來定義新組態。
AWS IoT Greengrass API 使用版本來管理群組。版本不可變，因此若要新增或變更群組元件，例如群組的用戶端裝置、函數和資源，您必須建立新的或更新的元件版本。然後，您可以建立和部署包含每個元件目標版本的群組版本。
變更連接器組態後，您必須部署群組，以將變更傳播至核心。
## 輸入和輸出
許多 Greengrass 連接器可藉由傳送和接收 MQTT 訊息與其他實體通訊。MQTT 通訊是由允許連接器與 Greengrass 群組中的 Lambda 函數、用戶端裝置和其他連接器，或與 AWS IoT 和本機影子服務交換資料的訂閱所控制。若要允許此通訊，您必須在連接器所屬的群組中建立訂閱。如需詳細資訊，請參閱[MQTT 簡訊工作流程中的受管訂閱](gg-sec.md#gg-msg-workflow)。
連接器可以是訊息發佈者、訊息訂閱者或兩者。每個連接器都會定義其發佈或訂閱的 MQTT 主題。這些預先定義的主題必須在連接器是訊息來源或訊息目標的訂閱中使用。如需包括為連接器設定訂閱之步驟的教學課程，請參閱 [Greengrass 連接器入門 (主控台)](connectors-console.md) 和 [Greengrass 連接器入門 (CLI)](connectors-cli.md)。
**注意**
許多連接器也有內建的通訊模式可以與雲端或本機服務互動。這些會隨著連接器而有不同，可能需要您設定參數或將許可新增到[群組角色](group-role.md)。如需連接器要求的相關資訊，請參閱 [AWS提供的 Greengrass 連接器](connectors-list.md)。
### 輸入主題
大多數連接器會接收 MQTT 主題的輸入資料。有些連接器會訂閱輸入資料的多個主題。例如，序列串流連接器支援兩個主題：
+ `serial/+/read/#`
+ `serial/+/write/#`
針對此連接器，讀取和寫入請求會傳送至對應的主題。建立訂閱時，務必使用適用於實作的主題。
前述範例中的 `+` 和 `#` 字元是萬用字元。這些萬用字元可讓訂閱者在多個主題上接收訊息，並可讓發佈者自訂他們發佈到的主題。
+ `+` 萬用字元可出現在主題階層的任意處。這可替換成一個階層項目。
例如，針對 `sensor/+/input` 主題，訊息可以發佈到 `sensor/id-123/input` 主題，但不能發佈到 `sensor/group-a/id-123/input`。
+ `#` 萬用字元只能出現在主題階層的結尾。這可替換為零或多個階層。
例合，針對 `sensor/#` 主題，訊息可以發佈到 `sensor/`、`sensor/id-123` 和 `sensor/group-a/id-123`，但不能發佈到 `sensor`。
只有在訂閱主題時，萬用字元才有效。無法將訊息發佈到包含萬用字元的主題。如需連接器輸入或輸出主題需求的詳細資訊，請參閱連接器的文件。如需詳細資訊，請參閱[AWS提供的 Greengrass 連接器](connectors-list.md)。
## 容器化支援
根據預設，大部分的連接器會在由 AWS IoT Greengrass管理之隔離執行階段環境中的 Greengrass 核心上執行。這些執行階段環境稱為*容器*，可在連接器與主機系統之間提供隔離，為主機與連接器提供更高的安全性。
不過，在某些環境中不支援此 Greengrass 容器化，例如當您 AWS IoT Greengrass 在 Docker 容器或沒有 cgroup 的較舊 Linux 核心上執行時。在這些環境中，連接器必須以 **No container (無容器)** 模式執行。若要尋找支援 **No container (無容器)** 模式的連接器，請參閱 [AWS提供的 Greengrass 連接器](connectors-list.md)。有些連接器會以此模式原生執行，而有些連接器可讓您設定隔離模式。
在支援 Greengrass 容器化的環境中，您也可以將隔離模式設定為 **No container (無容器)**，但我們建議盡可能使用 **Greengrass container (Greengrass 容器)** 模式。
**注意**
Greengrass 群組的預設容器化設定不適用於[連接器](lambda-group-config.md#lambda-containerization-groupsettings)。
## 升級連接器版本
連接器提供者可能會發佈新增功能、修正問題或改善效能的新版連接器。如需可用版本和相關變更的資訊，請參閱[每個連接器的文件](connectors-list.md)。
在 AWS IoT 主控台中，您可以檢查 Greengrass 群組中連接器的新版本。
1. 在 AWS IoT 主控台導覽窗格的**管理**下，展開 **Greengrass 裝置**，然後選擇**群組 (V1)**。
1. 在 **Greengrass 群組**下，選擇您的群組。
1. 選擇 **Connectors (連接器)** 以顯示群組中的連接器。
如果連接器有新版本，**則升級**欄中會顯示**可用**按鈕。
1. 若要升級連接器版本：
1. 在 **Connectors (連接器)** 頁面的 **Upgrade (升級)** 欄中，選擇 **Available (可用)**。**Upgrade connector (升級連接器)** 頁面隨即開啟，並顯示目前的參數設定 (若適用)。
選擇新的連接器版本，視需要定義參數，然後選擇 **Upgrade (升級)**。
1. 在 **Subscriptions (訂閱)** 頁面上，在群組中新增新訂閱，以取代使用連接器做為來源或目標的任何訂閱。然後，移除舊訂閱。
訂閱會根據版本參考連接器，因此如果您變更群組中的連接器版本，訂閱則會變成無效。
1. 從 **Actions (動作)** 功能表中，選擇 **Deploy (部署)** 以將變更部署至核心。
若要從 AWS IoT Greengrass API 升級連接器，請建立並部署包含已更新連接器和訂閱的群組版本。使用與將連接器新增至群組相同的程序。如需示範如何使用 AWS CLI 來設定和部署範例 Twilio Notifications 連接器的詳細步驟，請參閱 [Greengrass 連接器入門 (CLI)](connectors-cli.md)。
## 連接器的記錄
Greengrass 連接器包含 Lambda 函數，可將事件和錯誤寫入 Greengrass 日誌。根據您的群組設定，日誌會寫入 CloudWatch Logs、本機檔案系統或兩者。來自連接器的日誌包含對應函數的 ARN。下列範例 ARN 來自 Kinesis Firehose 連接器：
```
arn:aws:lambda:aws-region:account-id:function:KinesisFirehoseClient:1
```
預設記錄組態使用以下目錄結構，將資訊層級日誌寫入檔案系統：
```
greengrass-root/ggc/var/log/user/region/aws/function-name.log
```
如需 Greengrass 記錄的詳細資訊，請參閱 [使用 AWS IoT Greengrass 日誌監控](greengrass-logs-overview.md)。