AWSIoT GreengrassCoreソフトウェアをEC2にインストールする

IoTのサービスを試したいが手元にRaspberry Piがないため、EC2でいろいろ触るための環境を構築したときの自分用メモ

（参考）AWS IoT GreengrassV2の使用を開始する
　※英語のページを日本語訳した方が読みやすかった
（参考）最新バージョンのAWS CLI をAmazon Linux 2 にインストールしてみた
（参考）GreengrassCLIをインストールできません

---

構成イメージ

EC2作成

1. 「Amazon Linux 2」を選択
   
2. 「t2.micro」を選択
   
3. 本インスタンスへのアクセス元（Cloud9）と同じVPCとサブネットを選択
   
4. ボリュームタイプ「gp3」を選択
   
5. コンソール画面で分かりやすいようにNameタグを追加（名前は任意）
   
6. 今回は作成済みのSGを利用
   SG設定は以下（Cloud9用のSGが付与されているインスタンスからのSSHを許可）
   
7. 「起動」ボタンを押下
   
8. 今回は作成済みのキーペアを利用
   

9. 「IAMロールを変更」を選択
   
   
   以下のようなロールを設定
   　※「AmazonSSMManagedInstanceCore」はセッションマネージャー用（任意）
   
   
   IAMポリシー「greengrass-test-policy」は以下とした（詳細な権限は未確認）

   {
   "Version": "2012-10-17",
   "Statement": [
       {
           "Sid": "VisualEditor0",
           "Effect": "Allow",
           "Action": [
               "iam:*",
               "iot:*",
               "greengrass:*"
           ],
           "Resource": "*"
       }
   ]
   }
   

EC2設定

ログイン確認

1. Cloud9にてpemファイルを作成

   1. touchコマンドでファイル作成後、ローカルのpemファイルの中身を貼り付けて保存

   2. 以下コマンドでpemファイルの権限を制限

      chmod 600 ./for-greengrass-test.pem
      

   3. 以下期待値
      

2. 以下コマンドで先ほど作成したインスタンスにログイン
   プライベートIPはEC2のコンソール画面から確認

   ssh -i ./for-greengrass-test.pem ec2-user@（プライベートIP）
   

   期待値は以下
   

AWSCLIの更新

1. 「AWS CLI V1の最小バージョン：v1.18.197」以上が必要なので更新が必要

   [ec2-user@ip-172-xx-xx-xx ~]$ aws --version
   aws-cli/1.18.147 Python/2.7.18 Linux/5.10.82-83.359.amzn2.x86_64 botocore/1.18.6
   

2. 以下コマンドで更新

   sudo yum install python3 -y
   sudo pip3 install awscli --upgrade
   

3. インストールされたことを確認
   デフォルトとパスが異なり、新旧両方存在する
   awsコマンドはデフォルトのバージョンのまま

   [ec2-user@ip-172-xx-xx-xx ~]$ /usr/local/bin/aws --version
   aws-cli/1.22.41 Python/3.7.10 Linux/5.10.82-83.359.amzn2.x86_64 botocore/1.23.41
   [ec2-user@ip-172-xx-xx-xx ~]$ /usr/bin/aws --version
   aws-cli/1.18.147 Python/2.7.18 Linux/5.10.82-83.359.amzn2.x86_64 botocore/1.18.6
   [ec2-user@ip-172-xx-xx-xx ~]$ aws --version
   aws-cli/1.18.147 Python/2.7.18 Linux/5.10.82-83.359.amzn2.x86_64 botocore/1.18.6
   

4. パスを変更

   [ec2-user@ip-172-xx-xx-xx ~]$ export PATH=/usr/local/bin/aws:$PATH
   [ec2-user@ip-172-xx-xx-xx ~]$ 
   

5. パスが変更されていることを確認

   [ec2-user@ip-172-xx-xx-xx ~]$ aws --version
   aws-cli/1.22.41 Python/3.7.10 Linux/5.10.82-83.359.amzn2.x86_64 botocore/1.23.41
   [ec2-user@ip-172-xx-xx-xx ~]$ 
   

• 「aws configure」を設定（リージョンのみ設定）

  [ec2-user@ip-172-xx-xx-xx ~]$ aws configure
  AWS Access Key ID [None]: 
  AWS Secret Access Key [None]: 
  Default region name [None]: ap-northeast-1
  Default output format [None]: 
  [ec2-user@ip-172-xx-xx-xx ~]$ 
  

javaインストール

1. 以下コマンドでインストール

   sudo yum install java-11-amazon-corretto
   

2. インストールされたことを確認

   [ec2-user@ip-172-xx-xx-xx ~]$ java -version
   openjdk version "11.0.13" 2021-10-19 LTS
   OpenJDK Runtime Environment Corretto-11.0.13.8.2 (build 11.0.13+8-LTS)
   OpenJDK 64-Bit Server VM Corretto-11.0.13.8.2 (build 11.0.13+8-LTS, mixed mode)
   [ec2-user@ip-172-xx-xx-xx ~]$ 
   

インストール

1. 以下コマンドにてインストーラーを準備

   curl -s https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-nucleus-latest.zip > greengrass-nucleus-latest.zip
   unzip greengrass-nucleus-latest.zip -d GreengrassInstaller && rm greengrass-nucleus-latest.zip
   

2. 展開されていることを確認

   [ec2-user@ip-172-xx-xx-xx ~]$ ls -al
   total 12
   drwx------ 4 ec2-user ec2-user 101 Jan 23 06:11 .
   drwxr-xr-x 3 root     root      22 Jan 23 05:04 ..
   -rw-r--r-- 1 ec2-user ec2-user  18 Jul 15  2020 .bash_logout
   -rw-r--r-- 1 ec2-user ec2-user 193 Jul 15  2020 .bash_profile
   -rw-r--r-- 1 ec2-user ec2-user 231 Jul 15  2020 .bashrc
   drwxrwxr-x 5 ec2-user ec2-user 114 Jan 23 06:11 GreengrassInstaller
   drwx------ 2 ec2-user ec2-user  29 Jan 23 05:04 .ssh
   

3. 以下コマンドにてインストールを実行

   sudo -E java -Droot="/greengrass/v2" -Dlog.store=FILE \
   -jar ./GreengrassInstaller/lib/Greengrass.jar \
   --aws-region ap-northeast-1 \
   --thing-name MyGreengrassCore \
   --thing-group-name MyGreengrassCoreGroup \
   --thing-policy-name MyGreengrassV2IoTThingPolicy \
   --tes-role-name MyGreengrassV2TokenExchangeRole \
   --tes-role-alias-name MyGreengrassCoreTokenExchangeRoleAlias \
   --component-default-user ggc_user:ggc_group \
   --provision true \
   --setup-system-service true \
   --deploy-dev-tools true
   

4. コアデバイスにデプロイされていることを確認

   [ec2-user@ip-172-xx-xx-xx ~]$ aws greengrassv2 list-effective-deployments --core-device-thing-name MyGreengrassCore
   {
   "effectiveDeployments": [
       {
           "deploymentId": "caf6711d-abe5-4685-bb76-9c6e02da9a6e",
           "iotJobId": "0a0325c4-418a-47a9-8731-2826e6442caf",
           "targetArn": "arn:aws:iot:ap-northeast-1:（AWSアカウントID）:thing/MyGreengrassCore",
           "coreDeviceExecutionStatus": "COMPLETED",
           "reason": "SUCCESSFUL",
           "creationTimestamp": 1642598634.634,
           "modifiedTimestamp": 1642598634.634
       }
   ]
   }
   

5. GreengrassCLIがインストールされていることを確認

   [ec2-user@ip-172-xx-xx-xx ~]$ /greengrass/v2/bin/greengrass-cli help
   Usage: greengrass-cli [-hV] [--ggcRootPath=<ggcRootPath>] [COMMAND]
   Greengrass command line interface
   
     --ggcRootPath=<ggcRootPath>
                 The AWS IoT Greengrass V2 root directory.
   -h, --help      Show this help message and exit.
   -V, --version   Print version information and exit.
   Commands:
   help                Show help information for a command.
   component           Retrieve component information and stop or restart
                       components.
   deployment          Create local deployments and retrieve deployment status.
   logs                Analyze Greengrass logs.
   get-debug-password  Generate a password for use with the HTTP debug view
                       component.
   [ec2-user@ip-172-xx-xx-xx ~]$ 
   

コアデバイスにデプロイされていない場合

• 以下コマンドで手動デプロイできるらしい（未確認）

  [ec2-user@ip-172-xx-xx-xx ~]$ aws greengrassv2 create-deployment \
  >   --target-arn "arn:aws:iot:ap-northeast-1:（AWSアカウントID）:thing/MyGreengrassCore" \
  >   --components '{
  >     "aws.greengrass.Cli": {
  >       "componentVersion": "2.5.3"
  >     }
  >   }'
  {
  "deploymentId": "37e49969-5564-41e8-9b14-79d7af84e158"
  }
  [ec2-user@ip-172-xx-xx-xx ~]$
  

GreengrassCLIがインストールされていない場合

• 以下の結果の場合はインストールされていない

  [ec2-user@ip-172-xx-xx-xx ~]$ /greengrass/v2/bin/greengrass-cli help
  -bash: /greengrass/v2/bin/greengrass-cli: No such file or directory
  

  デプロイしているモノグループに既にコアデバイスが属している場合に発生するらしい
  　※2回目以降にコアデバイスを使いまわす場合は発生する
  コアデバイスにデプロイされていない状態でGreengrassCLIをインストールした場合も発生
  　※デプロイされるまで待つ必要がある

手動でのGreengrassCLI手順

1. グループの確認
   今回はwheelとggc_groupを指定する（10と992）

   [ec2-user@ip-172-xx-xx-xx ~]$ cat /etc/group
   root:x:0:
   bin:x:1:
   daemon:x:2:
   ・
   ・
   ・
   wheel:x:10:ec2-user
   ・
   ・
   ・
   ec2-user:x:1000:
   ggc_user:x:993:
   ggc_group:x:992:ggc_user
   [ec2-user@ip-172-xx-xx-xx ~]$ 
   

2. 以下内容のファイルを作成

   [ec2-user@ip-172-xx-xx-xx ~]$ touch deployment.json
   [ec2-user@ip-172-xx-xx-xx ~]$ vim deployment.json
   [ec2-user@ip-172-xx-xx-xx ~]$ cat deployment.json
   {
   "targetArn":"arn:aws:iot:ap-northeast-1:（AWSアカウントID）:thing/MyGreengrassCore",
   "components": {
   "aws.greengrass.Cli": {
     "componentVersion": "2.5.3",
     "configurationUpdate": {
       "merge": "{\"AuthorizedPosixGroups\":\"10,992\",\"AuthorizedWindowsGroups\":\"10,992\"}"
     }
   }
   }
   }
   [ec2-user@ip-172-xx-xx-xx ~]$ 
   

3. 以下コマンドを実行

   [ec2-user@ip-172-xx-xx-xx ~]$ aws greengrassv2 create-deployment --cli-input-json file:///home/ec2-user/deployment.json
   {
   "deploymentId": "408ee2ab-2b64-480d-b49f-cd5919c43b14"
   }
   [ec2-user@ip-172-xx-xx-xx ~]$ 
   

4. インストールされていることを確認

   [ec2-user@ip-172-xx-xx-xx ~]$ /greengrass/v2/bin/greengrass-cli help
   Usage: greengrass-cli [-hV] [--ggcRootPath=<ggcRootPath>] [COMMAND]
   Greengrass command line interface
   
     --ggcRootPath=<ggcRootPath>
                 The AWS IoT Greengrass V2 root directory.
   -h, --help      Show this help message and exit.
   -V, --version   Print version information and exit.
   Commands:
   help                Show help information for a command.
   component           Retrieve component information and stop or restart
                       components.
   deployment          Create local deployments and retrieve deployment status.
   logs                Analyze Greengrass logs.
   get-debug-password  Generate a password for use with the HTTP debug view
                       component.
   [ec2-user@ip-172-xx-xx-xx ~]$ 
   

感想

• 日本語の手順書はきれいに訳されておらず読めなかった
• まだサービスの全体像が分かっていないので理解していきたい