AWS IoT Greengrass Core の設定 - AWS IoT Greengrass

のドキュメントを表示していますAWS IoT Greengrass Version 1。AWS IoT Greengrass Version 2の最新のメジャーバージョンです。AWS IoT Greengrass。の使用方法の詳細については、「」を参照してください。AWS IoT Greengrass V2の詳細については、AWS IoT Greengrass Version 2開発者ガイド

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

AWS IoT Greengrass Core の設定

あんAWS IoT GreengrassCore はAWS IoTエッジ環境でハブまたはゲートウェイとして機能する Thing (デバイス)。他の AWS IoT デバイスと同様に、コアはレジストリ内にあり、デバイスシャドウを保持し、デバイス証明書を使用して AWS IoT Core および AWS IoT Greengrass を認証します。コアデバイスは AWS IoT Greengrass Core ソフトウェアを実行します。これによって、通信、車道同期やトークン交換などの Greengrass グループのローカルプロセスを管理することができます。

AWS IoT Greengrass Core ソフトウェアには、以下の機能が用意されています。

  • デプロイメントとコネクタと Lambda 関数のローカル実行。

  • データストリームをローカルで処理し、 AWS クラウド 。

  • マネージドサブスクリプションを使用して、デバイス、コネクタ、および Lambda 関数間のローカルネットワークを介した MQTT メッセージング。

  • MQTT メッセージングAWS IoTマネージドサブスクリプションを使用して、デバイス、コネクタ、および Lambda 関数を使用できます。

  • デバイスと AWS クラウド デバイスの認証と承認を使用した。

  • デバイスのローカルシャドウ同期。シャドウは AWS クラウド 。

  • ローカルデバイスとボリュームリソースへの制御されたアクセス。

  • ローカル推論を実行するためにクラウドでトレーニングされた機械学習モデルのデプロイ。

  • デバイスで Greengrass コアデバイスを検出するための IP アドレス自動検出。

  • 新規作成または更新されたグループ設定の一元的デプロイ。設定データをダウンロードすると、コアデバイスが自動的に再起動されます。

  • ユーザー定義の Lambda 関数の安全な無線通信経由 (OTA) のソフトウェア更新。

  • コネクタと Lambda 関数で制御される、ローカルシークレットの安全な暗号化されたストレージ。

AWS IoT Greengrass Core 設定ファイル

AWS IoT Greengrass Core ソフトウェアの設定ファイルは config.json です。このファイルは、/greengrass-root/config ディレクトリにあります。

注記

greengrass-root は、デバイスで AWS IoT Greengrass Core ソフトウェアがインストールされているパスを表します。通常、これは /greengrass ディレクトリです。

[] を使用する場合グループ作成のデフォルト値オプションからAWS IoT Greengrassコンソールでconfig.jsonファイルは、コアデバイスに動作状態でデプロイされます。

以下のコマンドを実行して、このファイルのコンテンツを確認できます。

cat /greengrass-root/config/config.json

次は、config.json ファイルの例です。これは、からコアを作成するときに生成されるバージョンです。AWS IoT Greengrassconsole.

GGC v1.11
{ "coreThing": { "caPath": "root.ca.pem", "certPath": "hash.cert.pem", "keyPath": "hash.private.key", "thingArn": "arn:partition:iot:region:account-id:thing/core-thing-name", "iotHost": "host-prefix-ats.iot.region.amazonaws.com", "ggHost": "greengrass-ats.iot.region.amazonaws.com", "keepAlive": 600, "ggDaemonPort": 8000, "systemComponentAuthTimeout": 5000 }, "runtime": { "maxWorkItemCount": 1024, "maxConcurrentLimit": 25, "lruSize": 25, "mountAllBlockDevices": "no", "cgroup": { "useSystemd": "yes" } }, "managedRespawn": false, "crypto": { "principals": { "SecretsManager": { "privateKeyPath": "file:///greengrass/certs/hash.private.key" }, "IoTCertificate": { "privateKeyPath": "file:///greengrass/certs/hash.private.key", "certificatePath": "file:///greengrass/certs/hash.cert.pem" } }, "caPath": "file:///greengrass/certs/root.ca.pem" }, "writeDirectory": "/var/snap/aws-iot-greengrass/current/ggc-write-directory", "pidFileDirectory": "/var/snap/aws-iot-greengrass/current/pidFileDirectory" }

config.json ファイルは以下のプロパティをサポートしています。

coreThing

フィールド 説明 コメント
caPath

/greengrass-root/certs ディレクトリへの AWS IoT ルート CA の相対パス。

1.7.0 より前のバージョンとの下位互換性のために。このプロパティは、cryptoオブジェクトが存在することを確認します。

注記
certPath

/greengrass-root/certs ディレクトリへの Core デバイス証明書の相対パス。

1.7.0 より前のバージョンとの下位互換性のために。このプロパティは、cryptoオブジェクトが存在することを確認します。
keyPath /greengrass-root/certs ディレクトリへの Core プライベートキーの相対パス。 1.7.0 より前のバージョンとの下位互換性のために。このプロパティは、cryptoオブジェクトが存在することを確認します。
thingArn の Amazon リソースネーム (ARN)AWS IoTを表すモノ。AWS IoT GreengrassCore デバイス。 コアの ARN は、AWS IoT Greengrassコンソールコアを実行するか、aws greengrass get-core-definition-versionCLI コマンド。
iotHost AWS IoT エンドポイント。

エンドポイントをAWS IoTコンソール設定を実行するか、aws iot describe-endpoint --endpoint-type iot:Data-ATSCLI コマンド。

このコマンドは Amazon Trust Services (ATS) エンドポイントを返します。詳細については、「サーバー認証」のドキュメントを参照してください。

注記

次のことを確認してください。エンドポイントは証明書タイプに対応しています

次のことを確認してください。エンドポイントは AWS リージョン

ggHost AWS IoT Greengrass エンドポイント。

これはあなたのiotHostエンドポイントに、ホストプレフィックスがgreengrass(たとえば、greengrass-ats.iot.region.amazonaws.com). 同じ を使用すること AWS リージョン としてiotHost

注記

次のことを確認してください。エンドポイントは証明書タイプに対応しています

次のことを確認してください。エンドポイントは AWS リージョン

iotMqttPort オプション。AWS IoT との MQTT 通信に使用するポート番号。 有効な値は 8883 または 443 です。デフォルト値は 8883 です。詳細については、「ポート 443 での接続またはネットワークプロキシを通じた接続」を参照してください。
iotHttpPort オプション。AWS IoT への HTTPS 接続を確立するために使用されるポート番号。 有効な値は 8443 または 443 です。デフォルト値は 8443 です。詳細については、「ポート 443 での接続またはネットワークプロキシを通じた接続」を参照してください。
ggMqttPort オプション。ローカルネットワーク経由の MQTT 通信に使用するポート番号。 有効な値は 102465535 です。デフォルト値は 8883 です。詳細については、「ローカルメッセージング用の MQTT ポートの設定」を参照してください。
ggHttpPort オプション。AWS IoT Greengrass サービスへの HTTPS 接続を確立するために使用されるポート番号。 有効な値は 8443 または 443 です。デフォルト値は 8443 です。詳細については、「ポート 443 での接続またはネットワークプロキシを通じた接続」を参照してください。
keepAlive オプション。MQTT KeepAlive 期間 (秒単位)。 有効な範囲は 30~1200 秒です。デフォルト値は 600 です。
networkProxy オプション。接続先のプロキシサーバーを定義するオブジェクト。 プロキシサーバーには、HTTP または HTTPS を使用できます。詳細については、「ポート 443 での接続またはネットワークプロキシを通じた接続」を参照してください。
mqttOperationTimeout オプション。Greengrass コアが AWS IoT Core への MQTT 接続で発行、サブスクリプション、またはサブスクリプション解除オペレーションを完了するまでの時間 (秒単位)。 デフォルト値は 5 です。最小値は 5 です。
ggDaemonPort オプション。Greengrass コア IPC ポート番号。

このプロパティは、「」にあります。AWS IoT Greengrassv1.11.0 以降。

有効な値は 1024 ~ 65535 です。デフォルト値は 8000 です。

systemComponentAuthTimeout オプション。Greengrass コア IPC が認証を完了するまでの時間(ミリ秒単位)。

このプロパティは、「」にあります。AWS IoT Greengrassv1.11.0 以降。

有効な値は 500~5000 です。デフォルト値は 5000 です。

runtime

フィールド 説明 コメント
maxWorkItemCount

オプション。Greengrass デーモンが一度に処理できる作業項目の最大数。この制限を超える作業項目は無視されます。

作業項目キューは、システムコンポーネント、ユーザー定義 Lambda 関数、コネクタによって共有されます。

デフォルト値は 1024 です。最大値は、デバイスのハードウェアによって制限されます。

この値を増やすと、AWS IoT Greengrass が使用するメモリが増加します。コアが大量の MQTT メッセージトラフィックを受信することが予想される場合は、この値を増やすことができます。

最大コンカレントリミット

オプション。Greengrass デーモンが持つことができる同時固定されていない Lambda ワーカーの最大数。このパラメーターを上書きするには、異なる整数を指定できます。

デフォルト値は 25 です。最小値は、によって定義されます。lruSize

LruSize Optional. Defines the minimum value for 最大コンカレントリミット. The default value is 25.
マウント・ブロック・デバイス Optional. Enables AWS IoT Greengrass to use bind mounts to mount all block devices into a container after setting up the OverlayFS.

このプロパティは、「」にあります。AWS IoT Greengrassv1.11.0 以降が存在することを確認します。

有効な値は、yes および no です。デフォルト値は no です。

この値はに設定します。yes側の/usrディレクトリが/階層。

ポストスタールチェックタイムアウト Optional. The time (in milliseconds) after starting that the Greengrass daemon waits for the health check to finish. The default timeout is 30 seconds (30000 ms).
cgroup
システムシステムを使用する Indicates whether your device uses systemd. Valid values are はい or いいえ. Run the dependencies script in モジュール 1 to see if your device uses systemd.

crypto

crypto には、PKCS#11 を使用したハードウェアセキュリティモジュール (HSM) でのプライベートキーストレージをサポートするプロパティと、ローカルでのシークレットストレージをサポートするプロパティが含まれています。詳細については、「AWS IoT Greengrass Core セキュリティプリンシパル」、「ハードウェアセキュリティ統合」、および「AWS IoT Greengrass Core にシークレットをデプロイする」を参照してください。HSM またはファイルシステムでのプライベートキーストレージの設定がサポートされています。

フィールド 説明 コメント
キャパス

AWS IoT ルート CA への絶対パス。

次の形式のファイルの URI である必要があります。file:///absolute/path/to/file

注記

次のことを確認してください。エンドポイントは証明書タイプに対応しています

PKCS11
OpenSSLengine

オプション。OpenSSL での PKCS#11 のサポートを有効にするための、OpenSSL エンジン .so ファイルへの絶対パス。

ファイルシステム上のファイルへのパスあることが必要です。

ハードウェアセキュリティで Greengrass OTA 更新エージェントを使用している場合、このプロパティは必須です。詳細については、「無線通信経由更新のサポートを設定する」を参照してください。

Provider

PKCS#11 実装の libdl-loadable ライブラリへの絶対パス。

ファイルシステム上のファイルへのパスあることが必要です。

スロットラベル

ハードウェアモジュールを識別するために使用されるスロットラベル。

PKCS#11 ラベル仕様に準拠していることが必要です。

スロットユーザーピン

Greengrass Core をモジュールに対して認証するために使用されるユーザー PIN。

設定されたプライベートキーで C_Sign を実行するのに十分なアクセス許可があることが必要です。

principals
IOT証明書 The certificate and private key that the core uses to make requests to AWS IoT.
IOT証明書.privateKeypath

Core プライベートキーへのパス。

ファイルシステムストレージの場合、次の形式のファイルの URI である必要があります。file:///absolute/path/to/file

HSM ストレージの場合、オブジェクトラベルを指定する RFC 7512 PKCS#11 パスである必要があります。

IOT証明書.証明書パス

コアデバイスの証明書への絶対パス。

次の形式のファイルの URI である必要があります。file:///absolute/path/to/file

MQTTサーバー証明書

オプション。Core が MQTT サーバーまたはゲートウェイとして機能するために証明書と組み合わせて使用するプライベートキー。

MQTTサーバー証明書.プライベートキーパス

ローカル MQTT サーバーのプライベートキーへのパス。

この値を使用して、ローカル MQTT サーバーの独自のプライベートキーを指定します。

ファイルシステムストレージの場合、次の形式のファイルの URI である必要があります。file:///absolute/path/to/file

HSM ストレージの場合、オブジェクトラベルを指定する RFC 7512 PKCS#11 パスである必要があります。

このプロパティを省略すると、AWS IoT Greengrass は更新設定に基づいてキーを更新します。指定した場合は、お客様がキーを更新する必要があります。

SecretsManager The private key that secures the data key used for encryption. For more information, see AWS IoT Greengrass Core にシークレットをデプロイする.
Secretsmanager.

ローカル Secrets Manager のプライベートキーへのパス。

RSA キーのみがサポートされています。

ファイルシステムストレージの場合、次の形式のファイルの URI である必要があります。file:///absolute/path/to/file

HSM ストレージの場合、オブジェクトラベルを指定する RFC 7512 PKCS#11 パスである必要があります。PKCS#1 v1.5 パディング方式を使用してプライベートキーを生成する必要があります。

以下の設定プロパティもサポートされています。

フィールド 説明 コメント
mqttMaxConnectionRetryInterval

オプション。MQTT 接続間の最大間隔 (秒数) は、接続がドロップした場合に再試行します。

この値を符号なしの整数として指定します。デフォルト: 60

managedRespawn

オプション。OTA エージェントが更新前にカスタムコードを実行する必要があることを示します。

有効な値は true または false です。詳細については、「AWS IoT Greengrass Core ソフトウェアの OTA 更新」を参照してください。

writeDirectory

オプション。書き込みディレクトリ。AWS IoT Greengrassはすべての読み取り/書き込みリソースを作成します。

詳細については、「AWS IoT Greengrass の書き込みディレクトリの設定」を参照してください。

PIDファイルディレクトリ

オプション。AWS IoT Greengrassは、プロセスID (PID) をこのディレクトリに保存します。

デフォルト値は /var/run です。

GGC v1.10
{ "coreThing" : { "caPath" : "root.ca.pem", "certPath" : "hash.cert.pem", "keyPath" : "hash.private.key", "thingArn" : "arn:partition:iot:region:account-id:thing/core-thing-name", "iotHost" : "host-prefix-ats.iot.region.amazonaws.com", "ggHost" : "greengrass-ats.iot.region.amazonaws.com", "keepAlive" : 600, "systemComponentAuthTimeout": 5000 }, "runtime" : { "maxWorkItemCount" : 1024, "maxConcurrentLimit" : 25, "lruSize": 25, "cgroup" : { "useSystemd" : "yes" } }, "managedRespawn" : false, "crypto" : { "principals" : { "SecretsManager" : { "privateKeyPath" : "file:///greengrass/certs/hash.private.key" }, "IoTCertificate" : { "privateKeyPath" : "file:///greengrass/certs/hash.private.key", "certificatePath" : "file:///greengrass/certs/hash.cert.pem" } }, "caPath" : "file:///greengrass/certs/root.ca.pem" } }

config.json ファイルは以下のプロパティをサポートしています。

coreThing

フィールド 説明 コメント
caPath

/greengrass-root/certs ディレクトリへの AWS IoT ルート CA の相対パス。

1.7.0 より前のバージョンとの下位互換性のために。このプロパティは、ときに無視されます。cryptoオブジェクトが存在することを確認します。

注記
certPath

/greengrass-root/certs ディレクトリへの Core デバイス証明書の相対パス。

1.7.0 より前のバージョンとの下位互換性のために。このプロパティは、cryptoオブジェクトが存在することを確認します。
keyPath /greengrass-root/certs ディレクトリへの Core プライベートキーの相対パス。 1.7.0 より前のバージョンとの下位互換性のために。このプロパティは、ときに無視されます。cryptoオブジェクトが存在することを確認します。
thingArn の Amazon リソースネーム (ARN)AWS IoTを表すモノ。AWS IoT GreengrassCore デバイス。 コアの ARN は、AWS IoT Greengrassコンソールでコアを実行するか、aws greengrass get-core-definition-versionCLI コマンド。
iotHost AWS IoT エンドポイント。

エンドポイントをAWS IoTコンソールで設定を実行するか、aws iot describe-endpoint --endpoint-type iot:Data-ATSCLI コマンド。

このコマンドは Amazon Trust Services (ATS) エンドポイントを返します。詳細については、「サーバー認証」のドキュメントを参照してください。

注記

次のことを確認してください。エンドポイントは、証明書タイプに対応しています。

次のことを確認してください。エンドポイントは AWS リージョン

ggHost AWS IoT Greengrass エンドポイント。

これはあなたのiotHostエンドポイントに、ホストプレフィックスがgreengrass(たとえば、greengrass-ats.iot.region.amazonaws.com). 同じ を使用すること AWS リージョン としてiotHost

注記

次のことを確認してください。エンドポイントは、証明書タイプに対応しています。

次のことを確認してください。エンドポイントは AWS リージョン

iotMqttPort オプション。AWS IoT との MQTT 通信に使用するポート番号。 有効な値は 8883 または 443 です。デフォルト値は 8883 です。詳細については、「ポート 443 での接続またはネットワークプロキシを通じた接続」を参照してください。
iotHttpPort オプション。AWS IoT への HTTPS 接続を確立するために使用されるポート番号。 有効な値は 8443 または 443 です。デフォルト値は 8443 です。詳細については、「ポート 443 での接続またはネットワークプロキシを通じた接続」を参照してください。
ggMqttPort オプション。ローカルネットワーク経由の MQTT 通信に使用するポート番号。 有効な値は 102465535 です。デフォルト値は 8883 です。詳細については、「ローカルメッセージング用の MQTT ポートの設定」を参照してください。
ggHttpPort オプション。AWS IoT Greengrass サービスへの HTTPS 接続を確立するために使用されるポート番号。 有効な値は 8443 または 443 です。デフォルト値は 8443 です。詳細については、「ポート 443 での接続またはネットワークプロキシを通じた接続」を参照してください。
keepAlive オプション。MQTT KeepAlive 期間 (秒単位)。 有効な範囲は 30~1200 秒です。デフォルト値は 600 です。
networkProxy オプション。接続先のプロキシサーバーを定義するオブジェクト。 プロキシサーバーには、HTTP または HTTPS を使用できます。詳細については、「ポート 443 での接続またはネットワークプロキシを通じた接続」を参照してください。
mqttOperationTimeout オプション。Greengrass コアが AWS IoT Core への MQTT 接続で発行、サブスクリプション、またはサブスクリプション解除オペレーションを完了するまでの時間 (秒単位)。

このプロパティは AWS IoT Greengrass v1.10.2 以降で利用可能です。

デフォルト値は 5 です。最小値は 5 です。

runtime

フィールド 説明 コメント
maxWorkItemCount

オプション。Greengrass デーモンが一度に処理できる作業項目の最大数。この制限を超える作業項目は無視されます。

作業項目キューは、システムコンポーネント、ユーザー定義 Lambda 関数、コネクタによって共有されます。

デフォルト値は 1024 です。最大値は、デバイスのハードウェアによって制限されます。

この値を増やすと、AWS IoT Greengrass が使用するメモリが増加します。コアが大量の MQTT メッセージトラフィックを受信することが予想される場合は、この値を増やすことができます。

最大コンカレントリミット

オプション。Greengrass デーモンが持つことができる同時固定されていない Lambda ワーカーの最大数。このパラメーターを上書きするには、異なる整数を指定できます。

デフォルト値は 25 です。最小値は、によって定義されます。lruSize

LruSize Optional. Defines the minimum value for 最大コンカレントリミット. The default value is 25.
ポストスタールチェックタイムアウト Optional. The time (in milliseconds) after starting that the Greengrass daemon waits for the health check to finish. The default timeout is 30 seconds (30000 ms).
cgroup
システムシステムを使用する Indicates whether your device uses systemd. Valid values are はい or いいえ. Run the dependencies script in モジュール 1 to see if your device uses systemd.

crypto

crypto には、PKCS#11 を使用したハードウェアセキュリティモジュール (HSM) でのプライベートキーストレージをサポートするプロパティと、ローカルでのシークレットストレージをサポートするプロパティが含まれています。詳細については、「AWS IoT Greengrass Core セキュリティプリンシパル」、「ハードウェアセキュリティ統合」、および「AWS IoT Greengrass Core にシークレットをデプロイする」を参照してください。HSM またはファイルシステムでのプライベートキーストレージの設定がサポートされています。

フィールド 説明 コメント
キャパス

AWS IoT ルート CA への絶対パス。

次の形式のファイルの URI である必要があります。file:///absolute/path/to/file

注記
PKCS11
OpenSSLengine

オプション。OpenSSL での PKCS#11 のサポートを有効にするための、OpenSSL エンジン .so ファイルへの絶対パス。

ファイルシステム上のファイルへのパスあることが必要です。

ハードウェアセキュリティで Greengrass OTA 更新エージェントを使用している場合、このプロパティは必須です。詳細については、「無線通信経由更新のサポートを設定する」を参照してください。

Provider

PKCS#11 実装の libdl-loadable ライブラリへの絶対パス。

ファイルシステム上のファイルへのパスあることが必要です。

スロットラベル

ハードウェアモジュールを識別するために使用されるスロットラベル。

PKCS#11 ラベル仕様に準拠していることが必要です。

スロットユーザーピン

Greengrass Core をモジュールに対して認証するために使用されるユーザー PIN。

設定されたプライベートキーで C_Sign を実行するのに十分なアクセス許可があることが必要です。

principals
IOT証明書 The certificate and private key that the core uses to make requests to AWS IoT.
IOT証明書.privateKeypath

Core プライベートキーへのパス。

ファイルシステムストレージの場合、次の形式のファイルの URI である必要があります。file:///absolute/path/to/file

HSM ストレージの場合、オブジェクトラベルを指定する RFC 7512 PKCS#11 パスである必要があります。

IOT証明書.証明書パス

コアデバイスの証明書への絶対パス。

次の形式のファイルの URI である必要があります。file:///absolute/path/to/file

MQTTサーバー証明書

オプション。Core が MQTT サーバーまたはゲートウェイとして機能するために証明書と組み合わせて使用するプライベートキー。

MQTTサーバー証明書.プライベートキーパス

ローカル MQTT サーバーのプライベートキーへのパス。

この値を使用して、ローカル MQTT サーバーの独自のプライベートキーを指定します。

ファイルシステムストレージの場合、次の形式のファイルの URI である必要があります。file:///absolute/path/to/file

HSM ストレージの場合、オブジェクトラベルを指定する RFC 7512 PKCS#11 パスである必要があります。

このプロパティを省略すると、AWS IoT Greengrass は更新設定に基づいてキーを更新します。指定した場合は、お客様がキーを更新する必要があります。

SecretsManager The private key that secures the data key used for encryption. For more information, see AWS IoT Greengrass Core にシークレットをデプロイする.
Secretsmanager.

ローカル Secrets Manager のプライベートキーへのパス。

RSA キーのみがサポートされています。

ファイルシステムストレージの場合、次の形式のファイルの URI である必要があります。file:///absolute/path/to/file

HSM ストレージの場合、オブジェクトラベルを指定する RFC 7512 PKCS#11 パスである必要があります。PKCS#1 v1.5 パディング方式を使用してプライベートキーを生成する必要があります。

以下の設定プロパティもサポートされています。

フィールド 説明 コメント
mqttMaxConnectionRetryInterval

オプション。MQTT 接続間の最大間隔 (秒数) は、接続がドロップした場合に再試行します。

この値を符号なしの整数として指定します。デフォルト: 60

managedRespawn

オプション。OTA エージェントが更新前にカスタムコードを実行する必要があることを示します。

有効な値は true または false です。詳細については、「AWS IoT Greengrass Core ソフトウェアの OTA 更新」を参照してください。

writeDirectory

オプション。書き込みディレクトリ。AWS IoT Greengrassはすべての読み取り/書き込みリソースを作成します。

詳細については、「AWS IoT Greengrass の書き込みディレクトリの設定」を参照してください。

Deprecated versions

以下のバージョンの AWS IoT Greengrass Core ソフトウェアはサポートされていません。この情報は参照のみを目的として含まれています。

GGC v1.9
{ "coreThing" : { "caPath" : "root.ca.pem", "certPath" : "hash.cert.pem", "keyPath" : "hash.private.key", "thingArn" : "arn:partition:iot:region:account-id:thing/core-thing-name", "iotHost" : "host-prefix-ats.iot.region.amazonaws.com", "ggHost" : "greengrass-ats.iot.region.amazonaws.com", "keepAlive" : 600 }, "runtime" : { "cgroup" : { "useSystemd" : "yes" } }, "managedRespawn" : false, "crypto" : { "principals" : { "SecretsManager" : { "privateKeyPath" : "file:///greengrass/certs/hash.private.key" }, "IoTCertificate" : { "privateKeyPath" : "file:///greengrass/certs/hash.private.key", "certificatePath" : "file:///greengrass/certs/hash.cert.pem" } }, "caPath" : "file:///greengrass/certs/root.ca.pem" } }

config.json ファイルは以下のプロパティをサポートしています。

coreThing

フィールド 説明 コメント
caPath

/greengrass-root/certs ディレクトリへの AWS IoT ルート CA の相対パス。

1.7.0 より前のバージョンとの下位互換性のために。このプロパティは、cryptoオブジェクトが存在することを確認します。

注記
certPath

/greengrass-root/certs ディレクトリへの Core デバイス証明書の相対パス。

1.7.0 より前のバージョンとの下位互換性のために。このプロパティは、cryptoオブジェクトが存在することを確認します。
keyPath /greengrass-root/certs ディレクトリへの Core プライベートキーの相対パス。 1.7.0 より前のバージョンとの下位互換性のために。このプロパティは、cryptoオブジェクトが存在することを確認します。
thingArn の Amazon リソースネーム (ARN)AWS IoTを表すモノ。AWS IoT GreengrassCore デバイス。 コアの ARN は、AWS IoT Greengrassコンソールでコアを実行するか、aws greengrass get-core-definition-versionCLI コマンド。
iotHost AWS IoT エンドポイント。

エンドポイントをAWS IoTコンソールで設定を実行するか、aws iot describe-endpoint --endpoint-type iot:Data-ATSCLI コマンド。

このコマンドは Amazon Trust Services (ATS) エンドポイントを返します。詳細については、「サーバー認証」のドキュメントを参照してください。

注記

次のことを確認してください。エンドポイントは、証明書タイプに対応しています。

次のことを確認してください。エンドポイントは AWS リージョン

ggHost AWS IoT Greengrass エンドポイント。

これはあなたのiotHostエンドポイントに、ホストプレフィックスがgreengrass(たとえば、greengrass-ats.iot.region.amazonaws.com). 同じ を使用すること AWS リージョン としてiotHost

注記

次のことを確認してください。エンドポイントは、証明書タイプに対応しています。

次のことを確認してください。エンドポイントは AWS リージョン

iotMqttPort オプション。AWS IoT との MQTT 通信に使用するポート番号。 有効な値は 8883 または 443 です。デフォルト値は 8883 です。詳細については、「ポート 443 での接続またはネットワークプロキシを通じた接続」を参照してください。
iotHttpPort オプション。AWS IoT への HTTPS 接続を確立するために使用されるポート番号。 有効な値は 8443 または 443 です。デフォルト値は 8443 です。詳細については、「ポート 443 での接続またはネットワークプロキシを通じた接続」を参照してください。
ggHttpPort オプション。AWS IoT Greengrass サービスへの HTTPS 接続を確立するために使用されるポート番号。 有効な値は 8443 または 443 です。デフォルト値は 8443 です。詳細については、「ポート 443 での接続またはネットワークプロキシを通じた接続」を参照してください。
keepAlive オプション。MQTT KeepAlive 期間 (秒単位)。 有効な範囲は 30~1200 秒です。デフォルト値は 600 です。
networkProxy オプション。接続先のプロキシサーバーを定義するオブジェクト。 プロキシサーバーには、HTTP または HTTPS を使用できます。詳細については、「ポート 443 での接続またはネットワークプロキシを通じた接続」を参照してください。

runtime

フィールド 説明 コメント
最大コンカレントリミット

オプション。Greengrass デーモンが持つことができる同時固定されていない Lambda ワーカーの最大数。このパラメーターを上書きするには、異なる整数を指定できます。

デフォルト値は 25 です。最小値は、によって定義されます。lruSize

LruSize Optional. Defines the minimum value for 最大コンカレントリミット. The default value is 25.
ポストスタールチェックタイムアウト Optional. The time (in milliseconds) after starting that the Greengrass daemon waits for the health check to finish. The default timeout is 30 seconds (30000 ms).
cgroup
システムシステムを使用する Indicates whether your device uses systemd. Valid values are はい or いいえ. Run the dependencies script in モジュール 1 to see if your device uses systemd.

crypto

crypto オブジェクトが v1.7.0 で追加されました。このオブジェクトでは、PKCS#11 を使用したハードウェアセキュリティモジュール (HSM) でのプライベートキーストレージをサポートするプロパティと、ローカルでのシークレットストレージをサポートするプロパティを導入しています。詳細については、「AWS IoT Greengrass Core セキュリティプリンシパル」、「ハードウェアセキュリティ統合」、および「AWS IoT Greengrass Core にシークレットをデプロイする」を参照してください。HSM またはファイルシステムでのプライベートキーストレージの設定がサポートされています。

フィールド 説明 コメント
キャパス

AWS IoT ルート CA への絶対パス。

次の形式のファイルの URI である必要があります。file:///absolute/path/to/file

注記
PKCS11
OpenSSLengine

オプション。OpenSSL での PKCS#11 のサポートを有効にするための、OpenSSL エンジン .so ファイルへの絶対パス。

ファイルシステム上のファイルへのパスあることが必要です。

ハードウェアセキュリティで Greengrass OTA 更新エージェントを使用している場合、このプロパティは必須です。詳細については、「無線通信経由更新のサポートを設定する」を参照してください。

Provider

PKCS#11 実装の libdl-loadable ライブラリへの絶対パス。

ファイルシステム上のファイルへのパスあることが必要です。

スロットラベル

ハードウェアモジュールを識別するために使用されるスロットラベル。

PKCS#11 ラベル仕様に準拠していることが必要です。

スロットユーザーピン

Greengrass Core をモジュールに対して認証するために使用されるユーザー PIN。

設定されたプライベートキーで C_Sign を実行するのに十分なアクセス許可があることが必要です。

principals
IOT証明書 The certificate and private key that the core uses to make requests to AWS IoT.
IOT証明書.privateKeypath

Core プライベートキーへのパス。

ファイルシステムストレージの場合、次の形式のファイルの URI である必要があります。file:///absolute/path/to/file

HSM ストレージの場合、オブジェクトラベルを指定する RFC 7512 PKCS#11 パスである必要があります。

IOT証明書.証明書パス

コアデバイスの証明書への絶対パス。

次の形式のファイルの URI である必要があります。file:///absolute/path/to/file

MQTTサーバー証明書

オプション。Core が MQTT サーバーまたはゲートウェイとして機能するために証明書と組み合わせて使用するプライベートキー。

MQTTサーバー証明書.プライベートキーパス

ローカル MQTT サーバーのプライベートキーへのパス。

この値を使用して、ローカル MQTT サーバーの独自のプライベートキーを指定します。

ファイルシステムストレージの場合、次の形式のファイルの URI である必要があります。file:///absolute/path/to/file

HSM ストレージの場合、オブジェクトラベルを指定する RFC 7512 PKCS#11 パスである必要があります。

このプロパティを省略すると、AWS IoT Greengrass は更新設定に基づいてキーを更新します。指定した場合は、お客様がキーを更新する必要があります。

SecretsManager The private key that secures the data key used for encryption. For more information, see AWS IoT Greengrass Core にシークレットをデプロイする.
Secretsmanager.

ローカル Secrets Manager のプライベートキーへのパス。

RSA キーのみがサポートされています。

ファイルシステムストレージの場合、次の形式のファイルの URI である必要があります。file:///absolute/path/to/file

HSM ストレージの場合、オブジェクトラベルを指定する RFC 7512 PKCS#11 パスである必要があります。PKCS#1 v1.5 パディング方式を使用してプライベートキーを生成する必要があります。

以下の設定プロパティもサポートされています。

フィールド 説明 コメント
mqttMaxConnectionRetryInterval

オプション。MQTT 接続間の最大間隔 (秒数) は、接続がドロップした場合に再試行します。

この値を符号なしの整数として指定します。デフォルト: 60

managedRespawn

オプション。OTA エージェントが更新前にカスタムコードを実行する必要があることを示します。

有効な値は true または false です。詳細については、「AWS IoT Greengrass Core ソフトウェアの OTA 更新」を参照してください。

writeDirectory

オプション。書き込みディレクトリ。AWS IoT Greengrassはすべての読み取り/書き込みリソースを作成します。

詳細については、「AWS IoT Greengrass の書き込みディレクトリの設定」を参照してください。

GGC v1.8
{ "coreThing" : { "caPath" : "root.ca.pem", "certPath" : "hash.cert.pem", "keyPath" : "hash.private.key", "thingArn" : "arn:aws:iot:region:account-id:thing/core-thing-name", "iotHost" : "host-prefix-ats.iot.region.amazonaws.com", "ggHost" : "greengrass-ats.iot.region.amazonaws.com", "keepAlive" : 600 }, "runtime" : { "cgroup" : { "useSystemd" : "yes" } }, "managedRespawn" : false, "crypto" : { "principals" : { "SecretsManager" : { "privateKeyPath" : "file:///greengrass/certs/hash.private.key" }, "IoTCertificate" : { "privateKeyPath" : "file:///greengrass/certs/hash.private.key", "certificatePath" : "file:///greengrass/certs/hash.cert.pem" } }, "caPath" : "file:///greengrass/certs/root.ca.pem" } }

-config.jsonファイルは以下のプロパティをサポートしています。

coreThing

フィールド 説明 コメント
caPath

/greengrass-root/certs ディレクトリへの AWS IoT ルート CA の相対パス。

1.7.0 より前のバージョンとの下位互換性のために。このプロパティは、cryptoオブジェクトが存在することを確認します。

注記
certPath

/greengrass-root/certs ディレクトリへの Core デバイス証明書の相対パス。

1.7.0 より前のバージョンとの下位互換性のために。このプロパティは、cryptoオブジェクトが存在することを確認します。
keyPath /greengrass-root/certs ディレクトリへの Core プライベートキーの相対パス。 1.7.0 より前のバージョンとの下位互換性のために。このプロパティは、cryptoオブジェクトが存在することを確認します。
thingArn の Amazon リソースネーム (ARN)AWS IoTを表すモノ。AWS IoT GreengrassCore デバイス。 コアの ARN は、AWS IoT Greengrassコンソールコアを実行するか、aws greengrass get-core-definition-versionCLI コマンド。
iotHost AWS IoT エンドポイント。

エンドポイントをAWS IoTコンソール設定を実行するか、aws iot describe-endpoint --endpoint-type iot:Data-ATSCLI コマンド。

このコマンドは Amazon Trust Services (ATS) エンドポイントを返します。詳細については、「サーバー認証」のドキュメントを参照してください。

注記

次のことを確認してください。エンドポイントは、証明書タイプに対応しています。。[] を確認してください。エンドポイントは AWS リージョン

ggHost AWS IoT Greengrass エンドポイント。

これはあなたのiotHostエンドポイントに、ホストプレフィックスがgreengrass(たとえば、greengrass-ats.iot.region.amazonaws.com). 同じ を使用すること AWS リージョン としてiotHost

注記

次のことを確認してください。エンドポイントは、証明書タイプに対応しています。。[] を確認してください。エンドポイントは AWS リージョン

iotMqttPort オプション。AWS IoT との MQTT 通信に使用するポート番号。 有効な値は 8883 または 443 です。デフォルト値は 8883 です。詳細については、「ポート 443 での接続またはネットワークプロキシを通じた接続」を参照してください。
iotHttpPort オプション。AWS IoT への HTTPS 接続を確立するために使用されるポート番号。 有効な値は 8443 または 443 です。デフォルト値は 8443 です。詳細については、「ポート 443 での接続またはネットワークプロキシを通じた接続」を参照してください。
ggHttpPort オプション。AWS IoT Greengrass サービスへの HTTPS 接続を確立するために使用されるポート番号。 有効な値は 8443 または 443 です。デフォルト値は 8443 です。詳細については、「ポート 443 での接続またはネットワークプロキシを通じた接続」を参照してください。
keepAlive オプション。MQTT KeepAlive 期間 (秒単位)。 有効な範囲は 30~1200 秒です。デフォルト値は 600 です。
networkProxy オプション。接続先のプロキシサーバーを定義するオブジェクト。 プロキシサーバーには、HTTP または HTTPS を使用できます。詳細については、「ポート 443 での接続またはネットワークプロキシを通じた接続」を参照してください。

runtime

フィールド 説明 コメント
cgroup
システムシステムを使用する Indicates whether your device uses systemd. Valid values are はい or いいえ. Run the dependencies script in モジュール 1 to see if your device uses systemd.

crypto

crypto オブジェクトが v1.7.0 で追加されました。このオブジェクトでは、PKCS#11 を使用したハードウェアセキュリティモジュール (HSM) でのプライベートキーストレージをサポートするプロパティと、ローカルでのシークレットストレージをサポートするプロパティを導入しています。詳細については、「AWS IoT Greengrass Core セキュリティプリンシパル」、「ハードウェアセキュリティ統合」、および「AWS IoT Greengrass Core にシークレットをデプロイする」を参照してください。HSM またはファイルシステムでのプライベートキーストレージの設定がサポートされています。

フィールド 説明 コメント
キャパス

AWS IoT ルート CA への絶対パス。

次の形式のファイルの URI である必要があります。file:///absolute/path/to/file

注記
PKCS11
OpenSSLengine

オプション。OpenSSL での PKCS#11 のサポートを有効にするための、OpenSSL エンジン .so ファイルへの絶対パス。

ファイルシステム上のファイルへのパスあることが必要です。

ハードウェアセキュリティで Greengrass OTA 更新エージェントを使用している場合、このプロパティは必須です。詳細については、「無線通信経由更新のサポートを設定する」を参照してください。

Provider

PKCS#11 実装の libdl-loadable ライブラリへの絶対パス。

ファイルシステム上のファイルへのパスあることが必要です。

スロットラベル

ハードウェアモジュールを識別するために使用されるスロットラベル。

PKCS#11 ラベル仕様に準拠していることが必要です。

スロットユーザーピン

Greengrass Core をモジュールに対して認証するために使用されるユーザー PIN。

設定されたプライベートキーで C_Sign を実行するのに十分なアクセス許可があることが必要です。

principals
IOT証明書 The certificate and private key that the core uses to make requests to AWS IoT.
IOT証明書.privateKeypath

Core プライベートキーへのパス。

ファイルシステムストレージの場合、次の形式のファイルの URI である必要があります。file:///absolute/path/to/file

HSM ストレージの場合、オブジェクトラベルを指定する RFC 7512 PKCS#11 パスである必要があります。

IOT証明書.証明書パス

コアデバイスの証明書への絶対パス。

次の形式のファイルの URI である必要があります。file:///absolute/path/to/file

MQTTサーバー証明書

オプション。Core が MQTT サーバーまたはゲートウェイとして機能するために証明書と組み合わせて使用するプライベートキー。

MQTTサーバー証明書.プライベートキーパス

ローカル MQTT サーバーのプライベートキーへのパス。

この値を使用して、ローカル MQTT サーバーの独自のプライベートキーを指定します。

ファイルシステムストレージの場合、次の形式のファイルの URI である必要があります。file:///absolute/path/to/file

HSM ストレージの場合、オブジェクトラベルを指定する RFC 7512 PKCS#11 パスである必要があります。

このプロパティを省略すると、AWS IoT Greengrass は更新設定に基づいてキーを更新します。指定した場合は、お客様がキーを更新する必要があります。

SecretsManager The private key that secures the data key used for encryption. For more information, see AWS IoT Greengrass Core にシークレットをデプロイする.
Secretsmanager.

ローカル Secrets Manager のプライベートキーへのパス。

RSA キーのみがサポートされています。

ファイルシステムストレージの場合、次の形式のファイルの URI である必要があります。file:///absolute/path/to/file

HSM ストレージの場合、オブジェクトラベルを指定する RFC 7512 PKCS#11 パスである必要があります。PKCS#1 v1.5 パディング方式を使用してプライベートキーを生成する必要があります。

以下の設定プロパティもサポートされています。

フィールド 説明 コメント
mqttMaxConnectionRetryInterval

オプション。MQTT 接続間の最大間隔 (秒数) は、接続がドロップした場合に再試行します。

この値を符号なしの整数として指定します。デフォルト: 60

managedRespawn

オプション。OTA エージェントが更新前にカスタムコードを実行する必要があることを示します。

有効な値は true または false です。詳細については、「AWS IoT Greengrass Core ソフトウェアの OTA 更新」を参照してください。

writeDirectory

オプション。書き込みディレクトリ。AWS IoT Greengrassはすべての読み取り/書き込みリソースを作成します。

詳細については、「AWS IoT Greengrass の書き込みディレクトリの設定」を参照してください。

GGC v1.7
{ "coreThing" : { "caPath" : "root.ca.pem", "certPath" : "hash.cert.pem", "keyPath" : "hash.private.key", "thingArn" : "arn:aws:iot:region:account-id:thing/core-thing-name", "iotHost" : "host-prefix-ats.iot.region.amazonaws.com", "ggHost" : "greengrass-ats.iot.region.amazonaws.com", "keepAlive" : 600 }, "runtime" : { "cgroup" : { "useSystemd" : "yes" } }, "managedRespawn" : false, "crypto" : { "principals" : { "SecretsManager" : { "privateKeyPath" : "file:///greengrass/certs/hash.private.key" }, "IoTCertificate" : { "privateKeyPath" : "file:///greengrass/certs/hash.private.key", "certificatePath" : "file:///greengrass/certs/hash.cert.pem" } }, "caPath" : "file:///greengrass/certs/root.ca.pem" } }

config.json ファイルは以下のプロパティをサポートしています。

coreThing

フィールド 説明 コメント
caPath

/greengrass-root/certs ディレクトリへの AWS IoT ルート CA の相対パス。

1.7.0 より前のバージョンとの下位互換性のために。このプロパティは、cryptoオブジェクトが存在することを確認します。

注記

次のことを確認してください。エンドポイントは証明書タイプに対応しています

certPath

/greengrass-root/certs ディレクトリへの Core デバイス証明書の相対パス。

1.7.0 より前のバージョンとの下位互換性のために。このプロパティは、cryptoオブジェクトが存在することを確認します。
keyPath /greengrass-root/certs ディレクトリへの Core プライベートキーの相対パス。 1.7.0 より前のバージョンとの下位互換性のために。このプロパティは、cryptoオブジェクトが存在することを確認します。
thingArn の Amazon リソースネーム (ARN)AWS IoTを表すモノ。AWS IoT GreengrassCore デバイス。 コアの ARN は、AWS IoT Greengrassコンソールコアを実行するか、aws greengrass get-core-definition-versionCLI コマンド。
iotHost AWS IoT エンドポイント。

エンドポイントをAWS IoTコンソール設定を実行するか、aws iot describe-endpoint --endpoint-type iot:Data-ATSCLI コマンド。

このコマンドは Amazon Trust Services (ATS) エンドポイントを返します。詳細については、「サーバー認証」のドキュメントを参照してください。

注記

次のことを確認してください。エンドポイントは証明書タイプに対応しています。[] を確認してください。エンドポイントは AWS リージョン

ggHost AWS IoT Greengrass エンドポイント。

これはあなたのiotHostエンドポイントに、ホストプレフィックスがgreengrass(たとえば、greengrass-ats.iot.region.amazonaws.com). 同じ を使用すること AWS リージョン としてiotHost

注記

次のことを確認してください。エンドポイントは証明書タイプに対応しています。[] を確認してください。エンドポイントは AWS リージョン

iotMqttPort オプション。AWS IoT との MQTT 通信に使用するポート番号。 有効な値は 8883 または 443 です。デフォルト値は 8883 です。詳細については、「ポート 443 での接続またはネットワークプロキシを通じた接続」を参照してください。
keepAlive オプション。MQTT KeepAlive 期間 (秒単位)。 有効な範囲は 30~1200 秒です。デフォルト値は 600 です。
networkProxy オプション。接続先のプロキシサーバーを定義するオブジェクト。 プロキシサーバーには、HTTP または HTTPS を使用できます。詳細については、「ポート 443 での接続またはネットワークプロキシを通じた接続」を参照してください。

runtime

フィールド 説明 コメント
cgroup
システムシステムを使用する Indicates whether your device uses systemd. Valid values are はい or いいえ. Run the dependencies script in モジュール 1 to see if your device uses systemd.

crypto

v1.7.0 に追加された crypto オブジェクトでは、PKCS#11 を使用したハードウェアセキュリティモジュール (HSM) でのプライベートキーストレージをサポートするプロパティと、ローカルでのシークレットストレージをサポートするプロパティを導入しています。詳細については、「ハードウェアセキュリティ統合」および「AWS IoT Greengrass Core にシークレットをデプロイする」を参照してください。HSM またはファイルシステムでのプライベートキーストレージの設定がサポートされています。

フィールド 説明 コメント
キャパス

AWS IoT ルート CA への絶対パス。

次の形式のファイルの URI である必要があります。file:///absolute/path/to/file

注記

次のことを確認してください。エンドポイントは証明書タイプに対応しています

PKCS11
OpenSSLengine

オプション。OpenSSL での PKCS#11 のサポートを有効にするための、OpenSSL エンジン .so ファイルへの絶対パス。

ファイルシステム上のファイルへのパスあることが必要です。

ハードウェアセキュリティで Greengrass OTA 更新エージェントを使用している場合、このプロパティは必須です。詳細については、「無線通信経由更新のサポートを設定する」を参照してください。

Provider

PKCS#11 実装の libdl-loadable ライブラリへの絶対パス。

ファイルシステム上のファイルへのパスあることが必要です。

スロットラベル

ハードウェアモジュールを識別するために使用されるスロットラベル。

PKCS#11 ラベル仕様に準拠していることが必要です。

スロットユーザーピン

Greengrass Core をモジュールに対して認証するために使用されるユーザー PIN。

設定されたプライベートキーで C_Sign を実行するのに十分なアクセス許可があることが必要です。

principals
IOT証明書 The certificate and private key that the core uses to make requests to AWS IoT.
IOT証明書.privateKeypath

Core プライベートキーへのパス。

ファイルシステムストレージの場合、次の形式のファイルの URI である必要があります。file:///absolute/path/to/file

HSM ストレージの場合、オブジェクトラベルを指定する RFC 7512 PKCS#11 パスである必要があります。

IOT証明書.証明書パス

コアデバイスの証明書への絶対パス。

次の形式のファイルの URI である必要があります。file:///absolute/path/to/file

MQTTサーバー証明書

オプション。Core が MQTT サーバーまたはゲートウェイとして機能するために証明書と組み合わせて使用するプライベートキー。

MQTTサーバー証明書.プライベートキーパス

ローカル MQTT サーバーのプライベートキーへのパス。

この値を使用して、ローカル MQTT サーバーの独自のプライベートキーを指定します。

ファイルシステムストレージの場合、次の形式のファイルの URI である必要があります。file:///absolute/path/to/file

HSM ストレージの場合、オブジェクトラベルを指定する RFC 7512 PKCS#11 パスである必要があります。

このプロパティを省略すると、AWS IoT Greengrass は更新設定に基づいてキーを更新します。指定した場合は、お客様がキーを更新する必要があります。

SecretsManager The private key that secures the data key used for encryption. For more information, see AWS IoT Greengrass Core にシークレットをデプロイする.
Secretsmanager.

ローカル Secrets Manager のプライベートキーへのパス。

RSA キーのみがサポートされています。

ファイルシステムストレージの場合、次の形式のファイルの URI である必要があります。file:///absolute/path/to/file

HSM ストレージの場合、オブジェクトラベルを指定する RFC 7512 PKCS#11 パスである必要があります。PKCS#1 v1.5 パディング方式を使用してプライベートキーを生成する必要があります。

以下の設定プロパティもサポートされています。

フィールド 説明 コメント
mqttMaxConnectionRetryInterval

オプション。MQTT 接続間の最大間隔 (秒数) は、接続がドロップした場合に再試行します。

この値を符号なしの整数として指定します。デフォルト: 60

managedRespawn

オプション。OTA エージェントが更新前にカスタムコードを実行する必要があることを示します。

有効な値は true または false です。詳細については、「AWS IoT Greengrass Core ソフトウェアの OTA 更新」を参照してください。

writeDirectory

オプション。書き込みディレクトリ。AWS IoT Greengrassはすべての読み取り/書き込みリソースを作成します。

詳細については、「AWS IoT Greengrass の書き込みディレクトリの設定」を参照してください。

GGC v1.6
{ "coreThing": { "caPath": "root-ca-pem", "certPath": "cloud-pem-crt", "keyPath": "cloud-pem-key", "thingArn": "arn:aws:iot:region:account-id:thing/core-thing-name", "iotHost": "host-prefix.iot.region.amazonaws.com", "ggHost": "greengrass.iot.region.amazonaws.com", "keepAlive": 600, "mqttMaxConnectionRetryInterval": 60 }, "runtime": { "cgroup": { "useSystemd": "yes|no" } }, "managedRespawn": true, "writeDirectory": "/write-directory" }
注記

[] を使用する場合グループ作成のデフォルト値オプションからAWS IoT Greengrassコンソールでconfig.jsonファイルは、デフォルト設定を指定する動作状態にあるコアデバイスにデプロイされます。

config.json ファイルは以下のプロパティをサポートしています。

フィールド 説明 コメント
caPath

ディレクトリに対する AWS IoT ルート CA/greengrass-root/certs へのパス。

/greengrass-root/certs にファイルを保存します。

certPath

へのパス。AWS IoT Greengrassコア証明書を/greengrass-root/certsディレクトリ。

/greengrass-root/certs にファイルを保存します。
keyPath へのパス。AWS IoT Greengrassコアプライベートキー/greengrass-root/certsディレクトリ。 /greengrass-root/certs にファイルを保存します。
thingArn の Amazon リソースネーム (ARN)AWS IoTを表すモノ。AWS IoT GreengrassCore デバイス。 コアの ARN は、AWS IoT Greengrassコンソールコアを実行するか、aws greengrass get-core-definition-versionCLI コマンド。
iotHost AWS IoT エンドポイント。 これを「」で見つけるAWS IoTコンソール設定を実行するか、aws iot describe-endpointCLI コマンド。
ggHost AWS IoT Greengrass エンドポイント。 この値は greengrass.iot.region.amazonaws.com 形式を使用します。iotHost と同じリージョンを使用します。
keepAlive MQTT KeepAlive 期間 (秒単位)。 これはオプションの値です。デフォルト: 600
mqttMaxConnectionRetryInterval

MQTT 接続間の最大間隔 (秒数) は、接続がドロップした場合に再試行します。

この値を符号なしの整数として指定します。これはオプションの値です。デフォルト: 60

useSystemd デバイスが systemd を使用するかどうかを指定します。 有効な値は yes または no です。check_ggc_dependenciesモジュール 1 スクリプトを実行して、デバイスが systemd を使用するかどうかを確認します。
managedRespawn

オプション の無線 (OTA) 更新機能は、OTA エージェントが更新前にカスタムコードを実行する必要があることを示します。

有効な値は true または false です。詳細については、「AWS IoT Greengrass Core ソフトウェアの OTA 更新」を参照してください。

writeDirectory

書き込みディレクトリ。AWS IoT Greengrassはすべての読み取り/書き込みリソースを作成します。

これはオプションの値です。詳細については、「AWS IoT Greengrass の書き込みディレクトリの設定」を参照してください。

GGC v1.5
{ "coreThing": { "caPath": "root-ca-pem", "certPath": "cloud-pem-crt", "keyPath": "cloud-pem-key", "thingArn": "arn:aws:iot:region:account-id:thing/core-thing-name", "iotHost": "host-prefix.iot.region.amazonaws.com", "ggHost": "greengrass.iot.region.amazonaws.com", "keepAlive": 600 }, "runtime": { "cgroup": { "useSystemd": "yes|no" } }, "managedRespawn": true }

config.json ファイルは /greengrass-root/config にあり、次のパラメータを含んでいます。

フィールド 説明 コメント
caPath

フォルダに対する AWS IoT ルート CA/greengrass-root/certs へのパス。

ファイルを /greengrass-root/certs フォルダの下に保存します。

certPath

へのパス。AWS IoT Greengrassコア証明書を/greengrass-root/certsfolder

ファイルを /greengrass-root/certs フォルダの下に保存します。
keyPath へのパス。AWS IoT Greengrassコアプライベートキー/greengrass-root/certsfolder ファイルを /greengrass-root/certs フォルダの下に保存します。
thingArn の Amazon リソースネーム (ARN)AWS IoTを表すモノ。AWS IoT GreengrassCore デバイス。 コアの ARN は、AWS IoT Greengrassコンソールコアを実行するか、aws greengrass get-core-definition-versionCLI コマンド。
iotHost AWS IoT エンドポイント。 これを「」で見つけるAWS IoTコンソール設定を実行するか、aws iot describe-endpointコマンド。
ggHost AWS IoT Greengrass エンドポイント。 この値は greengrass.iot.region.amazonaws.com 形式を使用します。iotHost と同じリージョンを使用します。
keepAlive MQTT KeepAlive 期間 (秒単位)。 これはオプションの値です。デフォルト値は 600 秒です。
useSystemd デバイスが systemd を使用するかどうかを指定します。 有効な値は yes または no です。check_ggc_dependenciesモジュール 1 スクリプトを実行して、デバイスが systemd を使用するかどうかを確認します。
managedRespawn

オプション の無線 (OTA) 更新機能は、OTA エージェントが更新前にカスタムコードを実行する必要があることを示します。

詳細については、「AWS IoT Greengrass Core ソフトウェアの OTA 更新」を参照してください。

GGC v1.3
{ "coreThing": { "caPath": "root-ca-pem", "certPath": "cloud-pem-crt", "keyPath": "cloud-pem-key", "thingArn": "arn:aws:iot:region:account-id:thing/core-thing-name", "iotHost": "host-prefix.iot.region.amazonaws.com", "ggHost": "greengrass.iot.region.amazonaws.com", "keepAlive": 600 }, "runtime": { "cgroup": { "useSystemd": "yes|no" } }, "managedRespawn": true }

config.json ファイルは /greengrass-root/config にあり、次のパラメータを含んでいます。

フィールド 説明 コメント
caPath

フォルダに対する AWS IoT ルート CA/greengrass-root/certs へのパス。

ファイルを /greengrass-root/certs フォルダの下に保存します。

certPath

へのパス。AWS IoT Greengrassコア証明書を/greengrass-root/certsfolder

ファイルを /greengrass-root/certs フォルダの下に保存します。
keyPath へのパス。AWS IoT Greengrassコアプライベートキー/greengrass-root/certsfolder ファイルを /greengrass-root/certs フォルダの下に保存します。
thingArn の Amazon リソースネーム (ARN)AWS IoTを表すモノ。AWS IoT Greengrassコア。 この値は、[AWS IoT Greengrassコンソールの定義の下にAWS IoTのモノ
iotHost AWS IoT エンドポイント。 この値は、[AWS IoTコンソール設定
ggHost AWS IoT Greengrass エンドポイント。 この値は、[AWS IoTコンソール設定greengrass.を先頭に付けます。
keepAlive MQTT KeepAlive 期間 (秒単位)。 これはオプションの値です。デフォルト値は 600 秒です。
useSystemd デバイスが systemd を使用する場合のバイナリフラグ。 有効な値は yes または no です。モジュール 1 の依存関係スクリプトを使用して、デバイスが systemd を使用しているかどうかを確認できます。
managedRespawn

オプション の無線 (OTA) 更新機能は、OTA エージェントが更新前にカスタムコードを実行する必要があることを示します。

詳細については、「AWS IoT Greengrass Core ソフトウェアの OTA 更新」を参照してください。

GGC v1.1
{ "coreThing": { "caPath": "root-ca-pem", "certPath": "cloud-pem-crt", "keyPath": "cloud-pem-key", "thingArn": "arn:aws:iot:region:account-id:thing/core-thing-name", "iotHost": "host-prefix.iot.region.amazonaws.com", "ggHost": "greengrass.iot.region.amazonaws.com", "keepAlive": 600 }, "runtime": { "cgroup": { "useSystemd": "yes|no" } } }

config.json ファイルは /greengrass-root/config にあり、次のパラメータを含んでいます。

フィールド 説明 コメント
caPath

フォルダに対する AWS IoT ルート CA/greengrass-root/certs へのパス。

ファイルを /greengrass-root/certs フォルダの下に保存します。

certPath

へのパス。AWS IoT Greengrassコア証明書を/greengrass-root/certsfolder

ファイルを /greengrass-root/certs フォルダの下に保存します。
keyPath へのパス。AWS IoT Greengrassコアプライベートキーは、/greengrass-root/certsfolder ファイルを /greengrass-root/certs フォルダの下に保存します。
thingArn の Amazon リソースネーム (ARN)AWS IoTを表すモノ。AWS IoT Greengrassコア。 この値は、[AWS IoT Greengrassコンソールの定義の下にAWS IoTのモノ
iotHost AWS IoT エンドポイント。 この値は、[AWS IoTコンソール設定
ggHost AWS IoT Greengrass エンドポイント。 この値は、[AWS IoTコンソール設定greengrass.を先頭に付けます。
keepAlive MQTT KeepAlive 期間 (秒単位)。 これはオプションの値です。デフォルト値は 600 秒です。
useSystemd デバイスが systemd を使用する場合のバイナリフラグ。 有効な値は yes または no です。モジュール 1 の依存関係スクリプトを使用して、デバイスが systemd を使用しているかどうかを確認できます。
GGC v1.0

AWS IoT Greengrass Core v1.0 では、config.jsongreengrass-root/configuration にデプロイされます。

{ "coreThing": { "caPath": "root-ca-pem", "certPath": "cloud-pem-crt", "keyPath": "cloud-pem-key", "thingArn": "arn:aws:iot:region:account-id:thing/core-thing-name", "iotHost": "host-prefix.iot.region.amazonaws.com", "ggHost": "greengrass.iot.region.amazonaws.com", "keepAlive": 600 }, "runtime": { "cgroup": { "useSystemd": "yes|no" } } }

config.json ファイルは /greengrass-root/configuration にあり、次のパラメータを含んでいます。

フィールド 説明 コメント
caPath

フォルダに対する AWS IoT ルート CA/greengrass-root/configuration/certs へのパス。

ファイルを /greengrass-root/configuration/certs フォルダの下に保存します。

certPath

へのパス。AWS IoT Greengrassコア証明書を/greengrass-root/configuration/certsfolder

ファイルを /greengrass-root/configuration/certs フォルダの下に保存します。
keyPath へのパス。AWS IoT Greengrassコアプライベートキーは、/greengrass-root/configuration/certsfolder ファイルを /greengrass-root/configuration/certs フォルダの下に保存します。
thingArn の Amazon リソースネーム (ARN)AWS IoTを表すモノ。AWS IoT Greengrassコア。 この値は、[AWS IoT Greengrassコンソールの定義の下にAWS IoT[Hinge]
iotHost AWS IoT エンドポイント。 この値は、[AWS IoTコンソール設定
ggHost AWS IoT Greengrass エンドポイント。

この値は、[AWS IoTコンソール設定greengrass.を先頭に付けます。

keepAlive MQTT KeepAlive 期間 (秒単位)。 これはオプションの値です。デフォルト値は 600 秒です。
useSystemd デバイスが systemd を使用する場合のバイナリフラグ。 有効な値は yes または no です。モジュール 1 の依存関係スクリプトを使用して、デバイスが systemd を使用しているかどうかを確認できます。

サービスエンドポイントはルート CA 証明書タイプと一致する必要がある

AWS IoT Core および AWS IoT Greengrass エンドポイントは、デバイスのルート CA の証明書タイプに対応している必要があります。エンドポイントと証明書の種類が一致しない場合、デバイスと AWS IoT Core または AWS IoT Greengrass の間の認証試行は失敗します。詳細については、AWS IoT デベロッパーガイドの「サーバー認証」を参照してください。

デバイスで推奨される方法である Amazon Trust Services (ATS) ルート CA 証明書を使用している場合、デバイス管理と検出データプレーンのオペレーションに ATS エンドポイントも使用する必要があります。ATS エンドポイントには、 AWS IoT Core エンドポイント用の以下の構文で示すように、ats セグメントが含まれます。

prefix-ats.iot.region.amazonaws.com
注記

下位互換性のために、AWS IoT Greengrassは現在、レガシー VeriSign ルート CA 証明書と、一部の AWS リージョン 。レガシーの VeriSign ルート CA 証明書を使用している場合、ATS エンドポイントを作成し、代わりに ATS ルート CA 証明書を使用することをお勧めします。それ以外の場合は、対応するレガシーエンドポイントを必ず使用します。詳細については、「」を参照してください。サポートされているレガシーエンドポイント()Amazon Web Services 全般リファレンス

config.json のエンドポイント

Greengrass コアデバイスでは、エンドポイントはcoreThingオブジェクトconfig.jsonファイルを開きます。iotHost プロパティは AWS IoT Core エンドポイントを表します。ggHost プロパティは AWS IoT Greengrass エンドポイントを表します。次の例のスニペットでは、これらのプロパティは ATS エンドポイントを指定します。

{ "coreThing" : { ... "iotHost" : "abcde1234uwxyz-ats.iot.us-west-2.amazonaws.com", "ggHost" : "greengrass-ats.iot.us-west-2.amazonaws.com", ... },
AWS IoT Core endpoint

AWS IoT Core エンドポイントを取得するには、aws iot describe-endpoint CLI コマンドを適切な --endpoint-type パラメータで実行します。

  • ATS 署名付きエンドポイントを返すには、以下を実行します。

    aws iot describe-endpoint --endpoint-type iot:Data-ATS
  • 従来の VeriSign 署名付きエンドポイントを返すには、以下を実行します。

    aws iot describe-endpoint --endpoint-type iot:Data
AWS IoT Greengrass endpoint

あなたのAWS IoT Greengrassエンドポイントは、あなたのiotHostエンドポイントに、ホストプレフィックスがgreengrass。たとえば、ATS 署名付きエンドポイントは greengrass-ats.iot.region.amazonaws.com です。これは AWS IoT Core エンドポイントと同じリージョンを使用します。

ポート 443 での接続またはネットワークプロキシを通じた接続

この機能は、でのみ使用できます。AWS IoT GreengrassCore v1.7 以降。

Greengrass コアは、 AWS IoT Core との通信に、TLS クライアント認証を介した MQTT メッセージングプロトコルを使用します。慣例では、TLS を介した MQTT ではポート 8883 を使用します。ただし、セキュリティ対策として、制限の厳しい環境では一定範囲の TCP ポートに対するインバウンドトラフィックとアウトバウンドトラフィックを制限する場合があります。たとえば、企業のファイアウォールでは HTTPS トラフィック用のポート 443 は開いても、あまり一般的ではないプロトコル用の他のポート (MQTT トラフィック用のポート 8883 など) は閉じる場合があります。他の制限の厳しい環境では、すべてのトラフィックに対して HTTP プロキシを経由してインターネットに接続することを義務付ける場合があります。

このようなシナリオで通信を有効にするには、AWS IoT Greengrass で以下の設定を許可します。

  • ポート 443 を介した TLS クライアント認証を使用する MQTT。ネットワークでポート 443 への接続を許可する場合は、デフォルトのポート 8883 ではなく ポート 443 を MQTT トラフィックに使用するように Core を設定できます。ポート 443 への直接接続またはネットワークプロキシサーバーを介した接続を使用できます。

    AWS IoT Greengrass では Application Layer Protocol Network (ALPN) TLS 拡張機能を使用して、この接続を有効にします。デフォルト設定と同様に、ポート 443 での TLS を介した MQTT では証明書ベースのクライアント認証を使用します。

    ポート 443 への直接接続を使用するように構成されている場合、コアは無線通信経営 (OTA) の更新forAWS IoT Greengrassソフトウェア。このサポートには、AWS IoT Greengrass コア v1.9.3 以降が必要です。

  • ポート 443 を介した HTTPS 通信。AWS IoT Greengrass はデフォルトでポート 8443 経由で HTTPS トラフィックを送信しますが、ポート 443 を使用するように設定することもできます。

  • ネットワークプロキシを介した接続。ネットワークプロキシサーバーを Greengrass コアに接続するための仲介役として設定できます。基本的な認証と HTTP/HTTPS プロキシのみがサポートされています。

    プロキシ設定は、ユーザー定義の Lambda 関数に渡されます。http_proxy,https_proxy, およびno_proxy環境変数。ユーザー定義の Lambda 関数は、渡されたこれらの設定を使用して、プロキシ経由で接続する必要があります。接続を行うために Lambda 関数によって使用される共通ライブラリ (boto3 や cURL など、および python など)requestsパッケージ)は、通常、これらの環境変数をデフォルトで使用します。Lambda 関数もこれらの同じ環境変数を指定した場合、AWS IoT Greengrassこの設定は上書きされません。

    重要

    ネットワークプロキシを使用するように設定されている Greengrass Core は、OTA の更新をサポートしていません。

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

この機能には v が必要です。AWS IoT GreengrassCore 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 を設定するには

この機能には v が必要です。AWS IoT GreengrassCore 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

 

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

この機能には v が必要です。AWS IoT GreengrassCore 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

networkProxy オブジェクト

ネットワークプロキシに関する情報を指定するには、networkProxy オブジェクトを使用します。このオブジェクトには以下のプロパティがあります。

フィールド 説明
noProxyAddresses

オプション。プロキシの対象外となる IP アドレスやホスト名のカンマ区切りリスト。

proxy

接続先のプロキシ。プロキシには以下のプロパティがあります。

  • url。 プロキシサーバーの URL (形式)scheme://userinfo@host:port

    • scheme。 スキーム。http または https を指定する必要があります。

    • userinfo。 オプション。ユーザー名とパスワードの情報。指定した場合、username フィールドと password フィールドは無視されます。

    • host。 プロキシサーバーのホスト名または IP アドレスです

    • port。 オプション。ポート番号。指定しない場合は、以下のデフォルト値が使用されます。

      • http: 80

      • https: 443

  • username。 オプション。プロキシサーバーの認証に使用するユーザー名。

  • password。 オプション。プロキシサーバーの認証に使用するパスワード。

エンドポイントの許可

Greengrass デバイス と AWS IoT Core または AWS IoT Greengrass 間のコミュニケーションが認証される必要があります。この認証は、登録された X.509 デバイス証明書と暗号化キーに基づいています。認証されたリクエストが追加の暗号化なしでプロキシを通過できるようにするには、次のエンドポイントを許可します。

エンドポイント ポート 説明
greengrass.region.amazonaws.com 443

グループ管理用のコントロールプレーンオペレーションに使用されます。

prefix-ats.iot.region.amazonaws.com

または

prefix.iot.region.amazonaws.com

MQTT: 8883 または 443

HTTPS: 8443 または 443

シャドウ同期など、デバイス管理用のデータプレーンオペレーションに使用されます。

コアデバイスと接続デバイスが Amazon Trust Services (推奨) ルート CA 証明書、レガシールート CA 証明書、またはその両方を使用しているかどうかに応じて、一方または両方のエンドポイントの使用を許可します。詳細については、「サービスエンドポイントはルート CA 証明書タイプと一致する必要がある」を参照してください。

greengrass-ats.iot.region.amazonaws.com

または

greengrass.iot.region.amazonaws.com

8443 または 443

デバイス検出オペレーションのために使用されます。

コアデバイスと接続デバイスが Amazon Trust Services (推奨) ルート CA 証明書、レガシールート CA 証明書、またはその両方を使用しているかどうかに応じて、一方または両方のエンドポイントの使用を許可します。詳細については、「サービスエンドポイントはルート CA 証明書タイプと一致する必要がある」を参照してください。

注記

ポート 443 で接続するクライアントは、アプリケーション層プロトコルネゴシエーション (ALPN)TLS 拡張とパスx-amzn-http-caとしてProtocolName()ProtocolNameList。詳細については、「」を参照してください。プロトコル()AWS IoT開発者ガイド

*.s3.amazonaws.com 443

デプロイオペレーションと無線による更新に使用されます。エンドポイントプレフィックスは内部的に制御され、いつでも変更される可能性があるため、この形式には * 文字が含まれます。

logs.region.amazonaws.com 443

Greengrass グループが CloudWatch にログを書き込むように構成されている場合は必須です。

AWS IoT Greengrass の書き込みディレクトリの設定

この機能は、でのみ使用できます。AWS IoT GreengrassCore v1.6 以降。

デフォルトでは、AWS IoT Greengrass Core ソフトウェアは AWS IoT Greengrass がすべての読み取りと書き込みオペレーションを実行する単一ルートディレクトリにデプロイされます。ただし、すべての書き込みオペレーション (ディレクトリおよびファイルの作成を含む) には別のディレクトリを使用するように AWS IoT Greengrass を設定することができます。この場合、AWS IoT Greengrass は 2 つの最上位ディレクトリを使用します。

  • greengrass-root ディレクトリ。読み取り/書き込みのままにするか、あるいはオプションで読み取り専用にします。これには、AWS IoT Greengrass Core ソフトウェア、およびランタイム中にイミュータブルにする必要のあるその他の重要なコンポーネント (証明書や config.json など) が含まれます。

  • 指定する書き込みディレクトリ。これには、ログ、状態情報やデプロイしたユーザー定義の Lambda 関数のような書き込み可能なコンテンツが含まれます。

この設定は次のようなディレクトリ構成になります。

Greengrass ルートディレクトリ
greengrass-root/ |-- certs/ | |-- root.ca.pem | |-- hash.cert.pem | |-- hash.private.key | |-- hash.public.key |-- config/ | |-- config.json |-- ggc/ | |-- packages/ | |-- package-version/ | |-- bin/ | |-- daemon | |-- greengrassd | |-- lambda/ | |-- LICENSE/ | |-- release_notes_package-version.html | |-- runtime/ | |-- java8/ | |-- nodejs8.10/ | |-- python3.8/ | |-- core/
書き込みディレクトリ
write-directory/ |-- packages/ | |-- package-version/ | |-- ggc_root/ | |-- rootfs_nosys/ | |-- rootfs_sys/ | |-- var/ |-- deployment/ | |-- group/ | |-- group.json | |-- lambda/ | |-- mlmodel/ |-- var/ | |-- log/ | |-- state/

 

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

  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.3/lambda/
      注記

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

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

    注記

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

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

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

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

MQTT 設定の設定

左AWS IoT Greengrass環境では、ローカルデバイス、Lambda 関数、コネクタ、およびシステムコンポーネントを使用して、相互通信や、 AWS IoT Core 。すべての通信は、エンティティ間の MQTT 通信を許可するサブスクリプションを管理するコアを通過します。

AWS IoT Greengrass に設定できる MQTT 設定の詳細については、次のセクションを参照してください。

注記

OPC-UA は、産業通信用の情報交換標準です。Greengrass コアで OPC-UA のサポートを実装するには、IoT SiteWise コネクタ。コネクタは、産業用デバイスデータを OPC-UA サーバーから AWS IoT SiteWise のアセットプロパティに送信します。

サービスのメッセージの品質

AWS IoT Greengrass は、設定および通信のターゲットと方向に応じて、サービス品質 (QoS) レベル 0 または 1 をサポートします。Greengrass コアは、 AWS IoT Core との通信ではクライアントとして、ローカルネットワーク上の通信ではメッセージブローカーとして機能します。


                    クライアントおよびローカルメッセージブローカーとしてのコア。

MQTT と QoS の詳細については、を参照してください。開始方法MQTT のウェブサイトをご覧ください。

とのコミュニケーション AWS クラウド
  • アウトバウンドメッセージが QoS 1 を使用

    コアは、宛てのメッセージを送信します AWS クラウド ターゲットの QoS 1 を使用します。AWS IoT Greengrassは MQTT メッセージキューを使用してこれらのメッセージを処理します。メッセージ配信がAWS IoTの場合、メッセージはスプールされ、後で再試行されます。キューがいっぱいになると、メッセージを再試行できません。メッセージ配信確認は、断続的な接続によるデータ損失を最小限に抑えることができます。

    への送信メッセージのためAWS IoTQoS 1 を使用する場合、Greengrass コアがメッセージを送信できる最大レートは、コアとAWS IoT。コアがメッセージを送信するたびに、AWS IoTは、次のメッセージを送信する前にメッセージを承認します。たとえば、コアとその間のラウンドトリップ時間 AWS リージョン が 50 ミリ秒の場合、コアは毎秒最大 20 個のメッセージを送信できます。この動作を考慮するには、 AWS リージョン あなたのコアが接続する場所。大量の IoT データを AWS クラウド 「」を使用できます。ストリームマネージャー

    宛てのメッセージを保持できるローカルストレージキャッシュの設定方法など、MQTT メッセージキューの詳細については、 AWS クラウド ターゲットについては、クラウドターゲットの MQTT メッセージキュー

  • インバウンドメッセージが QoS 0 (デフォルト) または QoS 1 を使用

    デフォルトでは、コアは QoS 0 でからのメッセージに対してサブスクライブします。 AWS クラウド source。永続セッションを有効にすると、コアは QoS 1 でサブスクライブします。これにより、断続的な接続によるデータ損失を最小限に抑えることができます。これらのサブスクリプションの QoS を管理するには、ローカルスプーラーシステムコンポーネントで永続性設定を設定します。

    コアがとの永続セッションを確立できるようにする方法など、詳細については、 AWS クラウド ターゲットについては、 AWS IoT Core を使用した MQTT 永続セッション

ローカル・ターゲットとの通信

すべてのローカル通信は QoS 0 を使用します。コアは、Greengrass Lambda 関数、コネクタ、またはデバイスの接続。メッセージの保存や、配信の確認は行われません。メッセージはコンポーネント間のどこにでもドロップできます。

注記

Lambda 関数間の直接通信では MQTT メッセージングは使用されませんが、動作は同じです。

クラウドターゲットの MQTT メッセージキュー

送信先とする MQTT メッセージ AWS クラウド ターゲットは、処理待ちとしてキューされます。キュー状態のメッセージは先入れ先出し (FIFO) の順序で処理されます。メッセージが処理され、 AWS IoT Core に発行された後、このメッセージはキューから削除されます。

デフォルトでは、Greengrass コアは、宛ての未処理のメッセージを格納します。 AWS クラウド ターゲットが存在することを確認します。代わりにコアを設定して、未処理のメッセージをメモリあるいはローカルストレージキャッシュに保存できます。インメモリストレージとは異なり、ローカルストレージキャッシュにはコアの再起動の後でも維持される機能があるため (たとえば、グループデプロイ後あるいはデバイスの再起動後など)、AWS IoT Greengrass はメッセージの処理を続けられます。また、ストレージサイズを設定することもできます。

AWS IoT Greengrassは、スプーラーシステムコンポーネント (GGCloudSpoolerLambda 関数) を使用して、メッセージキューを管理します。次の GGCloudSpooler 環境変数を使用して、ストレージ設定を設定できます。

  • GG_CONFIG_STORAGE_TYPE。メッセージキューの場所。以下の値が有効です。

    • FileSystem。 未処理のメッセージを物理コアデバイスのディスク上のローカルストレージキャッシュに保存します。コアが再起動すると、キュー状態のメッセージは処理のために維持されます。メッセージが処理された後に削除されます。

    • Memory (デフォルト). 未処理のメッセージをメモリに保存します。コアが再起動すると、キュー状態のメッセージは失われます。

      このオプションは、制限されたハードウェア機能があるデバイスでの使用に最適です。この設定を使用する場合を使用する場合、サービスの中断が低いときにグループのデプロイあるいはデバイスの再起動を行うことが推奨されます。

  • GG_CONFIG_MAX_SIZE_BYTES。ストレージ容量 (バイト単位)。この値は、262144 以上 (256 KB) の任意の正の整数にできます。これより小さなサイズでは、AWS IoT Greengrass Core ソフトウェアが起動できません。デフォルトサイズは 2.5 MB です。サイズ制限に達した場合、最も古いキュー状態のメッセージは新しいメッセージで置き換えられます。

注記

この機能は、でのみ使用できます。AWS IoT GreengrassCore v1.6 以降。以前のバージョンでは、キューサイズが 2.5 MB のインメモリストレージを使用します。以前のバージョンでは、ストレージ設定を構成することはできません。

ローカルストレージでメッセージをキャッシュするには

ただし、AWS IoT Greengrass を設定してファイルシステムにメッセージをキャッシュして、コアの再起動でも保持されるようにできます。これを行うには、GGCloudSpooler 関数がストレージタイプを FileSystem に設定する関数定義バージョンをデプロイします。ローカルストレージキャッシュを設定するには、AWS IoT Greengrass API を使用する必要があります。これをコンソールで実行することはできません。

次の手順では、create-function-definition-version CLI コマンドを使用して、キュー状態のメッセージをファイルシステムに保存するようにスプーラを設定します。また、2.6 MB キューサイズも設定します。

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

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

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

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

    これらの値はにもあります。AWS IoTconsole. グループ 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 など) で置き換えます。

    • このバージョンで含める任意の Lambda 関数をfunctions配列です。「」を使用できます。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"}]'
    注記

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

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

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

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

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

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

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

    • 使用されていないパラメータをすべて削除します。たとえば、グループバージョンにリソースがない場合には、--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

ストレージの設定を更新するには、AWS IoT Greengrass API を使用して、更新された設定の GGCloudSpooler 関数を含む新しい関数定義バージョンを作成します。次に、この関数定義バージョンを新規のグループバージョンに追加し (他のグループコンポーネントと一緒に)、このグループバージョンをデプロイします。デフォルト設定を復元する場合、GGCloudSpooler 関数を含まない関数定義バージョンをデプロイできます。

このシステム Lambda 関数は、コンソールでは表示されません。ただし、関数が最新のグループバージョンに追加されると、これはコンソールから行うデプロイに含まれます (API を使用して、その置き換えや削除を行う場合を除く)。

AWS IoT Core を使用した MQTT 永続セッション

この機能は AWS IoT Greengrass Core v1.10 以降で使用できます。

Greengrass コアは、AWS IoT メッセージブローカーとの永続セッションを確立できます。永続セッションは、コアがオフラインのときに送信されたメッセージをコアが受信できるようにする継続的な接続です。コアは、接続のクライアントです。

永続セッションでは、AWS IoT メッセージブローカーは、接続中にコアが作成するすべてのサブスクリプションを保存します。コアが切断されると、AWS IoTメッセージブローカーは、QoS 1 として発行され、Lambda 関数や Lambda 関数など、ローカルターゲット宛ての未確認メッセージおよび新規メッセージを保存します。デバイスの接続。コアが再接続されると、永続セッションが再開され、AWS IoT メッセージブローカーによって、保存されたメッセージが最大 10 メッセージ/秒でコアに送信されます。永続セッションには、デフォルトの有効期限が 1 時間に設定されています。これは、メッセージブローカーがコアを切断したことを検出したときに開始されます。詳細については、「」を参照してください。MQTT 永続的セッション()AWS IoT開発者ガイド

AWS IoT Greengrassは、スプーラーシステムコンポーネント (GGCloudSpoolerLambda 関数) を使用して、AWS IoTをソースとします。永続的なセッションを設定するには、次の GGCloudSpooler 環境変数を使用できます。

  • GG_CONFIG_SUBSCRIPTION_QUALITY。ソースとして AWS IoT を持つサブスクリプションの品質。以下の値が有効です。

    • AtMostOnce (デフォルト). 永続セッションを無効にします。サブスクリプションは QoS 0 を使用します。

    • AtLeastOncePersistent。 永続セッションを有効にします。CONNECT メッセージで cleanSession フラグを 0 に設定し、QoS 1 でサブスクライブします。

      コアが受信する QoS 1 で発行されたメッセージは、Greengrass デーモンのメモリ内作業キューに到達することが保証されます。コアは、メッセージがキューに追加された後にメッセージを承認します。キューからローカルターゲット (Greengrass Lambda 関数、コネクタ、デバイスなど) への後続の通信は、QoS 0 として送信されます。AWS IoT Greengrassはローカルターゲットへの配信を保証しません。

      注記

      maxWorkItemCount 設定プロパティを使用して、作業項目キューのサイズを制御できます。たとえば、ワークロードで大量の MQTT トラフィックが必要な場合は、キューのサイズを増やすことができます。

      永続セッションを有効にすると、コアは AWS IoT との MQTT メッセージ交換用に、少なくとも 1 つの追加接続を開きます。詳細については、「AWS IoT を使用した MQTT 接続用クライアント ID」を参照してください。

MQTT 永続セッションを設定するには

AWS IoT Core で永続セッションを使用するように AWS IoT Greengrass を設定できます。これを行うには、GGCloudSpooler 関数がサブスクリプションの品質を AtLeastOncePersistent に設定する関数定義バージョンをデプロイします。この設定は、ソースとして AWS IoT Core (cloud) を持つすべてのサブスクリプションに適用されます。永続セッションを設定するには、AWS IoT Greengrass API を使用する必要があります。これをコンソールで実行することはできません。

次の手順では、create-function-definition-version CLI コマンドを使用して、永続セッションを使用するようにスプーラーを設定します。この手順では、既存のグループの最新グループバージョンの設定を更新しているものとします。

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

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

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

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

    これらの値はにもあります。AWS IoTconsole. グループ 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 など) で置き換えます。

    • このバージョンで含める任意の Lambda 関数をfunctions配列です。「」を使用できます。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 (SubscriptionDefinitionVersionArnDeviceDefinitionVersionArn など) を置き換えます。

    • 使用されていないパラメータをすべて削除します。たとえば、グループバージョンにリソースがない場合には、--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 トラフィックとローカルターゲットとの通信を処理できます。

これらの設定の変更でコアを更新するには、AWS IoT Greengrass API を使用して、更新された設定と GGCloudSpooler 関数を含む新しい関数定義バージョンを作成します。次に、この関数定義バージョンを新規のグループバージョンに追加し (他のグループコンポーネントと一緒に)、このグループバージョンをデプロイします。デフォルト設定を復元する場合、GGCloudSpooler 関数を含まない関数定義バージョンを作成できます。

このシステム Lambda 関数は、コンソールでは表示されません。ただし、関数が最新のグループバージョンに追加されると、これはコンソールから行うデプロイに含まれます (API を使用して、その置き換えや削除を行う場合を除く)。

AWS IoT を使用した MQTT 接続用クライアント ID

この機能は、でのみ使用できます。AWS IoT GreengrassCore v1.8 以降。

Greengrass コアは、シャドウ同期や証明書の管理などのオペレーション用に、 AWS IoT Core を使用した MQTT 接続を開きます。このような接続では、コアはコアのモノ名に基づいた予測可能なクライアント ID を生成します。予測可能なクライアント ID は、AWS IoT Device Defender や AWS IoT ライフサイクルイベントなど、モニタリング、監査および料金機能に使用できます。予測可能なクライアント ID を中心としたロジックも作成できます (たとえば、証明書の属性に基づいたサブスクライブポリシーテンプレートなど)。

GGC v1.9 and later

2 つの Greengrass システムコンポーネントによって、 AWS IoT Core を使用した MQTT 接続が開きます。これらのコンポーネントは次のパターンを使用して、接続用のクライアント ID を生成します。

オペレーション クライアント ID のパターン
デプロイ

core-thing-name

例: MyCoreThing

このクライアント ID は、接続、接続解除、ライフサイクルイベント通知へのサブスクライブあるいはサブスクライブ解除に使用します。

サブスクリプション

core-thing-name-cn

例: MyCoreThing-c01

nは、00 からはじまり、新しい接続ごとに最大で 250 まで増加する整数です。接続数は、を使用してシャドウ状態を同期するデバイスの数によって決定されます。 AWS IoT Core (グループごとに最大 2,500)とcloudをグループ内のソースとして使用します(グループごとに最大 10,000)。

スプーラシステムコンポーネントは AWS IoT Core を使用して、クラウドソースまたはターゲットとのサブスクリプションのメッセージを交換します。また、スプーラーは、 AWS IoT Core とローカルシャドウサービスとデバイス証明書マネージャーの間でメッセージを交換するためのプロキシとして動作します。

グループごとの MQTT 接続数を計算するには、次の式を使用します。

number of MQTT connections per group = number of connections for Deployment Agent + number of connections for Subscriptions

各パラメータの意味は次のとおりです。

  • デプロイメント・エージェントの接続数 = 1

  • サブスクリプションの接続数 =(2 subscriptions for supporting certificate generation + number of MQTT topics in AWS IoT Core + number of device shadows synced) / 50

    • 各パラメータの意味は次のとおりです。50= 接続あたりのサブスクリプションの最大数 AWS IoT Core はをサポートできます。

注記

[] を有効にする場合永続的セッションサブスクリプションの AWS IoT Core コアは、永続セッションで使用する少なくとも 1 つの追加接続を開きます。システムコンポーネントは永続セッションをサポートしていないため、その接続を共有することはできません。

MQTT 接続の数を減らし、コストを削減するために、ローカルの Lambda 関数を使用してエッジでデータを集約できます。次に、集約されたデータを送信します。 AWS クラウド 。その結果、使用する MQTT トピックは AWS IoT Core 。詳細については、AWS IoT Greengrass 料金を参照してください。

GGC v1.8

複数の Greengrass システムコンポーネントによって、 AWS IoT Core を使用した MQTT 接続が開きます。これらのコンポーネントは次のパターンを使用して、接続用のクライアント ID を生成します。

オペレーション クライアント ID のパターン
デプロイ

core-thing-name

例: MyCoreThing

このクライアント ID は、接続、接続解除、ライフサイクルイベント通知へのサブスクライブあるいはサブスクライブ解除に使用します。

AWS IoT Core を使用した MQTT メッセージの交換

core-thing-name-spr

例: MyCoreThing-spr

シャドウ同期

core-thing-name-snn

例: MyCoreThing-s01

nn は、00 からはじまり、新しい接続ごとに最大で 03 まで増加する整数です。接続数は、 AWS IoT Core を使用してシャドウ状態を同期するデバイスの数 (グループごとに最大で 200 個のデバイス) によって決定されます (接続ごとに最大で 50 のサブスクリプション)。

デバイス証明書管理

core-thing-name-dcm

例: MyCoreThing-dcm

注記

同時接続で使用されるクライアント ID の重複は、無限の接続 - 切断ループを引き起こすことがあります。これは、別のデバイスが接続でクライアント ID をコアデバイス名に使用するようにハードコードされた場合に発生します。詳細については、このトラブルシューティングステップを参照してください。

また、Greengrass デバイスは AWS IoT Device Management のフリートインデックス作成サービスと完全に統合されます。これにより、デバイス属性、シャドウ状態、およびクラウド内の接続状態に基づいてデバイスにインデックスを付けて検索することができます。たとえば、Greengrass デバイスはモノの名前をクライアント ID として使用する少なくとも 1 つの接続を確立するため、デバイス接続のインデックス作成を使用して、現在 AWS IoT Core に接続または切断されている Greengrass デバイスを検出できます。詳細については、「」を参照してください。フリートインデックス作成サービス()AWS IoT開発者ガイド

ローカルメッセージング用の MQTT ポートの設定

この機能には v が必要です。AWS IoT GreengrassCore v1.10 以降。

Greengrass コアは、ローカルの Lambda 関数、コネクタ、Greengrass デバイス間の MQTT メッセージングのローカルメッセージブローカーとして機能します。デフォルトでは、コアはローカルネットワーク上の MQTT トラフィックにポート 8883 を使用します。ポート 8883 で動作する他のソフトウェアとの競合を避けるために、ポートを変更することもできます。

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

    コアの接続情報を更新するには (コンソール)
    1. グループ設定ページで、[Cores (コア)] を選択し、コアを選択します。

    2. コア詳細ページで、[Connectivity (接続)] を選択し、[Edit (編集)] を選択します。

    3. [Add another connection (別の接続を追加)] を選択し、現在のローカル IP アドレスと新しいポート番号を入力します。次の例では、IP アドレス 192.168.1.8 のポート番号 9000 を設定します。

      
                                                クライアントおよびローカルメッセージブローカーとしてのコア。
    4. 古いエンドポイントを削除し、[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 での接続またはネットワークプロキシを通じた接続」を参照してください。

MQTT 接続の発行、サブスクリプション、サブスクリプション解除オペレーションのタイムアウト AWS クラウド

この機能は AWS IoT Greengrass v1.10.2 以降で使用できます。

Greengrass コアが AWS IoT Core への MQTT 接続で発行、サブスクリプション、またはサブスクリプション解除オペレーションを完了するまでの時間 (秒単位) を設定できます。帯域幅の制約や待ち時間が長いためオペレーションがタイムアウトする場合は、この設定を調整する必要があります。config.json ファイルでこの設定を構成するには、coreThing オブジェクトの mqttOperationTimeout プロパティを追加または変更します。次に例を示します。

{ "coreThing": { "mqttOperationTimeout": 10, "caPath": "root-ca.pem", "certPath": "hash.cert.pem", "keyPath": "hash.private.key", ... }, ... }

デフォルトのタイムアウトは 5 秒です。最小タイムアウトは 5 秒です。

自動 IP 検出をアクティブ化する

次のことを確認してください。AWS IoT Greengrassを選択すると、Greengrass グループ内のデバイスがGreengrass コアを自動的に検出できるようになります。イネーブルにすると、コアは IP アドレスの変更を監視します。アドレスが変更されると、コアは更新されたアドレスのリストを公開します。コアと同じ Greengrass グループに属するデバイスでは、これらのアドレスを使用できます。

注記

-AWS IoTポリシーは、greengrass:Discoverデバイスは、コアの接続情報を取得できるようにします。このポリシーステートメントの詳細については、「検出の承認」を参照してください。

この機能は、[] にあります。AWS IoT Greengrassコンソールで、[]自動検出Greengrass グループを初めてデプロイするときに使用します。この機能を有効化および無効化することもできます。設定ページの下のコア接続情報。[Automatically detect and override connection information (接続情報を自動的に検出して上書きする)] が選択されている場合は、IP の自動検出が有効になります。

Auto Discovery を管理するにはAWS IoT GreengrassAPI を使用するには、IPDetectorシステムLambda 関数。次の手順は、関数定義バージョンの作成CLI コマンドを使用して Greengrass コアの自動検出を設定します。

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

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

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

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

    これらの値はにもあります。AWS IoTconsole. グループ 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 (SubscriptionDefinitionVersionArnDeviceDefinitionVersionArn など) を置き換えます。

    • 使用されていないパラメータをすべて削除します。たとえば、グループバージョンにリソースがない場合には、--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

Greengrass コアの IP アドレスを手動で入力する場合は、IPDetector 関数を含まない別の関数定義を使用してこのチュートリアルを完了できます。これにより、検出関数が Greengrass コアの IP アドレスを見つけて自動的に入力することを防ぎます。

このシステム Lambda 関数は、Lambda コンソールでは表示されません。この関数が最新のグループバージョンに追加された後は、コンソールから行うデプロイに含まれます (API を使用して、その置き換えや削除を行う場合を除く)。

Init システムを設定して Greengrass デーモンを開始する

起動時に Greengrass デーモンを開始するように init システムを設定することは、特にデバイスの大規模なフリートを管理する場合に推奨されます。

注記

apt を使用して AWS IoT Greengrass Core ソフトウェアをインストールした場合は、systemd スクリプトを使用して起動時の開始を有効にできます。詳細については、「systemd スクリプトを使用した Greengrass デーモンのライフサイクルの管理」を参照してください。

init システムにはさまざまな種類があり (initd、systemd、および SystemV など)、同様の設定パラメータが使用されます。次の例は、systemd のサービスファイルです。Greengrassd (Greengrass を開始するために使用される) は Greengrass デーモンプロセスを生成するため、Type パラメータは forking に設定されます。また、Greengrass が失敗状態になったときに systemd が Greengrass を再起動するように、Restart パラメータは on-failure に設定されます。

注記

お使いのデバイスが systemd を使用しているかを確認するには、check_ggc_dependenciesスクリプトで説明されているようにモジュール 1。次に、systemd を使用するには、useSystemdconfig.json の パラメータが yes に設定されていることを確認します。

[Unit] Description=Greengrass Daemon [Service] Type=forking PIDFile=/var/run/greengrassd.pid Restart=on-failure ExecStart=/greengrass/ggc/core/greengrassd start ExecReload=/greengrass/ggc/core/greengrassd restart ExecStop=/greengrass/ggc/core/greengrassd stop [Install] WantedBy=multi-user.target

Raspberry Pi で systemd のサービスファイルを作成して有効にする方法についての詳細は、Raspberry Pi ドキュメントの「SYSTEMD」を参照してください。

以下の資料も参照してください。