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 群組部署至 AWS IoT Greengrass 核心

使用AWS IoT Greengrass群組來組織邊緣環境中的圖元。您也可以使用群組來控制群組中的圖元如何彼此互動，以及與AWS 雲端. 例如，只有群組中的 Lambda 函數會部署在本機執行，而且只有群組中的裝置可以使用本機 MQTT 伺服器進行通訊。

群組必須包含核心，也就是執行 AWS IoT Greengrass 核心軟體的 AWS IoT 裝置。此核心能做為邊緣閘道，並在節點環境中提供 AWS IoT Core 功能。您也可以根據不同的商務需求，將下列實體新增至群組中：

您可以在中管理 Greengrass 群組，AWS 雲端然後將其部署到核心。部署會將群組組態複製到核心裝置上的 group.json 檔案。此檔案位於 greengrass-root/ggc/deployments/group：

從AWS IoT主控台部署群組

您可以從AWS IoT主控台中的群組設定頁面部署群組並管理其部署。

使用 AWS IoT Greengrass API 部署群組

AWS IoT Greengrass API 提供下列動作來部署 AWS IoT Greengrass 群組和管理群組部署。您可以從 AWS CLI、AWS IoT Greengrass API 或 AWS 開發套件來呼叫這些動作。

取得群組 ID

群組 ID 通常用於 API 動作。您可以使用此ListGroups動作從群組清單中尋找目標群組的 ID。例如，在 AWS CLI 中，使用 list-groups 命令。

aws greengrass list-groups

您也可以包含 query 選項來篩選結果。例如：

以下是 list-groups 回應範例。每個群組的資訊包括群組的 ID (在 Id 屬性中) 和最新群組版本的 ID (在 LatestVersion 屬性中)。若要取得群組的其他版本 ID，請搭配使用群組 ID ListGroupVersions。

{
    "Groups": [
        {
            "LatestVersionArn": "arn:aws:us-west-2:123456789012:/greengrass/groups/00dedaaa-ac16-484d-ad77-c3eedEXAMPLE/versions/4cbc3f07-fc5e-48c4-a50e-7d356EXAMPLE",
            "Name": "MyFirstGroup",
            "LastUpdatedTimestamp": "2019-11-11T05:47:31.435Z",
            "LatestVersion": "4cbc3f07-fc5e-48c4-a50e-7d356EXAMPLE",
            "CreationTimestamp": "2019-11-11T05:47:31.435Z",
            "Id": "00dedaaa-ac16-484d-ad77-c3eedEXAMPLE",
            "Arn": "arn:aws:us-west-2:123456789012:/greengrass/groups/00dedaaa-ac16-484d-ad77-c3eedEXAMPLE"
        },
        {
            "LatestVersionArn": "arn:aws:us-west-2:123456789012:/greengrass/groups/036ceaf9-9319-4716-ba2a-237f9EXAMPLE/versions/8fe9e8ec-64d1-4647-b0b0-01dc8EXAMPLE",
            "Name": "GreenhouseSensors",
            "LastUpdatedTimestamp": "2020-01-07T19:58:36.774Z",
            "LatestVersion": "8fe9e8ec-64d1-4647-b0b0-01dc8EXAMPLE",
            "CreationTimestamp": "2020-01-07T19:58:36.774Z",
            "Id": "036ceaf9-9319-4716-ba2a-237f9EXAMPLE",
            "Arn": "arn:aws:us-west-2:123456789012:/greengrass/groups/036ceaf9-9319-4716-ba2a-237f9EXAMPLE"
        },
        ...
    ]
}

如果您未指定AWS 區域，指AWS CLI令會使用您設定檔中的預設「地區」。若要傳回不同區域中的群組，請包含區域選項。例如：

aws greengrass list-groups --region us-east-1

AWS IoT Greengrass 群組物件模型概觀

當程式設計採用 AWS IoT Greengrass API 進行時，了解 Greengrass 群組物件模型會很有幫助。

群組

在 AWS IoT Greengrass API 中，最上層 Group 物件包含中繼資料和 GroupVersion 物件的清單。GroupVersion 物件則與透過 ID 與 Group 相關聯。

群組版本

GroupVersion 物件定義了群組成員資格。每個 GroupVersion 均參考 CoreDefinitionVersion 及其他依 ARN 的元件版本。這些參考決定了要包含在群組中的實體。

例如，若要在群組中包含三個 Lambda 函數、一個裝置和兩個訂用帳戶，參GroupVersion考資料如下：

核心裝置上的已部署 GroupVersion 則決定了本機環境中的可用實體，及其互動方式。

群組元件

您新增至群組的元件分為三層：

下面範例 DeviceDefinition 參考了三個 DeviceDefinitionVersion 物件，其中每個都會包含多個 Device 物件。一次只會在群組中使用一個 DeviceDefinitionVersion。

更新群組

在 AWS IoT Greengrass API 中，您可以使用版本來更新群組的組態。版本是不可變的，因此若要新增、移除或變更群組元件，您必須建立包含新實體或更新實體的DefinitionVersion物件。

您可以將新DefinitionVersions物件與新的或現有的定義物件相關聯。例如，您可以使用 CreateFunctionDefinition 動作來建立包含以 FunctionDefinitionVersion 做為初始版本的 FunctionDefinition，或者您可以使用 CreateFunctionDefinitionVersion 動作，同時參考現有的 FunctionDefinition。

建立群組元件之後，您可以建立一GroupVersion個包含您要包含在群組中的所有DefinitionVersion物件。然後，您要部署 GroupVersion。

若要部署 GroupVersion，其必須參考其中僅包含一個 Core 的 CoreDefinitionVersion。所有參考的實體都必須是該群組的成員。此外，Greengrass 服務角色必須與您AWS 帳戶AWS 區域在部署的. GroupVersion

更新參考資AWS源的實體

Greengrass Lambda 函數和秘密資源定義了 Greengrass 特定的屬性，並且還引用相應的資源。AWS若要更新這些實體，您可以變更對應的AWS資源，而不是 Greengrass 物件。例如，Lambda 函數會參考中的函數AWS Lambda，也會定義 Greengrass 群組特有的生命週期和其他屬性。

另請參閱