AWS IoT Greengrass Core ソフトウェアをインストールします。

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. AWS IoT Greengrass スナップがインストールされているかどうかを確認するには、snap list コマンドを実行します。

   次のレスポンスの例では、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 スナップはチャネルを使用してマイナーバージョンを管理します。スナップは、現在のチャネルの利用可能な最新バージョンに自動的に更新されます。例えば、--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      -

   [Slot] (スロット) 列がハイフン (-) になっている場合、対応するインターフェイスは接続されていません。

6. AWS IoT のモノ、Greengrass グループ、AWS IoT との安全な通信を可能にするセキュリティリソース、および AWS IoT Greengrass Core ソフトウェア設定ファイルを作成するには、「AWS IoT Greengrass Core ソフトウェアのインストール」を参照してください。設定ファイルの config.json には、例えば、証明書ファイルの場所や AWS IoT デバイスデータエンドポイントなど、Greengrass コアに固有の設定が含まれます。

   注記

   ファイルを別のデバイスにダウンロードした場合は、この手順に従って、ファイルを AWS IoT Greengrass コアデバイスに転送します。

7. AWS IoT Greengrass スナップの場合、config.json ファイルを次に示すように更新します。

   • certificateId の各インスタンスを証明書とキーファイルの名前に含まれる証明書 ID と置き換えます。

   • Amazon ルート CA 1 とは異なる Amazon ルート CA 証明書をダウンロードした場合は、AmazonRootCA1.pem の各インスタンスを Amazon ルート CA ファイルの名前に置き換えます。

   {
     ...
     "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 コマンドを使用すると、詳細なエラーメッセージを表示することができます。トラブルシューティングの詳細については、「error: は、次のタスクを実行できません: - - サービス ["greengrassd"] のスナップ "" aws-iot-greengrass([start snap.aws-iot-greengrass.greengrassd.service] が終了ステータス 1: Job for snapaws-iot-greengrass.greengrassd.service failed for snap.greengrassd.service がエラーコードで終了したため失敗しました。 詳細については、「systemctl status snapaws-iot-greengrass.greengrassd.service」および「journalctl -xe」を参照してください。）」を参照してください。

2. デーモンが実行中であることを確認するには、次のコマンドを実行します。

   snap services aws-iot-greengrass.greengrassd

   レスポンスの例:

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

3. 「モジュール 3 (パート 1): AWS IoT Greengrass での Lambda 関数」に従って、Hello World Lambda 関数を作成し、デプロイします。ただし、Lambda 関数をデプロイする前に、次のステップを完了してください。

4. Lambda 関数が snap_daemon ユーザーとして、コンテナなしモードで実行されていることを確認します。Greengrass グループの設定を更新するには、AWS IoT Greengrass コンソールで以下を実行します。

   1. AWS IoT Greengrass コンソールにサインインします。

   2. AWS IoT コンソールのナビゲーションペインの [Manage]（管理）で、[Greengrass devices]（Greengrass デバイス）を展開して、[Group (V1)]（グループ (V1)）を選択します。

   3. [Greengrass groups] (グリーングラスのグループ) で、対象グループを選択します。

   4. ナビゲーションペインのグループ設定ページで、[Lambda functions] (Lambda 関数) タブを選択します。

   5. [Default Lambda function runtime environment] (デフォルトの Lambda 関数ランタイム環境) から、[Edit] (編集) を選択して、次を行います。

      1. [Default system user and group] (デフォルトシステムユーザーとグループ) には、[Another user ID/group ID] (別のユーザー ID とグループ ID) を選択し、[System user ID (number)] (システムユーザー ID (数値)) と [System group ID (number)] (システムグループ ID (数値)) の両方に 584788 を入力します。

      2. [Default Lambda function containerization] (デフォルト Lambda 関数のコンテナ化) には、[No container] (コンテナなし) を選択します。

      3. [保存] を選択します。

現在のインストールをアーカイブして新しいバージョンをインストールするには

1. アップグレードする AWS IoT Greengrass Core ソフトウェアインストールパッケージをダウンロードします。

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 アーキテクチャプレースホルダーとバージョンプレースホルダーを交換します。

   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. デーモンを開始します。