AWS IoT Greengrass Core の設定

ポート 443 を介した MQTT を設定するには

この機能を使用するには、AWS IoT Greengrass Core v1.7 以降が必要です。

この手順により、Greengrass コアが AWS IoT Core と MQTT メッセージングにポート 443 を使用できるようになります。

1. 次のコマンドを実行して Greengrass デーモンを停止します。

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

2. greengrass-root/config/config.json を編集するために su ユーザーとして開きます。

3. coreThing オブジェクトで、iotMqttPort プロパティを追加し、値を 443 に設定します (以下の例を参照)。

   {
       "coreThing" : {
           "caPath" : "root.ca.pem",
           "certPath" : "12345abcde.cert.pem",
           "keyPath" : "12345abcde.private.key",
           "thingArn" : "arn:aws:iot:us-west-2:123456789012:thing/core-thing-name",
           "iotHost" : "abcd123456wxyz-ats.iot.us-west-2.amazonaws.com",
           "iotMqttPort" : 443,
           "ggHost" : "greengrass-ats.iot.us-west-2.amazonaws.com",
           "keepAlive" : 600
       },
       ...
   }

4. デーモンを開始します。

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

ポート 443 を介した HTTPS を設定するには

この機能を使用するには、AWS IoT Greengrass Core v1.8 以降が必要です。

次の手順では、HTTPS コミュニケーションにポート 443 を使用するようコアを設定します。

1. 次のコマンドを実行して Greengrass デーモンを停止します。

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

2. greengrass-root/config/config.json を編集するために su ユーザーとして開きます。

3. coreThing オブジェクトで、以下の例に示すように、iotHttpPort および ggHttpPort プロパティを追加します。

   {
       "coreThing" : {
           "caPath" : "root.ca.pem",
           "certPath" : "12345abcde.cert.pem",
           "keyPath" : "12345abcde.private.key",
           "thingArn" : "arn:aws:iot:us-west-2:123456789012:thing/core-thing-name",
           "iotHost" : "abcd123456wxyz-ats.iot.us-west-2.amazonaws.com",
           "iotHttpPort" : 443,
           "ggHost" : "greengrass-ats.iot.us-west-2.amazonaws.com",
           "ggHttpPort" : 443,
           "keepAlive" : 600
       },
       ...
   }

4. デーモンを開始します。

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

ネットワークプロキシを設定するには

この機能を使用するには、AWS IoT Greengrass Core v1.7 以降が必要です。

次の手順では、HTTP または HTTPS ネットワークプロキシを介してインターネットに接続することを AWS IoT Greengrass に許可します。

1. 次のコマンドを実行して Greengrass デーモンを停止します。

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

2. greengrass-root/config/config.json を編集するために su ユーザーとして開きます。

3. coreThing オブジェクトで、以下の例に示すように、networkProxy オブジェクトを追加します。

   {
       "coreThing" : {
           "caPath" : "root.ca.pem",
           "certPath" : "12345abcde.cert.pem",
           "keyPath" : "12345abcde.private.key",
           "thingArn" : "arn:aws:iot:us-west-2:123456789012:thing/core-thing-name",
           "iotHost" : "abcd123456wxyz-ats.iot.us-west-2.amazonaws.com",
           "ggHost" : "greengrass-ats.iot.us-west-2.amazonaws.com",
           "keepAlive" : 600,
           "networkProxy": {
               "noProxyAddresses" : "http://128.12.34.56,www.mywebsite.com",
               "proxy" : {
                   "url" : "https://my-proxy-server:1100",
                   "username" : "Mary_Major",
                   "password" : "pass@word1357"
               }
           }
       },
       ...
   }

4. デーモンを開始します。

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

書き込みディレクトリを設定するには

1. 次のコマンドを実行して AWS IoT Greengrass デーモンを停止します。

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

2. greengrass-root/config/config.json を編集するために su ユーザーとして開きます。

3. 次の例に示すように、writeDirectory をパラメータとして追加し、ターゲットディレクトリへのパスを指定します。

   {
       "coreThing": {
           "caPath": "root-CA.pem",
           "certPath": "hash.pem.crt",
           ...
       },
       ...
       "writeDirectory" : "/write-directory"
   }

   注記

   writeDirectory 設定を必要に応じて更新することができます。設定を更新すると、AWS IoT Greengrass は新しく指定した書き込みディレクトリを次の起動時に使用しますが、前の書き込むディレクトリのコンテンツを移行することは行いません。

4. これで書き込みディレクトリは設定されため、オプションで greengrass-root ディレクトリを読み込み専用にできます。手順については、「Greengrass ルートディレクトリを読み取り専用にするには」を参照してください。

   それ以外の場合は、AWS IoT Greengrass デーモンを起動します。

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

Greengrass ルートディレクトリを読み取り専用にするには

このステップは、Greengrass ルートディレクトリを読み取り専用にする場合にのみ実行します。書き込みディレクトリは、開始する前に設定する必要があります。

1. 必要なディレクトリにアクセス許可を付与します。

   1. config.json の所有者に読み取りおよび書き込み権限を与えます。

      sudo chmod 0600 /greengrass-root/config/config.json

   2. ggc_user を certs とシステム Lambda ディレクトリの所有者とします。

      sudo chown -R ggc_user:ggc_group /greengrass-root/certs/
      sudo chown -R ggc_user:ggc_group /greengrass-root/ggc/packages/1.11.6/lambda/

      注記

      デフォルトでは、ggc_user および ggc_group アカウントを使用してシステム Lambda 関数が実行されます。グループレベルのデフォルトのアクセス ID を設定して個別のアカウントを使用する場合は、代わりにそのユーザー (UID) およびグループ (GID) にアクセス権限を付与する必要があります。

2. 任意のメカニズムを使用して、greengrass-root ディレクトリを読み取り専用にします。

   注記

   greengrass-root ディレクトリを読み取り専用にする 1 つの方法は、ディレクトリを読み取り専用としてマウントすることです。ただし、無線 (OTA) による更新をマウントされたディレクトリの AWS IoT Greengrass Core ソフトウェアに適用するには、このディレクトリをまずアンマウントしてから、更新後に再度マウントする必要があります。上記の umount と mount オペレーションを ota_pre_update および ota_post_update スクリプトに追加できます。OTA 更新の詳細については、「Greengrass OTA Update Agent」および「OTA 更新による管理された再生成」を参照してください。

3. デーモンを開始します。

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

   ステップ 1 のアクセス権限が正しく設定されていない場合、デーモンは起動しません。

1. ターゲットの Greengrass グループとグループのバージョンの ID を取得します。この手順では、これが最新のグループおよびグループのバージョンであると仮定します。次のクエリは、最後に作成されたグループを返します。

   aws greengrass list-groups --query "reverse(sort_by(Groups, &CreationTimestamp))[0]"

   または、名前でクエリを実行することもできます。グループ名は一意である必要はないため、複数のグループが返されることがあります。

   aws greengrass list-groups --query "Groups[?Name=='MyGroup']"

   注記

   これらの値は AWS IoT コンソールにもあります。グループ ID は、グループの [Settings (設定)] ページに表示されます。グループバージョン ID は、グループの [Deployments] (デプロイ) ページに表示されます。

2. 出力のターゲットグループから Id 値と LatestVersion 値をコピーします。

3. 最新のグループバージョンを取得します。

   • コピーした で group-idId を置換えます。

   • コピーした で latest-group-version-idLatestVersion を置換えます。

   aws greengrass get-group-version \
   --group-id group-id \
   --group-version-id latest-group-version-id

4. 出力の Definition オブジェクトから、CoreDefinitionVersionArn をコピーし、FunctionDefinitionVersionArn を除く他のすべてのグループコンポーネントの ARN もコピーします。上記の値は、新しいグループバージョン作成時に使用します。

5. 出力の FunctionDefinitionVersionArn で、関数定義の ID をコピーします。ID は、次の例に示すように、ARN の functions セグメントに続く GUID です。

   arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/bcfc6b49-beb0-4396-b703-6dEXAMPLEcu5/versions/0f7337b4-922b-45c5-856f-1aEXAMPLEsf6

   注記

   または、create-function-definition コマンドを実行して関数定義を作成し、出力から ID をコピーすることもできます。

6. 関数定義に関数定義バージョンを追加します。

   • 関数定義用にコピーした で function-definition-idId を置き換えます。

   • arbitrary-function-id を関数の名前 (spooler-function など) で置き換えます。

   • このバージョンで functions 配列に含める任意の Lambda 関数を追加します。get-function-definition-version コマンドを使用して、既存の関数定義バージョンから Greengrass Lambda 関数を取得できます。

   警告

   GG_CONFIG_MAX_SIZE_BYTES の値が 262144 以上に指定されていることを確認します。サイズが小さいと、AWS IoT Greengrass Core ソフトウェアを起動できなくなります。

   aws greengrass create-function-definition-version \
   --function-definition-id function-definition-id \
   --functions '[{"FunctionArn": "arn:aws:lambda:::function:GGCloudSpooler:1","FunctionConfiguration": {"Environment": {"Variables":{"GG_CONFIG_MAX_SIZE_BYTES":"2621440","GG_CONFIG_STORAGE_TYPE":"FileSystem"}},"Executable": "spooler","MemorySize": 32768,"Pinned": true,"Timeout": 3},"Id": "arbitrary-function-id"}]'

   注記

   AWS IoT Core で永続セッションをサポートするために GG_CONFIG_SUBSCRIPTION_QUALITY 環境変数を設定していた場合は、その変数をこの関数インスタンスに含めます。

7. 出力から 関数定義バージョンの Arn をコピーします。

8. システムの Lambda 関数が含まれているグループバージョンを作成します。

   • group-id をこのグループの Id で置き換えます。

   • 最新のグループバージョンからコピーした で core-definition-version-arnCoreDefinitionVersionArn を置換えます。

   • 新しい関数定義バージョンにコピーした で function-definition-version-arnArn を置換えます。

   • 最新のグループバージョンからコピーした他のグループコンポーネントの ARN (SubscriptionDefinitionVersionArn、DeviceDefinitionVersionArn など) を置き換えます。

   • 使用されていないパラメータをすべて削除します。例えば、グループバージョンにリソースがない場合には、--resource-definition-version-arn を削除します。

   aws greengrass create-group-version \
   --group-id group-id \
   --core-definition-version-arn core-definition-version-arn \
   --function-definition-version-arn function-definition-version-arn \
   --device-definition-version-arn device-definition-version-arn \
   --logger-definition-version-arn logger-definition-version-arn \
   --resource-definition-version-arn resource-definition-version-arn \
   --subscription-definition-version-arn subscription-definition-version-arn

9. 出力から Version をコピーします。これは新しいグループバージョンの ID です。

10. 新しいグループバージョンでグループをデプロイします。

    • group-id を、グループのコピー済み Id に置き換えます。

    • 新しいグループバージョンにコピーした で group-version-idVersion を置換えます。

    aws greengrass create-deployment \
    --group-id group-id \
    --group-version-id group-version-id \
    --deployment-type NewDeployment

1. ターゲットの Greengrass グループとグループのバージョンの ID を取得します。この手順では、これが最新のグループおよびグループのバージョンであると仮定します。次のクエリは、最後に作成されたグループを返します。

   aws greengrass list-groups --query "reverse(sort_by(Groups, &CreationTimestamp))[0]"

   または、名前でクエリを実行することもできます。グループ名は一意である必要はないため、複数のグループが返されることがあります。

   aws greengrass list-groups --query "Groups[?Name=='MyGroup']"

   注記

   これらの値は AWS IoT コンソールにもあります。グループ ID は、グループの [Settings (設定)] ページに表示されます。グループバージョン ID は、グループの [Deployments] (デプロイ) タブに表示されます。

2. 出力のターゲットグループから Id 値と LatestVersion 値をコピーします。

3. 最新のグループバージョンを取得します。

   • コピーした で group-idId を置換えます。

   • コピーした で latest-group-version-idLatestVersion を置換えます。

   aws greengrass get-group-version \
   --group-id group-id \
   --group-version-id latest-group-version-id

4. 出力の Definition オブジェクトから、CoreDefinitionVersionArn をコピーし、FunctionDefinitionVersionArn を除く他のすべてのグループコンポーネントの ARN もコピーします。上記の値は、新しいグループバージョン作成時に使用します。

5. 出力の FunctionDefinitionVersionArn で、関数定義の ID をコピーします。ID は、次の例に示すように、ARN の functions セグメントに続く GUID です。

   arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/bcfc6b49-beb0-4396-b703-6dEXAMPLEcu5/versions/0f7337b4-922b-45c5-856f-1aEXAMPLEsf6

   注記

   または、create-function-definition コマンドを実行して関数定義を作成し、出力から ID をコピーすることもできます。

6. 関数定義に関数定義バージョンを追加します。

   • 関数定義用にコピーした で function-definition-idId を置き換えます。

   • arbitrary-function-id を関数の名前 (spooler-function など) で置き換えます。

   • このバージョンで functions 配列に含める任意の Lambda 関数を追加します。get-function-definition-version コマンドを使用して、既存の関数定義バージョンから Greengrass Lambda 関数を取得できます。

   aws greengrass create-function-definition-version \
   --function-definition-id function-definition-id \
   --functions '[{"FunctionArn": "arn:aws:lambda:::function:GGCloudSpooler:1","FunctionConfiguration": {"Environment": {"Variables":{"GG_CONFIG_SUBSCRIPTION_QUALITY":"AtLeastOncePersistent"}},"Executable": "spooler","MemorySize": 32768,"Pinned": true,"Timeout": 3},"Id": "arbitrary-function-id"}]'

   注記

   ストレージ設定を定義するために GG_CONFIG_STORAGE_TYPE または GG_CONFIG_MAX_SIZE_BYTES 環境変数を設定していた場合は、この関数インスタンスにそれらの変数を含めます。

7. 出力から 関数定義バージョンの Arn をコピーします。

8. システムの Lambda 関数が含まれているグループバージョンを作成します。

   • group-id をこのグループの Id で置き換えます。

   • 最新のグループバージョンからコピーした で core-definition-version-arnCoreDefinitionVersionArn を置換えます。

   • 新しい関数定義バージョンにコピーした で function-definition-version-arnArn を置換えます。

   • 最新のグループバージョンからコピーした他のグループコンポーネントの ARN (SubscriptionDefinitionVersionArn、DeviceDefinitionVersionArn など) を置き換えます。

   • 使用されていないパラメータをすべて削除します。例えば、グループバージョンにリソースがない場合には、--resource-definition-version-arn を削除します。

   aws greengrass create-group-version \
   --group-id group-id \
   --core-definition-version-arn core-definition-version-arn \
   --function-definition-version-arn function-definition-version-arn \
   --device-definition-version-arn device-definition-version-arn \
   --logger-definition-version-arn logger-definition-version-arn \
   --resource-definition-version-arn resource-definition-version-arn \
   --subscription-definition-version-arn subscription-definition-version-arn

9. 出力から Version をコピーします。これは新しいグループバージョンの ID です。

10. 新しいグループバージョンでグループをデプロイします。

    • group-id を、グループのコピー済み Id に置き換えます。

    • 新しいグループバージョンにコピーした で group-version-idVersion を置換えます。

    aws greengrass create-deployment \
    --group-id group-id \
    --group-version-id group-version-id \
    --deployment-type NewDeployment

11. (オプション) コア設定ファイルの maxWorkItemCount プロパティを増やします。これにより、コアは増加した MQTT トラフィックとローカルターゲットとの通信を処理できます。

コアがローカル MQTT トラフィックに使用するポート番号を設定するには

1. 次のコマンドを実行して Greengrass デーモンを停止します。

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

2. greengrass-root/config/config.json を編集するために su ユーザーとして開きます。

3. coreThing オブジェクトで ggMqttPort プロパティを追加し、使用するポート番号に値を設定します。有効な値は 1024～65535 です。次の例では、ポート番号を 9000 に設定します。

   {
       "coreThing" : {
           "caPath" : "root.ca.pem",
           "certPath" : "12345abcde.cert.pem",
           "keyPath" : "12345abcde.private.key",
           "thingArn" : "arn:aws:iot:us-west-2:123456789012:thing/core-thing-name",
           "iotHost" : "abcd123456wxyz-ats.iot.us-west-2.amazonaws.com",
           "ggHost" : "greengrass-ats.iot.us-west-2.amazonaws.com",
           "ggMqttPort" : 9000,
           "keepAlive" : 600
       },
       ...
   }

4. デーモンを開始します。

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

5. コアに対して自動 IP 検出が有効になっている場合、設定は完了です。

   自動 IP 検出が有効になっていない場合は、コアの接続情報を更新する必要があります。これにより、クライアントデバイスは検出操作中に正しいポート番号を受け取り、コア接続情報を取得できるようになります。AWS IoT コンソールまたは AWS IoT Greengrass API を使用して、コア接続情報を更新できます。この手順では、ポート番号のみを更新します。コアのローカル IP アドレスは同じままです。

   コアの接続情報を更新するには (コンソール)

   1. グループ設定ページで、Greengrass コアを選択します。

   2. コアの詳細ページで、[MQTT broker endpoints] (MQTT ブローカーエンドポイント) タブを選択します。

   3. [Manage endpoints] (管理エンドポイント) を選択し、続いて [Add endpoint] (エンドポイントの追加) を選択します。

   4. 現在のローカル IP アドレスと新しいポート番号を入力します。次の例では、IP アドレス 192.168.1.8 のポート番号 9000 を設定します。

   5. 古いエンドポイントを削除し、[Update (更新)] を選択します。

   コアの接続情報を更新します (API)

   • [UpdateConnectivityInfo] アクションを使用します。次の例では、AWS CLI で update-connectivity-info を使用して IP アドレス 192.168.1.8 のポート番号 9000 を設定します。

     aws greengrass update-connectivity-info \
         --thing-name "MyGroup_Core" \
         --connectivity-info "[{\"Metadata\":\"\",\"PortNumber\":9000,\"HostAddress\":\"192.168.1.8\",\"Id\":\"localIP_192.168.1.8\"},{\"Metadata\":\"\",\"PortNumber\":8883,\"HostAddress\":\"127.0.0.1\",\"Id\":\"localhost_127.0.0.1_0\"}]"

   注記

   コアが AWS IoT Core との MQTT メッセージングに使用するポートを設定することもできます。詳細については、「ポート 443 での接続またはネットワークプロキシを通じた接続」を参照してください。

1. ターゲットの Greengrass グループとグループのバージョンの ID を取得します。この手順では、これが最新のグループおよびグループのバージョンであると仮定します。次のクエリは、最後に作成されたグループを返します。

   aws greengrass list-groups --query "reverse(sort_by(Groups, &CreationTimestamp))[0]"

   または、名前でクエリを実行することもできます。グループ名は一意である必要はないため、複数のグループが返されることがあります。

   aws greengrass list-groups --query "Groups[?Name=='MyGroup']"

   注記

   これらの値は AWS IoT コンソールにもあります。グループ ID は、グループの [Settings (設定)] ページに表示されます。グループバージョン ID は、グループの [Deployments] (デプロイ) タブに表示されます。

2. 出力のターゲットグループから Id 値と LatestVersion 値をコピーします。

3. 最新のグループバージョンを取得します。

   • コピーした で group-idId を置換えます。

   • コピーした で latest-group-version-idLatestVersion を置換えます。

   aws greengrass get-group-version \
   --group-id group-id \
   --group-version-id latest-group-version-id

4. 出力の Definition オブジェクトから、CoreDefinitionVersionArn をコピーし、FunctionDefinitionVersionArn を除く他のすべてのグループコンポーネントの ARN もコピーします。上記の値は、新しいグループバージョン作成時に使用します。

5. 出力の FunctionDefinitionVersionArn で、関数定義の ID と関数定義のバージョンをコピーします。

   arn:aws:greengrass:region:account-id:/greengrass/groups/function-definition-id/versions/function-definition-version-id

   注記

   必要に応じて、create-function-definition コマンドを実行して関数定義を作成し、出力から ID をコピーすることもできます。

6. 現在の定義状態を取得するには、get-function-definition-version コマンドを使用します。関数定義用にコピーした function-definition-id を使用します。例えば、4d941bc7-92a1-4f45-8d64-EXAMPLEf76c3 です。

   aws greengrass get-function-definition-version
   --function-definition-id function-definition-id
   --function-definition-version-id function-definition-version-id
                   

   リストされている関数設定をメモしておきます。現在の定義設定が失われるのを防ぐために、新しい関数定義バージョンを作成するときにこれらを含める必要があります。

7. 関数定義に関数定義バージョンを追加します。

   • 関数定義用にコピーした で function-definition-idId を置き換えます。例えば、4d941bc7-92a1-4f45-8d64-EXAMPLEf76c3 です。

   • arbitrary-function-id を関数の名前 (auto-detection-function など) で置き換えます。

   • このバージョンに含めるすべての Lambda 関数を functions 配列に追加します (前の手順でリストしたものなど)。

   aws greengrass create-function-definition-version \
   --function-definition-id function-definition-id \
   --functions '[{"FunctionArn":"arn:aws:lambda:::function:GGIPDetector:1","Id":"arbitrary-function-id","FunctionConfiguration":{"Pinned":true,"MemorySize":32768,"Timeout":3}}]'\
   --region us-west-2

8. 出力から 関数定義バージョンの Arn をコピーします。

9. システムの Lambda 関数が含まれているグループバージョンを作成します。

   • group-id をこのグループの Id で置き換えます。

   • 最新のグループバージョンからコピーした で core-definition-version-arnCoreDefinitionVersionArn を置換えます。

   • 新しい関数定義バージョンにコピーした で function-definition-version-arnArn を置換えます。

   • 最新のグループバージョンからコピーした他のグループコンポーネントの ARN (SubscriptionDefinitionVersionArn、DeviceDefinitionVersionArn など) を置き換えます。

   • 使用されていないパラメータをすべて削除します。例えば、グループバージョンにリソースがない場合には、--resource-definition-version-arn を削除します。

   aws greengrass create-group-version \
   --group-id group-id \
   --core-definition-version-arn core-definition-version-arn \
   --function-definition-version-arn function-definition-version-arn \
   --device-definition-version-arn device-definition-version-arn \
   --logger-definition-version-arn logger-definition-version-arn \
   --resource-definition-version-arn resource-definition-version-arn \
   --subscription-definition-version-arn subscription-definition-version-arn

10. 出力から Version をコピーします。これは新しいグループバージョンの ID です。

11. 新しいグループバージョンでグループをデプロイします。

    • group-id を、グループのコピー済み Id に置き換えます。

    • 新しいグループバージョンにコピーした で group-version-idVersion を置換えます。

    aws greengrass create-deployment \
    --group-id group-id \
    --group-version-id group-version-id \
    --deployment-type NewDeployment