【AWS】IoT Greengrass v2備忘録 #AWS

　AWS IoT Greengrassとは、IoTエッジデバイスにアプリケーションをデプロイ・管理できるクラウドプラットフォームです。

今回は、Greengrass v2のハンズオンチュートリアルを参考に、実際にやってみる。

エッジデバイスへGreengrassのインストール

エッジデバイスへのGreengrassのインストールは非常に簡単で、コンソール画面を開いて、数コマンド打ち込むだけ。

Grrengrass v2のコンソール画面を開く
Greengrassデバイス -> 1つのCoreデバイスをセットアップを押す
※ここに非常に丁寧に手順が示されている。下記はその手順。

JavaのJRE(Javaランタイム)をインストールする

sudo apt-get update
sudo apt-get upgrade
sudo apt-get install default-jre

AWSアクセスキーの環境変数とインストールコマンドをデバイスで打ち込む

export AWS_ACCESS_KEY_ID=<AWS_ACCESS_KEY_ID>
export AWS_SECRET_ACCESS_KEY=<AWS_SECRET_ACCESS_KEY>
export AWS_SESSION_TOKEN=<AWS_SESSION_TOKEN>

# インストーラーのダウンロード
curl -s https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-nucleus-latest.zip > greengrass-nucleus-latest.zip && unzip greengrass-nucleus-latest.zip -d GreengrassInstaller

# インストーラーの実行
sudo -E java -Droot="/greengrass/v2" -Dlog.store=FILE -jar ./GreengrassInstaller/lib/Greengrass.jar --aws-region ap-northeast-1 --thing-name GreengrassQuickStartCore-18df36c1764 --thing-group-name GreengrassQuickStartGroup --component-default-user ggc_user:ggc_group --provision true --setup-system-service true --deploy-dev-tools true

正常に実行されているか確認する

sudo systemctl status greengrass.service
sudo systemctl enable greengrass.service

これで、コンソール画面上から、コンポーネントをデバイスへアップロードできる

詳細設定は、下記ファイルに記載する

sudo vim greengrass.service
sudo systemctl enable greengrass.service

安全なトンネル接続を設定する

デバイスのポートを開く

Linuxのパーソナルファイアウォール ufwをインストールする

sudo apt install apt-file
sudo apt-file update
sudo apt-file search apr-add-repository
sudo apt install uwf

ufwを有効化して、ポート443を開く
```
sudo ufw enable
sudo ufw allow 443
```
再起動する
```
reboot
```
解放されているか確認する
```
sudo ufw status
```

SSHデーモンをインストールする

SSHデーモンをインストールする
```
sudo apt-get install avahi-daemon
```
SSHを有効化する
```
sudo systemctl enable ssh
```

コンソール画面からSSH接続する

Greengrass v2 コンソール画面を開く
Greengrass デバイス -> コンポーネント - パブリックコンポーネントを開く
aws.greengrass.SecureTunnelingをクリックする
右上のデプロイで、対象のデバイスにデプロイする
※正常にデプロイされ、実行されれば、コンポーネント画面のステータスで実行中になります。
そうでなければ、再デプロイする
すべてのデバイス -> モノ -> 対象の物理デバイスを選択する
右上の安全なトンネルを作成するをクリックする
新しいトンネルを作成を選択
クイックセットアップ (SSH)を選択
次へを押す
確認して作成を押す
リモートアクション -> 安全なトンネルをクリックする
新しいアクセストークンを生成を押す
※時間が経過するとアクセストークンが無効になり、接続ボタンが押せなくなります。
再度、アクセストークンを生成すると、接続可能になります。
13.接続を押して、接続先デバイスのユーザー名とパスワードを入力する

コンポーネントの作成

コンポーネントはレシピとアーチファクトからなり、下記のフォルダ構成で開発する。

GreengrassCore/
├ artifacts/
│         └com.example.HelloWorld/
│                                └1.0.0/hello_world.py
│
└ recipes/com.example.HelloWorld-1.0.0.json

まずは、上記フォルダ構成を作成するコマンドを叩く

mkdir -p ~/environment/GreengrassCore/artifacts/com.example.HelloWorld/1.0.0 && touch ~/environment/GreengrassCore/artifacts/com.example.HelloWorld/1.0.0/hello_world.py
mkdir -p ~/environment/GreengrassCore/recipes && touch ~/environment/GreengrassCore/recipes/com.example.HelloWorld-1.0.0.json

アーチファクトファイルであるhello_world.pyに以下をコピペする

hello_world.py

# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: MIT-0
import sys
import datetime
import time

while True:

    message = f"Hello, {sys.argv[1]}! Current time: {str(datetime.datetime.now())}."

    # Print the message to stdout.
    print(message)

    # Append the message to the log file.
    with open('/tmp/Greengrass_HelloWorld.log', 'a') as f:
         print(message, file=f)

    time.sleep(1)

レシピであるcom.example.HelloWorld-1.0.0.jsonに以下をコピペする

com.example.HelloWorld-1.0.0.json

{
  "RecipeFormatVersion": "2020-01-25",
  "ComponentName": "com.example.HelloWorld",
  "ComponentVersion": "1.0.0",
  "ComponentDescription": "My first AWS IoT Greengrass component.",
  "ComponentPublisher": "Amazon",
  "ComponentConfiguration": {
    "DefaultConfiguration": {
      "Message": "world"
    }
  },
  "Manifests": [
    {
      "Platform": {
        "os": "linux"
      },
      "Lifecycle": {
        "Run": "python3 -u {artifacts:path}/hello_world.py '{configuration:/Message}'\n"
      }
    }
  ]
}

下記コマンドでコンポーネントをデプロイする

sudo /greengrass/v2/bin/greengrass-cli deployment create \
   --recipeDir ~/environment/GreengrassCore/recipes \
   --artifactDir ~/environment/GreengrassCore/artifacts \
   --merge "com.example.HelloWorld=1.0.0"

Local deployment submitted! Deployment Id: *****fc1-8503-401a-817b-**************

ログファイルに1行ごとに書きこみがされていれば、成功している

tail -F /tmp/Greengrass_HelloWorld.log


Hello, world! Current time: 2024-02-29 14:38:51.461737.
Hello, world! Current time: 2024-02-29 14:38:52.466139.
Hello, world! Current time: 2024-02-29 14:38:53.470553.
Hello, world! Current time: 2024-02-29 14:38:54.475245.
Hello, world! Current time: 2024-02-29 14:38:55.479950.
Hello, world! Current time: 2024-02-29 14:38:56.484553.

作成したカスタムコンポーネントをGreengrassへ登録する

aws認証情報を設定する
```
aws configure
```

S3バケットを作成する

EPOCH_TIME=$(date +"%s") && S3_BUCKET=ggcv2-workshop-$HOSTNAME-$EPOCH_TIME && aws s3 mb s3://$S3_BUCKET --region ap-northeast-1

レシピを変更する

{
  "RecipeFormatVersion": "2020-01-25",
  "ComponentName": "com.example.HelloWorld",
  "ComponentVersion": "1.0.0",
  "ComponentDescription": "My first AWS IoT Greengrass component.",
  "ComponentPublisher": "Amazon",
  "ComponentConfiguration": {
    "DefaultConfiguration": {
      "Message": "world"
    }
  },
  "Manifests": [
    {
      "Platform": {
        "os": "linux"
      },
      "Lifecycle": {
        "Run": "python3 -u {artifacts:path}/hello_world.py '{configuration:/Message}'\n"
      },
      "Artifacts": [
        {
          "URI": "s3://[YOUR BUCKET NAME]/artifacts/com.example.HelloWorld/1.0.0/hello_world.py"
        }
      ]
    }
  ]
}

S3へアーティファクトファイルをアップロードする

aws s3 cp --recursive /home/ubuntu/environment/GreengrassCore/ s3://$S3_BUCKET/

カスタムコンポーネントをGreengrassへ登録する

cd /home/ubuntu/environment/GreengrassCore/recipes && aws greengrassv2 create-component-version  --inline-recipe fileb://com.example.HelloWorld-1.0.0.json --region $AWS_DEFAULT_REGION

まとめ

今回は、IoT Greengrass v2の使い方を紹介した。