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 核心軟體的 OTA 更新

AWS IoT Greengrass核心軟體套件包含可執行 over-the-air (OTA) AWS IoT Greengrass 軟體更新的更新代理程式。您可以使用 OTA 更新在一個或多個核心上安裝最新版本的 AWS IoT Greengrass Core 軟體或 OTA 更新代理程式軟體。透過 OTA 更新，您的核心裝置就不需要實際存在。

我們建議您盡可能使用 OTA 更新。它們提供了一種機制，讓您用來追蹤更新狀態和更新歷程記錄。如果發生更新失敗，OTA 更新代理程式會回復到先前的軟體版本。

OTA 更新可讓您更有效率地執行下列作業：

此功能與 AWS IoT 任務整合。

請求

下列需求適用於 AWS IoT Greengrass 軟體的 OTA 更新。

OTA 更新的 IAM 許可

AWS IoT Greengrass發行新版的AWS IoT Greengrass核心軟體時，會AWS IoT Greengrass更新存放在 Amazon S3 中用於 OTA 更新的軟體成品。

您AWS 帳戶必須包含可用來存取這些成品的 Amazon S3 URL 簽署者角色。角色必須具有權限原則，允許在目標 AWS 區域 s 中的值區s3:GetObject執行動作。該角色也必須具有允許 iot.amazonaws.com 將角色視為信任實體的信任政策。

此外，起始 OTA 更新的使用者必須具有 greengrass:CreateSoftwareUpdateJob 和 iot:CreateJob 的使用許可，以及使用 iam:PassRole 傳遞簽署者角色的許可。以下是 IAM 政策範例：

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Action": [
                "greengrass:CreateSoftwareUpdateJob"
            ],
            "Effect": "Allow",
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "iot:CreateJob"
            ],
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "iam:PassRole"
            ],
            "Resource": "arn-of-s3-url-signer-role"
        }
    ]
}

考量事項

啟動 Greengrass 核心軟體的 OTA 更新前，請注意更新會對 Greengrass 群組中的裝置造成的影響，不論群組是在核心裝置上還是在本機連線至該核心的用戶端裝置上：

在 OTA 更新期間，以下狀態資訊皆會保留：

Greengrass OTA 更新代理程式

Greengrass OTA 更新代理程式是裝置上的軟體元件，可處理在雲端中建立和部署的更新工作。OTA 更新代理程式散佈在與AWS IoT Greengrass核心軟體相同的軟體套件中。代理程式位於 /greengrass-root/ota/ota_agent/ggc-ota 中。它會將日誌寫入 /var/log/greengrass/ota/ggc_ota.txt。

您可以通過手動執行二進製文件或將其集成為 init 腳本（例如 systemd 服務文件）的一部分來啟動 OTA 更新代理程序。如果您手動執行二進製文件，則應以 root 身份運行。當它啟動時，OTA 更新代理程式會偵聽AWS IoT Greengrass軟體更新作業，AWS IoT Core並依序執行它們。OTA 更新代理程式會忽略所有其他AWS IoT作業類型。

下列摘錄顯示用於啟動、停止和重新啟動 OTA 更新代理程式的 systemd 服務檔案範例：

[Unit]
Description=Greengrass OTA Daemon

[Service]
Type=forking
Restart=on-failure
ExecStart=/greengrass/ota/ota_agent/ggc-ota

[Install]
WantedBy=multi-user.target

作為更新目標的核心不得運行 OTA 更新代理的兩個實例。這麼做會讓兩個代理程式處理相同的任務，而造成衝突。

與初始化系統整合

在 OTA 更新期間，OTA 更新代理會重新啟動核心設備上的二進製文件。如果二進位檔案正在執行，當初始化系統在更新期間監控 AWS IoT Greengrass Core 軟體或代理程式的狀態時，這可能會造成衝突。為了協助整合 OTA 更新機制與監控策略，您可以撰寫在更新前後執行的 shell 指令碼。例如，您可以使用指ggc_pre_update.sh令碼在裝置關閉之前備份資料或停止處理程序。

要告訴 OTA 更新代理程序運行這些腳本，您必須在 config.json 文件中包含該"managedRespawn" : true標誌。此設定會顯示在下列摘錄中：

{
   "coreThing": {                                                     
       …
   },
   "runtime": {                                                       
       …
   },
   "managedRespawn": true
       …
}

透過 OTA 更新受管的 respawn

下列需求適用於managedRespawn設定為的 OTA 更新true：

OTA 更新代理程式會從/greengrass-root/usr/scripts. 目錄樹狀圖看起來應該如下所示：

<greengrass_root>
|-- certs
|-- config
|   |-- config.json
|-- ggc
|-- usr/scripts
|   |-- ggc_pre_update.sh
|   |-- ggc_post_update.sh
|   |-- ota_pre_update.sh
|   |-- ota_post_update.sh
|-- ota

設定managedRespawn為時true，OTA 更新代理程式會在軟體更新前後檢查/greengrass-root/usr/scripts目錄中是否有這些指令碼。如果指令碼不存在，則更新會失敗。 AWS IoT Greengrass不會驗證這些指令碼的內容。最佳做法是驗證您的指令碼是否正常運作，並針對錯誤發出適當的結束代碼。

建立 OTA 更新

請依照下列步驟在一或多個核心上執行 AWS IoT Greengrass 軟體的 OTA 更新：

CreateSoftwareUpdateJob API

您可以使用 CreateSoftwareUpdateJob API 更新核心裝置上的AWS IoT Greengrass核心軟體或 OTA 更新代理程式軟體。此 API 會建立 AWS IoT 快照任務，在有可用更新時通知裝置。呼叫 CreateSoftwareUpdateJob 之後，您可以使用其他 AWS IoT 任務命令來追蹤軟體更新。如需詳細資訊，請參閱AWS IoT開發人員指南中的工作。

以下範例說明如何使用 AWS CLI 來建立更新核心裝置上 AWS IoT Greengrass 核心軟體的任務：

aws greengrass create-software-update-job \
--update-targets-architecture x86_64 \
--update-targets [\"arn:aws:iot:region:123456789012:thing/myCoreDevice\"] \
--update-targets-operating-system ubuntu \
--software-to-update core \
--s3-url-signer-role arn:aws:iam::123456789012:role/myS3UrlSignerRole \
--update-agent-log-level WARN \
--amzn-client-token myClientToken1

create-software-update-job 命令會傳回一個 JSON 回應，其中包含任務 ID、任務 ARN，以及更新所安裝的軟體版本：

{
    "IotJobId": "GreengrassUpdateJob_c3bd7f36-ee80-4d42-8321-a1da0EXAMPLE",
    "IotJobArn": "arn:aws:iot:region:123456789012:job/GreengrassUpdateJob_c3bd7f36-ee80-4d42-8321-a1da0EXAMPLE",
    "PlatformSoftwareVersion": "1.9.2"
}

如需說明如何使用 create-software-update-job 更新核心裝置的步驟，請參閱 建立 OTA 更新。

create-software-update-job 命令具有下列參數：