安裝 AWS IoT Greengrass 核心軟體

若要解除安裝AWS IoT Greengrass核心軟體並保留組態資訊

• 執行下列命令以移除AWS IoT Greengrass核心軟體套件，並將組態資訊保留在資/greengrass料夾中。

  sudo apt remove aws-iot-greengrass-core aws-iot-greengrass-keyring

若要解除安裝AWS IoT Greengrass核心軟體並移除組態資訊

1. 執行下列命令以移除AWS IoT Greengrass核心軟體套件，並從中移除組態資訊/greengrass folder。

   sudo apt purge aws-iot-greengrass-core aws-iot-greengrass-keyring

2. 從來源清單中移除AWS IoT Greengrass核心軟體儲存庫。如需詳細資訊，請參閱 移除AWS IoT Greengrass核心軟體儲存庫來源。

若要從來源清單中移除 APT 儲存庫

• 執行下列指令，從來源清單中移除AWS IoT Greengrass核心軟體儲存庫。

  sudo rm /etc/apt/sources.list.d/greengrass.list
  sudo apt update

1. 通過在設備的終端中運行以下命令來安裝core18快照：

   sudo snap install core18

   core18鎖點是基準鎖點，提供具有常用程式庫的執行階段環境。這個快照是從 Ubuntu 18.04 LTS 構建的。

2. 執行snapd下列命令進行升級：

   sudo snap install --channel=edge snapd; sudo snap refresh --channel=edge snapd

3. 執行snap list命令以檢查是否已安裝AWS IoT Greengrass快照。

   下列範例回應顯示snapd已安裝，但aws-iot-greengrass尚未安裝。

   Name              Version               Rev    Tracking         Publisher   Notes
   amazon-ssm-agent  3.0.161.0             2996   latest/stable/…  aws✓        classic
   core              16-2.48               10444  latest/stable    canonical✓  core
   core18            20200929              1932   latest/stable    canonical✓  base
   lxd               4.0.4                 18150  4.0/stable/…     canonical✓  -
   snapd             2.48+git548.g929ccfb  10526  latest/edge      canonical✓  snapd

4. 選擇下列其中一個選項來安裝AWS IoT Greengrass快照 1.11.x。

   • 若要安裝AWS IoT Greengrass快照，請執行下列命令：

     sudo snap install aws-iot-greengrass

     回應範例：

     aws-iot-greengrass 1.11.5 from Amazon Web Services (aws) installed

   • 若要從舊版移轉至 v1.11.x 或更新至最新可用的修補程式版本，請執行下列命令：

     sudo snap refresh --channel=1.11.x aws-iot-greengrass

   與其他快照一樣，快AWS IoT Greengrass照使用通道來管理次要版本。Snap 會自動更新為目前頻道的最新可用版本。例如，如果您指定--channel=1.11.x，則您的AWS IoT Greengrass鎖點會更新為 v1.11.5。

   您可以執行snap info aws-iot-greengrass指令來取得的可用頻道清單AWS IoT Greengrass。

   回應範例：

   name:      aws-iot-greengrass
   summary:   AWS supported software that extends cloud capabilities to local devices.
   publisher: Amazon Web Services (aws✓)
   store-url: https://snapcraft.io/aws-iot-greengrass
   contact:   https://repost.aws/tags/TA4ckIed1sR4enZBey29rKTg/aws-io-t-greengrass
   license:   Proprietary
   description: |
     AWS IoT Greengrass seamlessly extends AWS onto edge devices so they can act locally on the data
     they generate, while still using the cloud for management, analytics, and durable storage.
     AWS IoT Greenrgrass snap v1.11.0 enables you to run a limited version of AWS IoT Greengrass with
     all necessary dependencies in a containerized environment.
     The AWS IoT Greengrass snap doesn't support connectors and machine learning (ML) inference.
     By downloading this software you agree to the Greengrass Core Software License Agreement
     (https://s3-us-west-2.amazonaws.com/greengrass-release-license/greengrass-license-v1.pdf).
     For more information, see Run AWS IoT Greengrass in a snap
     (https://docs.aws.amazon.com/greengrass/latest/developerguide/install-ggc.html#gg-snap-support) in
     the AWS IoT Greengrass Developer.
     If you need help, try the AWS IoT Greengrass tag on AWS re:Post
     (https://repost.aws/tags/TA4ckIed1sR4enZBey29rKTg/aws-io-t-greengrass) or connect with an AWS IQ expert
     (https://iq.aws.amazon.com/services/aws/greengrass).
   snap-id: SRDuhPJGj4XPxFNNZQKOTvURAp0wxKnd
   channels:
     latest/stable:    1.11.3 2021-06-15 (59) 111MB -
     latest/candidate: 1.11.3 2021-06-14 (59) 111MB -
     latest/beta:      1.11.3 2021-06-14 (59) 111MB -
     latest/edge:      1.11.3 2021-06-14 (59) 111MB -
     1.11.x/stable:    1.11.3 2021-06-15 (59) 111MB -
     1.11.x/candidate: 1.11.3 2021-06-15 (59) 111MB -
     1.11.x/beta:      1.11.3 2021-06-15 (59) 111MB -
     1.11.x/edge:      1.11.3 2021-06-15 (59) 111MB -

5. 若要存取 Lambda 函數所需的特定資源，您可以連線到其他介面。

   執行下列命令以取得AWS IoT Greengrass快照支援的介面清單：

   snap connections aws-iot-greengrass

   回應範例：

   Interface                Plug                                                Slot                 Notes
   camera                   aws-iot-greengrass:camera                           -                    -
   dvb                      aws-iot-greengrass:dvb                              -                    -
   gpio                     aws-iot-greengrass:gpio                             -                    -
   gpio-memory-control      aws-iot-greengrass:gpio-memory-control              -                    -
   greengrass-support       aws-iot-greengrass:greengrass-support-no-container  :greengrass-support  -
   hardware-observe         aws-iot-greengrass:hardware-observe                 :hardware-observe    manual
   hardware-random-control  aws-iot-greengrass:hardware-random-control          -                    -
   home                     aws-iot-greengrass:home-for-greengrassd             -                    -
   home                     aws-iot-greengrass:home-for-hooks                   :home                manual
   hugepages-control        aws-iot-greengrass:hugepages-control                :hugepages-control   manual
   i2c                      aws-iot-greengrass:i2c                              -                    -
   iio                      aws-iot-greengrass:iio                              -                    -
   joystick                 aws-iot-greengrass:joystick                         -                    -
   log-observe              aws-iot-greengrass:log-observe                      :log-observe         manual
   mount-observe            aws-iot-greengrass:mount-observe                    :mount-observe       manual
   network                  aws-iot-greengrass:network                          :network             -
   network-bind             aws-iot-greengrass:network-bind                     :network-bind        -
   network-control          aws-iot-greengrass:network-control                  :network-control     -
   opengl                   aws-iot-greengrass:opengl                           :opengl              -
   optical-drive            aws-iot-greengrass:optical-drive                    :optical-drive       -
   process-control          aws-iot-greengrass:process-control                  :process-control     -
   raw-usb                  aws-iot-greengrass:raw-usb                          -                    -
   removable-media          aws-iot-greengrass:removable-media                  -                    -
   serial-port              aws-iot-greengrass:serial-port                      -                    -
   spi                      aws-iot-greengrass:spi                              -                    -
   system-observe           aws-iot-greengrass:system-observe                   :system-observe      -

   如果您在「插槽」欄中看到連字號 (-)，表示對應的介面未連接。

6. 遵循安裝AWS IoT Greengrass核心軟體來建立AWS IoT物件、Greengrass 群組、可與之安全通訊的安全性資源AWS IoT，以及 AWS IoT Greengrass Core 軟體組態檔案。配置文件包含 Greengrass 核心特定的配置，例如證書文件的位置和AWS IoT設備數據端點。config.json

   注意

   如果您將文件下載到其他設備，請按照此步驟將文件傳輸到AWS IoT Greengrass核心設備。

7. 對於AWS IoT Greengrass快照，請確定您已更新 config.json 檔案，如下所示：

   • 將每個 certific ateId 執行個體取代為憑證和金鑰檔案名稱中的憑證 ID。

   • 如果您下載的 Amazon 根 CA 憑證不同於 Amazon 根 CA 1，請使用 Amazon 根 CA 檔案的名稱取代每個 AmazonRootCA1.peM 執行個體。

   {
     ...
     "crypto" : {
       "principals" : {
         "SecretsManager" : {
           "privateKeyPath" : "file:///snap/aws-iot-greengrass/current/greengrass/certs/certificateId-private.pem.keyy"
         },
         "IoTCertificate" : {
           "privateKeyPath" : "file:///snap/aws-iot-greengrass/current/greengrass/certs/certificateId-private.pem.key",
           "certificatePath" : "file:///snap/aws-iot-greengrass/current/greengrass/certs/certificateId-certificate.pem.crt"
         }
       },
       "caPath" : "file:///snap/aws-iot-greengrass/current/greengrass/certs/AmazonRootCA1.pem"
     },
     "writeDirectory": "/var/snap/aws-iot-greengrass/current/ggc-write-directory",
     "pidFileDirectory": "/var/snap/aws-iot-greengrass/current/pidFileDirectory"
   }

8. 執行下列命令以新增AWS IoT Greengrass憑證和組態檔：

   sudo snap set aws-iot-greengrass gg-certs=/home/ubuntu/my-certs

1. 執行下列命令以啟動AWS IoT Greengrass協助程式：

   sudo snap start aws-iot-greengrass

   回應範例：

   Started.

   注意

   如果出現錯誤，可以使用該snap run命令獲取詳細的錯誤消息。如需疑難排解詳細資訊，請參閱錯誤：無法執行以下任務：-運行服務命令「開始」為服務 ["greengrassd"] 的快照 "" aws-iot-greengrass "（[開始快照。 aws-iot-greengrass服務] 失敗，退出狀態 1：快照 Job。 aws-iot-greengrass.greengrassd.service 失敗，因為控制過程退出錯誤代碼。 請參閱「系統狀態鎖點」。 aws-iot-greengrass服務」和「日誌-XE」以獲取詳細信息。）。

2. 執行下列命令以確認精靈正在執行中：

   snap services aws-iot-greengrass.greengrassd

   回應範例：

   Service                         Startup   Current  Notes
   aws-iot-greengrass.greengrassd  disabled  active   -

3. 遵循模組 3 (第 1 部分)：開啟 Lambda 函數AWS IoT Greengrass來建立和部署 Hello World Lambda 函數。不過，在您部署 Lambda 函數之前，請先完成下一個步驟。

4. 請確定您的 Lambda 函數以snap_daemon使用者身分執行，且在無容器模式下執行。若要更新 Greengrass 群組的設定，請在主控台中執行下列動作：AWS IoT Greengrass

   1. 登入 AWS IoT Greengrass主控台。

   2. 在AWS IoT主控台瀏覽窗格的 [管理] 下，展開 [Greengrass 裝置]，然後選擇 [群組 (V1)]。

   3. 在綠色群組下，選擇目標群組。

   4. 在群組設定頁面的導覽窗格中，選擇 Lambda 函數索引標籤。

   5. 在預設 Lambda 函數執行階段環境下，選擇編輯，然後執行下列動作：

      1. 對於 [預設系統使用者和群組]，選擇 [其他使用者 ID/ 群組 ID]，然後輸入 584788 [系統使用者 ID (編號)] 和 [系統群組 ID (編號)]。

      2. 對於預設 Lambda 函數容器化，請選擇無容器。

      3. 選擇儲存。

封存目前安裝並安裝新版本

1. 下載您想要升級至的 AWS IoT Greengrass 核心軟體安裝套件。

2. 將套件複製到目的地核心裝置。如需示範傳輸檔案的說明，請參閱此步驟。

   注意

   稍後請將您目前的憑證、金鑰和組態檔案複製到新的安裝。

   在您的核心裝置終端機以下列步驟執行命令。

3. 請確認 Greengrass 協助程式在核心裝置上已停止。

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

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

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

      注意

      此程序假設 AWS IoT Greengrass Core 軟體安裝於 /greengrass 目錄。

   2. 停止 協助程式：

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

4. 將目前的 Greengrass 根目錄移到不同的目錄。

   sudo mv /greengrass /greengrass_backup

5. 在核心裝置上將新的軟體解壓縮。取代命令中的 os-architecture 和 version 預留位置。

   sudo tar –zxvf greengrass-os-architecture-version.tar.gz –C /

6. 將封存的憑證、金鑰和組態檔案複製到新的安裝。

   sudo cp /greengrass_backup/certs/* /greengrass/certs
   sudo cp /greengrass_backup/config/* /greengrass/config

7. 啟動協助程式：

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

還原封存的安裝

1. 停止協助程式。

2. 刪除新的 /greengrass 目錄。

3. 將 /greengrass_backup 目錄移回 /greengrass。

4. 啟動協助程式。