Greengrass nucleus - AWS IoT Greengrass

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

Greengrass nucleus

Greengrass nucleus コンポーネント (aws.greengrass.Nucleus) は必須コンポーネントであり、デバイスで AWS IoT Greengrass Core ソフトウェアを実行するための最小要件です。このコンポーネントを設定して、 AWS IoT Greengrass Core ソフトウェアをリモートでカスタマイズおよび更新できます。このコンポーネントをデプロイして、プロキシ、デバイスロール、 AWS IoT モノの設定などの設定をコアデバイスに構成します。

重要

nucleus コンポーネントのバージョンが変更された場合、または特定の設定パラメータを変更すると、デバイス上の nucleus および他のすべてのコンポーネントを含む AWS IoT Greengrass Core ソフトウェアが再起動して変更を適用します。

コンポーネントをデプロイすると、 はそのコンポーネントの依存関係のすべてについて、サポートされている AWS IoT Greengrass 最新バージョンをインストールします。このため、モノグループに新しいデバイスを追加するか、それらのデバイスを対象とするデプロイを更新すると、 AWSが提供するパブリックコンポーネントの新しいパッチバージョンがコアデバイスに自動的にデプロイされる可能性があります。nucleus の更新など、一部の自動更新により、デバイスに予期せぬ再起動が発生することがあります。

デバイスで実行されているコンポーネントに不要に更新されることを防ぐには、デプロイを作成する際、そのコンポーネントの優先バージョンを直接含めることをお勧めします。 AWS IoT Greengrass Core ソフトウェアの更新動作の詳細については、「」を参照してくださいAWS IoT Greengrass Core ソフトウェア (OTA) の更新

バージョン

このコンポーネントには、次のバージョンがあります。

  • 2.13.x

  • 2.12.x

  • 2.11.x

  • 2.10.x

  • 2.9.x

  • 2.8.x

  • 2.7.x

  • 2.6.x

  • 2.5.x

  • 2.4.x

  • 2.3.x

  • 2.2.x

  • 2.1.x

  • 2.0.x

オペレーティングシステム

このコンポーネントは、次のオペレーティングシステムを実行するコアデバイスにインストールできます。

  • Linux

  • Windows

詳細については、「サポートされているプラットフォーム」を参照してください。

要件

Greengrass nucleus と AWS IoT Greengrass Core ソフトウェアをインストールして実行するには、デバイスが特定の要件を満たしている必要があります。詳細については、「デバイスの要件」を参照してください。

Greengrass nucleus コンポーネントは、 での実行がサポートされていますVPC。このコンポーネントを にデプロイするにはVPC、以下が必要です。

  • Greengrass nucleus コンポーネントには、 AWS IoT data、 AWS IoT 認証情報、および Amazon S3 への接続が必要です。

依存関係

Greengrass nucleus にはコンポーネントの依存関係は含まれません。ただし、いくつかの AWSで提供されるコンポーネントには、依存関係としての nucleus が含まれます。詳細については、「AWS が提供したコンポーネント」を参照してください。

コンポーネントの依存関係の詳細については、「コンポーネント recipe のリファレンス」を参照してください。

ダウンロードとインストール

お使いのデバイスに Greengrass nucleus コンポーネントを設定するインストーラをダウンロードできます。このインストーラは、お使いのデバイスを Greengrass コアデバイスとしてセットアップします。実行できるインストールには、必要な AWS リソースを作成するクイックインストールと、自分で AWS リソースを作成する手動インストールの 2 種類があります。詳細については、「AWS IoT Greengrass Core ソフトウェアをインストールします。」を参照してください。

チュートリアルに従って Greengrass nucleus をインストールし、Greengrass コンポーネントの開発を参照することもできます。詳細については、「チュートリアル: AWS IoT Greengrass V2 の開始方法」を参照してください。

構成

このコンポーネントには、コンポーネントのデプロイ時にカスタマイズできる次の設定パラメータが用意されています。一部のパラメータでは、 AWS IoT Greengrass Core ソフトウェアを再起動して有効にする必要があります。このコンポーネントの設定理由と方法の詳細については、「AWS IoT Greengrass Core ソフトウェアを設定する」を参照してください。

iotRoleAlias

トークン交換 AWS IoT ロールを指すIAMロールエイリアス。 AWS IoT 認証情報プロバイダーはこのロールを引き受け、Greengrass コアデバイスが AWS サービスとやり取りできるようにします。詳細については、「コアデバイスが AWS サービスとやり取りできるように認証する」を参照してください。

--provision true オプションを使用して AWS IoT Greengrass Core ソフトウェアを実行すると、ソフトウェアはロールエイリアスをプロビジョニングし、nucleus コンポーネントでその値を設定します。

interpolateComponentConfiguration

(オプション) コンポーネント設定のコンポーネント recipe 変数、およびマージ設定の更新を補間するように、Greengrass nucleus を有効化することができます。コアデバイスが、recipe 変数を設定内で使用する Greengrass コンポーネントを実行できるように、このオプションを true に設定することをお勧めします。

この機能は、このコンポーネントの v2.6.0 以降で利用可能です。

デフォルト: false

networkProxy

(オプション) すべての接続に使用するネットワークプロキシ。詳細については、「ポート 443 での接続またはネットワークプロキシを通じた接続」を参照してください。

重要

この設定パラメータに変更をデプロイすると、 Core AWS IoT Greengrass ソフトウェアが再起動して変更が有効になります。

このオブジェクトには、次の情報が含まれます。

noProxyAddresses

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

proxy

接続先のプロキシ。このオブジェクトには、次の情報が含まれます。

url

形式のURLプロキシサーバーの scheme://userinfo@host:port

  • scheme - スキーム。http または https である必要があります。

    重要

    HTTPS プロキシを使用するには、Greengrass コアデバイスで Greengrass nucleus v2.5.0 以降を実行する必要があります。

    HTTPS プロキシを設定する場合は、コアデバイスの Amazon ルート CA 証明書にプロキシサーバー CA 証明書を追加する必要があります。詳細については、「コアデバイスがHTTPSプロキシを信頼できるようにする」を参照してください。

  • userinfo - (オプション) ユーザー名とパスワードの情報。この情報を url で指定する場合、Greengrass コアデバイスは username および password フィールドを無視します。

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

  • port - (オプション) ポート番号。ポートを指定しない場合、Greengrass コアデバイスは次のデフォルト値を使用します。

    • http – 80

    • https – 443

username

(オプション) プロキシサーバーを認証するユーザー名です。

password

(オプション) プロキシサーバーを認証するパスワードです。

mqtt

(オプション) Greengrass コアデバイスMQTTの設定。詳細については、「ポート 443 での接続またはネットワークプロキシを通じた接続」を参照してください。

重要

この設定パラメータに変更をデプロイすると、 Core AWS IoT Greengrass ソフトウェアが再起動して変更が有効になります。

このオブジェクトには、次の情報が含まれます。

port

(オプション) MQTT接続に使用するポート。

デフォルト: 8883

keepAliveTimeoutMs

(オプション) MQTT接続を維持するためにクライアントが送信する各PINGメッセージ間のミリ秒単位の時間。この値は pingTimeoutMs より大きくなければなりません。

デフォルト: 60000 (60 秒)

pingTimeoutMs

(オプション) クライアントがサーバーから PINGACK メッセージを受信するまで待機する時間 (ミリ秒)。待機がタイムアウトを超えると、コアデバイスはMQTT接続を閉じて再度開きます。この値は、keepAliveTimeoutMs より小さくなければなりません。

デフォルト: 30000 (30 秒)

operationTimeoutMs

(オプション) クライアントがMQTTオペレーション ( CONNECTや などPUBLISH) が完了するまで待機するミリ秒単位の時間。このオプションは、 MQTTPINGまたはキープアライブメッセージには適用されません。

デフォルト: 30000 (30 秒)

maxInFlightPublishes

(オプション) 同時に処理できる未確認MQTTの QoS 1 メッセージの最大数。

この機能は、このコンポーネントの v2.1.0 以降に利用できます。

デフォルト: 5

有効な範囲: 最大値は 100 です。

maxMessageSizeInBytes

(オプション) MQTT メッセージの最大サイズ。メッセージがこのサイズを超えると、Greengrass nucleus でエラーとなりメッセージが拒否されます。

この機能は、このコンポーネントの v2.1.0 以降に利用できます。

デフォルト: 131072 (128 KB)

有効な範囲: 最大値は 2621440 (2.5 MB) です。

maxPublishRetry

(オプション) パブリッシュに失敗したメッセージを再試行する最大回数。-1 の再試行回数の上限はありません。

この機能は、このコンポーネントの v2.1.0 以降に利用できます。

デフォルト: 100

spooler

(オプション) Greengrass MQTT コアデバイスのスプーラー設定。このオブジェクトには、次の情報が含まれます。

storageType

メッセージを保存するためのストレージタイプ。storageType が Disk に設定されている場合、pluginName を設定できます。Memory または Disk のどちらかを指定できます。

この機能は、Greengrass nucleus コンポーネントの v2.11.0 以降で利用できます。

重要

MQTT スプーラstorageTypeが に設定Diskされていて、Greengrass nucleus をバージョン 2.11.x から以前のバージョンにダウングレードする場合は、設定を に戻す必要がありますMemory。2.10.x 以前のバージョンの Greengrass nucleus でサポートされている storageType の設定は Memory のみです。このガイダンスに従わないと、スプーラが壊れる可能性があります。これにより、Greengrass コアデバイスが にMQTTメッセージを送信できなくなります AWS クラウド。

デフォルト: Memory

pluginName

(オプション) プラグインコンポーネント名。このコンポーネントは、storageType が Disk に設定されている場合にのみ使用されます。このオプションのデフォルトは aws.greengrass.DiskSpooler で、Greengrass が提供する ディスクスプーラ を使用します。

この機能は、Greengrass nucleus コンポーネントの v2.11.0 以降で利用できます。

デフォルト: "aws.greengrass.DiskSpooler"

maxSizeInBytes

(オプション) コアデバイスが未処理のMQTTメッセージをメモリに保存するキャッシュの最大サイズ。キャッシュがいっぱいになると、新しいメッセージは拒否されます。

デフォルト: 2621440 (2.5 MB)

keepQos0WhenOffline

(オプション) コアデバイスがオフライン中に受信する MQTT QoS 0 メッセージをスプールできます。このオプションを true に設定した場合、コアデバイスは、オフライン中に送信できない QoS 0 メッセージをスプールします。このオプションを false に設定した場合、コアデバイスはこれらのメッセージを廃棄します。コアデバイスは、スプールがいっぱいでない限り、常に QoS 1 メッセージをスプールします。

デフォルト: false

version

(オプション) のバージョンMQTT。mqtt3 または mqtt5 のどちらかを指定できます。

この機能は、Greengrass nucleus コンポーネントの v2.10.0 以降で利用できます。

デフォルト: mqtt5

receiveMaximum

(オプション) ブローカーが送信できる未承認の QoS1 パケットの最大数。

この機能は、Greengrass nucleus コンポーネントの v2.10.0 以降で利用できます。

デフォルト: 100

sessionExpirySeconds

(オプション) IoT Core からのセッション継続を要求できる時間 (秒) を指定します。デフォルトは、 でサポートされる最大時間です AWS IoT Core。

この機能は、Greengrass nucleus コンポーネントの v2.10.0 以降で利用できます。

デフォルト: 604800 (7 days)

minimumReconnectDelaySeconds

(オプション) 再接続動作のオプション。が再接続MQTTする最小時間を秒単位で指定します。

この機能は、Greengrass nucleus コンポーネントの v2.10.0 以降で利用できます。

デフォルト: 1

maximumReconnectDelaySeconds

(オプション) 再接続動作のオプション。が再接続MQTTする最大時間を秒単位で指定します。

この機能は、Greengrass nucleus コンポーネントの v2.10.0 以降で利用できます。

デフォルト: 120

minimumConnectedTimeBeforeRetryResetSeconds

(オプション) 再接続動作のオプション。リトライ遅延が最小値にリセットされる以前に、接続がアクティブでなければならない時間 (秒) を指定します。

この機能は、Greengrass nucleus コンポーネントの v2.10.0 以降で利用できます。

デフォルト: 30

jvmOptions

(オプション) AWS IoT Greengrass Core ソフトウェアの実行に使用するJVMオプション。 AWS IoT Greengrass Core ソフトウェアを実行するための推奨JVMオプションについては、「」を参照してくださいJVM オプションを使用してメモリ割り当てを制御する

重要

この設定パラメータに変更をデプロイすると、 Core AWS IoT Greengrass ソフトウェアが再起動して変更が有効になります。

iotDataEndpoint

AWS IoT のデータエンドポイント AWS アカウント。

--provision true オプションを使用して AWS IoT Greengrass Core ソフトウェアを実行すると、ソフトウェアは からデータと認証情報のエンドポイントを取得し AWS IoT 、nucleus コンポーネントに設定します。

iotCredEndpoint

の AWS IoT 認証情報エンドポイント AWS アカウント。

--provision true オプションを使用して AWS IoT Greengrass Core ソフトウェアを実行すると、ソフトウェアは からデータと認証情報のエンドポイントを取得し AWS IoT 、nucleus コンポーネントに設定します。

greengrassDataPlaneEndpoint

この機能は、このコンポーネントの v2.7.0 以降で利用可能です。

詳細については、「プライベート CA によって署名されたデバイス証明書を使用する」を参照してください。

greengrassDataPlanePort

この機能は、このコンポーネントの v2.0.4 以降で利用できます。

(オプション) データプレーン接続に使用するポート。詳細については、「ポート 443 での接続またはネットワークプロキシを通じた接続」を参照してください。

重要

デバイスがアウトバウンド接続を確立できるポートを指定する必要があります。ブロックされるポートを指定すると、デバイスは に接続してデプロイ AWS IoT Greengrass を受信できなくなります。

次のオプションから選択します。

  • 443

  • 8443

デフォルト: 8443

awsRegion

AWS リージョン 使用する 。

runWithDefault

コンポーネントの実行に使用するシステムユーザー。

重要

この設定パラメータに変更をデプロイすると、 Core AWS IoT Greengrass ソフトウェアが再起動して変更が有効になります。

このオブジェクトには、次の情報が含まれます。

posixUser

コアデバイスがジェネリックコンポーネントおよび Lambda コンポーネントを実行するために使用するシステムユーザーの名前または ID (オプション)。ユーザーとグループを user:group の形式に従ってコロン (:) で区切って指定します。グループはオプションです。グループを指定しない場合、 AWS IoT Greengrass Core ソフトウェアはユーザーのプライマリグループを使用します。たとえば、ggc_userggc_user:ggc_group と指定することができます。詳細については、「コンポーネントを実行するユーザーを設定する」を参照してください。

--component-default-user ggc_user:ggc_group オプションを使用して AWS IoT Greengrass Core ソフトウェアインストーラを実行すると、ソフトウェアはこのパラメータを nucleus コンポーネントに設定します。

windowsUser

この機能は、このコンポーネントの v2.5.0 以降で利用できます。

Windows コアデバイスでこのコンポーネントを実行するために使用する Windows ユーザーの名前。ユーザーは各 Windows コアデバイスに存在し、その名前とパスワードは LocalSystem アカウントの Credentials Manager インスタンスに保存されている必要があります。詳細については、「コンポーネントを実行するユーザーを設定する」を参照してください。

--component-default-user ggc_user オプションを使用して AWS IoT Greengrass Core ソフトウェアインストーラを実行すると、ソフトウェアはこのパラメータを nucleus コンポーネントに設定します。

systemResourceLimits

この機能は、このコンポーネントの v2.4.0 以降に利用できます。 AWS IoT Greengrass は、現在 Windows コアデバイスにこの機能をサポートしていません。

デフォルトで、ジェネリックおよびコンテナ化されていない Lambda コンポーネントプロセスに適用されるシステムリソースの制限。デプロイを作成するときに、個々のコンポーネントのシステムリソース制限を上書きできます。詳細については、「コンポーネントのシステムリソース制限を設定する」を参照してください。

このオブジェクトには、次の情報が含まれます。

cpus

各コンポーネントのプロセスがコアデバイスで使用できる最大CPU時間。コアデバイスの合計CPU時間は、デバイスのCPUコア数と同等です。例えば、4 CPUコアのコアデバイスでは、この値を に設定2して、各コンポーネントのプロセスを各CPUコアの 50% の使用に制限できます。1 CPUコアのデバイスでは、この値を に設定0.25して、各コンポーネントのプロセスを の 25% の使用に制限できますCPU。この値をCPUコア数よりも大きい数に設定した場合、 AWS IoT Greengrass Core ソフトウェアはコンポーネントCPUの使用を制限しません。

memory

各コンポーネントのプロセスがコアデバイスで使用できる最大量 RAM (キロバイト単位)。

s3EndpointType

(オプション) S3 エンドポイントタイプ。このパラメータは、米国東部 (バージニア北部) (us-east-1) リージョンでのみ有効になります。他のリージョンからこのパラメータを設定すると、無視されます。次のオプションから選択します。

  • REGIONAL – S3 クライアントと署名付き はリージョンエンドポイントURLを使用します。

  • GLOBAL – S3 クライアントと署名付き はレガシーエンドポイントURLを使用します。

デフォルト: GLOBAL

fipsMode

(オプション) Greengrass がFIPSエンドポイントを使用するようにします。FIPS エンドポイントを有効にする方法の詳細については、「 エンドポイントFIPS」を参照してください。

次のオプションから選択します。

  • true true に設定すると、エンドポイントはFIPSエンドポイントを使用します。

  • false false の場合、エンドポイントはFIPSエンドポイントを使用しません。

デフォルト: false

logging

(オプション) コアデバイスのログ設定。Greengrass ログの設定と使用方法の詳細については、「AWS IoT Greengrass ログのモニタリング」を参照してください。

このオブジェクトには、次の情報が含まれます。

level

(オプション) 出力するログメッセージの最小レベル。

こちらにレベル順に一覧表示されているログレベルから選択します。

  • DEBUG

  • INFO

  • WARN

  • ERROR

デフォルト: INFO

format

(オプション) ログのデータ形式。次のオプションから選択します。

  • TEXT - ログをテキスト形式で表示する場合は、このオプションを選択します。

  • JSONGreengrass logs CLI コマンドでログを表示する場合、またはプログラムでログを操作する場合は、このオプションを選択します。

デフォルト: TEXT

outputType

(オプション) ログの出力タイプ。次のオプションから選択します。

  • FILE – AWS IoT Greengrass Core ソフトウェアは、 で指定したディレクトリ内のファイルにログを出力しますoutputDirectory

  • CONSOLE – AWS IoT Greengrass Core ソフトウェアはログを に出力しますstdout。コアデバイスがログを印刷するときにログを表示するには、このオプションを選択します。

デフォルト: FILE

fileSizeKB

(オプション) 各ログファイルの最大サイズ (キロバイト単位)。ログファイルがこの最大ファイルサイズを超えると、 AWS IoT Greengrass Core ソフトウェアは新しいログファイルを作成します。

このパラメータは、FILE または outputType が指定されている場合にのみ適用されます。

デフォルト: 1024

totalLogsSizeKB

(オプション) Greengrass nucleus を含む各コンポーネントのログファイルの最大合計サイズ (キロバイト単位)。Greengrass nucleus のログファイルには、プラグインコンポーネントからのログも含まれます。コンポーネントの合計ログファイルサイズがこの最大サイズを超えると、 AWS IoT Greengrass Core ソフトウェアはそのコンポーネントの最も古いログファイルを削除します。

このパラメータは、ログマネージャーコンポーネントディスク容量の制限パラメータ (diskSpaceLimit) と同等で、Greengrass nucleus (システム) と各コンポーネントに対して指定できます。 AWS IoT Greengrass Core ソフトウェアは、Greengrass nucleus と各コンポーネントの最大合計ログサイズとして 2 つの値の最小値を使用します。

このパラメータは、FILE または outputType が指定されている場合にのみ適用されます。

デフォルト: 10240

outputDirectory

(オプション) ログファイルの出力ディレクトリ。

このパラメータは、FILE または outputType が指定されている場合にのみ適用されます。

デフォルト: 。ここで/greengrass/v2/logs/greengrass/v2は AWS IoT Greengrass ルートフォルダです。

fleetstatus

このパラメータは、このコンポーネントの v2.1.0 以降で利用できます。

(オプション) コアデバイスのフリートステータス設定。

このオブジェクトには、次の情報が含まれます。

periodicStatusPublishIntervalSeconds

(オプション) コアデバイスがデバイスステータスを AWS クラウドにパブリッシュする時間 (秒単位)。

最小:86400 (24 時間)

デフォルト: 86400 (24 時間)

telemetry

(オプション) コアデバイスのシステムヘルステレメトリ設定。テレメトリメトリクスとテレメトリデータに対する動作の詳細については、「AWS IoT Greengrass コアデバイスからシステムヘルステレメトリデータを収集する」を参照してください。

このオブジェクトには、次の情報が含まれます。

enabled

(オプション) テレメトリを有効または無効にできます。

デフォルト: true

periodicAggregateMetricsIntervalSeconds

(オプション) コアデバイスがメトリクスを集約する間隔 (秒単位)。

この値をサポートされている最小値よりも低く設定すると、nucleus では代わりにデフォルト値が使用されます。

最小: 3600

デフォルト: 3600

periodicPublishMetricsIntervalSeconds

(オプション) コアデバイスがテレメトリメトリクスを AWS クラウドにパブリッシュする間隔 (秒単位)。

この値をサポートされている最小値よりも低く設定すると、nucleus では代わりにデフォルト値が使用されます。

最小: 86400

デフォルト: 86400

deploymentPollingFrequencySeconds

(オプション) デプロイ通知をポーリングする期間 (秒)。

デフォルト: 15

componentStoreMaxSizeBytes

(オプション) コンポーネントの recipe とアーティファクトを含む、コンポーネントストアのディスク上の最大サイズ。

デフォルト: 10000000000 (10 GB)

platformOverride

(オプション) コアデバイスのプラットフォームを識別する属性のディクショナリ。これを使用して、コンポーネント recipe がコンポーネントの正しいライフサイクルとアーティファクトを識別するために使用できるカスタムプラットフォーム属性を定義します。たとえば、ハードウェア機能属性を定義して、コンポーネントを実行するアーティファクトの最小セットのみをデプロイできます。詳細については、コンポーネント recipe の「マニフェストプラットフォームパラメータ」を参照してください。

また、このパラメータを使用して、コアデバイスの os および architecture プラットフォーム属性を上書きすることができます。

httpClient

このパラメータは、このコンポーネントの v2.5.0 以降で利用できます。

(オプション) コアデバイスのHTTPクライアント設定。これらの設定オプションは、このコンポーネントによって行われたすべてのHTTPリクエストに適用されます。コアデバイスが低速なネットワークで実行されている場合、これらのタイムアウト時間を長くして、HTTPリクエストがタイムアウトしないようにすることができます。

このオブジェクトには、次の情報が含まれます。

connectionTimeoutMs

(オプション) 接続を開いた際に接続要求がタイムアウトするまの待機時間 (ミリ秒)。

デフォルト: 2000 (2 秒)

socketTimeoutMs

(オプション) 開いている接続でデータを転送した際に接続がタイムアウトするまでの待機時間 (ミリ秒)。

デフォルト: 30000 (30 秒)

例: 設定マージの更新
{ "iotRoleAlias": "GreengrassCoreTokenExchangeRoleAlias", "networkProxy": { "noProxyAddresses": "http://192.168.0.1,www.example.com", "proxy": { "url": "http://my-proxy-server:1100", "username": "Mary_Major", "password": "pass@word1357" } }, "mqtt": { "port": 443 }, "greengrassDataPlanePort": 443, "jvmOptions": "-Xmx64m", "runWithDefault": { "posixUser": "ggc_user:ggc_group" } }

ローカルログファイル

このコンポーネントは次のログファイルを使用します。

Linux
/greengrass/v2/logs/greengrass.log
Windows
C:\greengrass\v2\logs\greengrass.log
このコンポーネントのログを確認するには
  • コアデバイスに次のコマンドを実行して、このコンポーネントのログファイルをリアルタイムに確認します。/greengrass/v2 または を置き換える C:\greengrass\v2 AWS IoT Greengrass ルートフォルダへのパスを持つ 。

    Linux
    sudo tail -f /greengrass/v2/logs/greengrass.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait

変更ログ

次の表は、コンポーネントの各バージョンにおける変更を示します。

バージョン

変更

2.13.0

バグ修正と機能向上
  • デプロイのキャンセルの改善: 新しい設定がマージされている間、およびサービスの開始を待っている間に、デプロイをキャンセルできるようになりました。

新機能
  • Nucleus でFIPSエンドポイントをサポートします。

2.12.6

バグ修正と機能向上
  • Jetson Nano を含む特定のARMv8プロセッサで起動時にクラッシュする問題を修正しました。

2.12.5

バグ修正と機能向上
  • ハード依存関係を持つ以前に壊れたコンポーネントをロールバックしているときに、デプロイのロールバックが停止することがある問題を修正しました。

  • フリートのプロビジョニング後に nucleus がステータス更新を発行しない問題を修正しました。

  • 404 エラーが発生したGetDeploymentConfigurationAPI後の の再試行を追加します。

2.12.4

バグ修正と機能向上
  • 一部の Linux デバイスで起動中に nucleus がデッドロック状態になる問題を修正しました。

2.12.3

警告

このバージョンは現在利用できません。このバージョンの改善は、このコンポーネントのそれ以降のバージョンで利用できます。

バグ修正と機能向上

  • nucleus の再起動後およびコンポーネントの復旧中に nucleus が正しいコンポーネントステータスを報告しない問題を修正しました。

  • 一般的なバグ修正と機能強化。

2.12.2

バグ修正と機能向上
  • 古いログが適切にクリーンアップされない問題を修正しました。

  • 一般的なバグ修正と機能強化。

2.12.1

バグ修正と機能向上
  • nucleus がデプロイトピックへのMQTTサブスクリプションを複製し、追加のログ記録とMQTT公開が発生する可能性がある問題を修正しました。

2.12.0

新機能
  • ロールバックデプロイの一部としてブートストラップライフサイクルステップを実行できます。

2.11.3

バグ修正と機能向上
  • 依存関係が失敗した場合にコンポーネントが不適切に起動することがある nucleus の問題を修正しました。

新機能
  • 設定可能な s3 エンドポイントタイプを追加します。

2.11.2

バグ修正と機能向上
  • 多数のサブスクリプション (> 50) MQTT が使用されているときにオフラインに表示される可能性がある nucleus 5 クライアントの問題を修正しました。

  • Docker ダイヤルのTCP失敗の再試行を追加します。

2.11.1

バグ修正と機能向上
  • ブートストラップタスクが失敗し、デプロイメタデータファイルが破損している場合に nucleus が起動しない問題を修正します。

  • オンデマンド Lambda コンポーネントがデプロイステータスの更新で報告されない問題を修正します。

  • 重複する承認ポリシー のサポートを追加しましたIDs。

2.11.0

新機能
  • ローカルのデプロイをキャンセルできます。

  • ローカルのデプロイの障害処理ポリシーを設定できます。

  • ディスクスプーラプラグインのサポートを追加します。

2.10.3

バグ修正と機能向上
  • PKCS#11 プロバイダーの使用時に Greengrass がデプロイ通知をサブスクライブしない問題を修正しました。

2.10.2

バグ修正と機能向上
  • コンポーネントのライフサイクルの大文字と小文字を区別しない解析が可能になります。

  • 環境PATH変数が正しく再作成されなかった問題を修正しました。

  • 特殊文字を含むユーザー名のストリームマネージャーを含むコンポーネントのプロキシURIエンコーディングを修正しました。

2.10.1

バグ修正と機能向上
  • Jetson Nano を含む特定のARMv8プロセッサで起動時にクラッシュする問題を修正しました。

  • Greengrass はコンポーネントの標準入力を閉じないようにしました。これにより、2.10.0 以前の動作に戻ります。

2.10.0

新機能
  • 空の正規表現に interpolateComponentConfiguration サポートを追加します。Greengrass はルート設定オブジェクトから補間するようになりました。

  • 「MQTT5」のサポートを追加。

  • プラグインコンポーネントをスキャンせずに素早く読み込むメカニズムを追加します。

  • Greengrass が未使用の Docker イメージを削除することでディスクスペースを節約できるようにします。

バグ修正と機能向上
  • ロールバック時に、特定の設定値がデプロイからそのままになる問題を修正します。

  • Greengrass nucleus がカスタム非認証情報およびデータエンドポイントで AWS ドメインシーケンスを検証する問題を修正AWS しました。

  • マルチグループの依存関係解決を更新して、アクティブなバージョンにロックするのではなく、 AWS クラウド ネゴシエーションによってすべてのグループの依存関係を再解決します。この更新により、デプロイエラーコード INSTALLED_COMPONENT_NOT_FOUND も削除されます。

  • Greengrass nucleus を更新し、既にローカルに存在する Docker イメージのダウンロードをスキップするようにしました。

  • Greengrass nucleus を更新し、タイムアウトが切れる前にコンポーネントのインストールステップを再開するようにしました。

  • 追加のマイナー修正と機能向上。

2.9.6

バグ修正と機能向上
  • Greengrass デプロイがエラー LAUNCH_DIRECTORY_CORRUPTED で失敗し、その後のデバイスの再起動が Greengrass の開始に失敗する問題を修正しました。このエラーは、Greengrass の再起動が必要なデプロイで、複数のモノグループ間で Greengrass デバイスを移動した場合に発生する場合があります。

2.9.5

新機能
  • Greengrass nucleus ソフトウェアの署名検証をサポートするようになりました。

バグ修正と機能向上
  • ローカル recipe のメタデータ領域が Greengrass nucleus の起動領域と一致しない場合に、デプロイが失敗する問題を修正しました。Greengrass nucleus は、このような場合にクラウドと再交渉するようになりました。

  • MQTT メッセージスプーラーがいっぱいになり、メッセージが削除されない問題を修正しました。

  • 追加のマイナー修正と機能向上。

2.9.4

バグ修正と機能向上
  • 0 件のメッセージを削除する前に、null QOS メッセージをチェックします。

  • ジョブステータスの詳細値は、1024 文字の制限を超えると、切り捨てられます。

  • Windows のブートストラップスクリプトを更新して、パスにスペースが含まれている場合に Greengrass ルートパスを正しく読み取れるようにします。

  • サブスクリプションレスポンスが送信されなかった場合にクライアントメッセージが削除され AWS IoT Core るように、 にサブスクライブを更新します。

  • メイン設定ファイルが破損しているかまたは見つからない場合に nucleus によってバックアップファイルから設定が確実に読み込まれます。

2.9.3

バグ修正と機能向上
  • MQTT クライアントIDsが重複していないことを確認します。

  • ファイルの読み取りと書き込みがより堅牢になり、破損の回避と回復を図っています。

  • ネットワークに関連する特定のエラーの発生時に、Docker イメージのプルを再試行するようになりました。

  • MQTT 接続noProxyAddressesのオプションを追加します。

2.9.2

バグ修正と機能向上
  • 進行中のデプロイに interpolateComponentConfiguration の設定が適用されない問題を修正しました。

  • を使用してOSHI、すべての子プロセスを一覧表示します。

2.9.1

バグ修正と機能向上
  • デプロイがプラグインコンポーネントを削除する場合に Greengrass が再起動する問題の修正を追加しました。

2.9.0

新機能
  • サブデプロイを作成して、デバイスのより小さなサブセットでデプロイを再試行する機能を追加しました。この機能により、失敗したデプロイをより効率的にテストして解決できます。

バグ修正と機能向上
  • useraddgroupadd、および usermod を持たないシステムのサポートを改善しました。

  • 追加のマイナー修正と機能向上。

2.8.1

バグ修正と機能向上
  • Greengrass エラーからデプロイエラーコードが正しく生成されない問題を修正しましたAPI。

  • デプロイ中にコンポーネントが ERRORED 状態に達したときに、フリートステータスの更新によって不正確な情報が送信される問題を修正します。

  • Greengrass の既存のサブスクリプションが 50 を超える場合にデプロイを完了できなかった問題を修正します。

2.8.0

新機能
  • コアデバイスへのコンポーネントのデプロイで問題が発生した場合に、デプロイのヘルスステータスのレスポンス (詳細なエラーコードを含む) を報告するように、Greengrass nucleus を更新します。詳細については、「詳細なデプロイエラーコード」を参照してください。

  • コンポーネントが BROKEN または ERRORED の状態になったときに、コンポーネントのヘルスステータスレスポンス (詳細なエラーコードを含む) を報告するように、Greengrass nucleus を更新します。詳細については、「詳細なコンポーネントのステータスコード」を参照してください。

  • ステータスメッセージフィールドを展開して、デバイスのクラウド可用性情報を改善します。

  • フリートステータスサービスの堅牢性を向上させます。

バグ修正と機能向上
  • 設定が変更されたときに、壊れたコンポーネントを再インストールできるようにします。

  • ブートストラップデプロイ中に nucleus が再起動するとデプロイが失敗する問題を修正します。

  • ルートパスにスペースが含まれているとインストールが失敗する Windows の問題を修正します。

  • デプロイ中にシャットダウンされたコンポーネントが新しいバージョンのシャットダウンスクリプトを使用する問題を修正します。

  • シャットダウンのさまざまな改善。

  • 追加のマイナー修正と機能向上。

2.7.0

新機能
  • コアデバイスがローカルデプロイを適用するときに、Greengrass nucleus を更新してステータス更新を AWS IoT Greengrass クラウドに送信します。

  • CA が に登録されていないカスタム認証局 (CA) によって署名されたクライアント証明書のサポートを追加します AWS IoT。この機能を使用するには、新しい greengrassDataPlaneEndpoint 設定オプションに iotdata を設定します。詳細については、「プライベート CA によって署名されたデバイス証明書を使用する」を参照してください。

バグ修正と機能向上
  • Nucleus が停止または再起動された場合の特定のシナリオで、Greengrass nucleus がデプロイをロールバックする問題を修正しました。今後 Nucleus は、再起動した後にも同じデプロイで動作します。

  • ソフトウェアをシステムサービスとしてセットアップする際、--start 引数が反映されるように Greengrass インストーラを更新しました。

  • nucleus がコンポーネントを更新したイベントのデプロイ ID を設定するように、SubscribeToComponentUpdates の動作を更新しました。

  • 追加のマイナー修正と機能向上。

2.6.0

新機能
  • ローカルパブリッシュ/サブスクライブトピックをサブスクライブするときにMQTTワイルドカードのサポートを追加します。詳細については、「ローカルメッセージをパブリッシュ/サブスクライブする」および「SubscribeToTopic」を参照してください。

  • コンポーネント構成で、component_dependency_name:configuration:json_pointer recipe 変数以外の recipe 変数がサポートされました。これらの recipe 変数は、recipe でコンポーネントの DefaultConfiguration を定義している場合、またはデプロイでコンポーネントを構成している場合に使用できます。この機能を有効にするには、interpolateComponentConfiguration設定オプションを に設定しますtrue。詳細については、「レシピ変数」および「マージ更新で recipe 変数を使用する」を参照してください。

  • プロセス間通信 (IPC) 承認ポリシーで*ワイルドカードの完全なサポートを追加しました。これにより、リソース文字列内の * 文字を、文字の任意の組み合わせと一致させる指定が可能になりました。詳細については、「承認ポリシー内のワイルドカード」を参照してください。

  • Greengrass がCLI使用するIPCオペレーションを呼び出すためのカスタムコンポーネントのサポートが追加されました。これらのIPCオペレーションを使用して、ローカルデプロイの管理、コンポーネントの詳細の表示、ローカルデバッグコンソール へのサインインに使用できるパスワードの生成を行うことができます。詳細については、IPC「: ローカルデプロイとコンポーネントを管理する」を参照してください。

バグ修正と機能向上
  • 特定のシナリオで、ハード依存関係が再起動もしくはステータスを変更をした際に、依存関係のあるコンポーネントが反応しない問題を修正しました。

  • デプロイが失敗したときにコアデバイスが AWS IoT Greengrass クラウドサービスに報告するエラーメッセージを改善しました。

  • 特定のシナリオでの Greengrass nucleus の再起動時、nucleus がモノのデプロイを 2 回適用していた問題を修正しました。

  • 追加のマイナー修正と機能向上。詳細については、「」のリリースを参照してください GitHub。

2.5.6

新機能
  • ECC キーを使用するハードウェアセキュリティモジュールのサポートを追加しました。ハードウェアセキュリティモジュール (HSM) を使用して、デバイスのプライベートキーと証明書を安全に保存できます。詳細については、「ハードウェアセキュリティ統合」を参照してください。

バグ修正と機能向上
  • 特定のシナリオで壊れたインストールスクリプトを使用してコンポーネントをデプロイすると、デプロイが完了しない問題を修正しました。

  • 起動時のパフォーマンスが向上しました。

  • 追加のマイナー修正と機能向上。

2.5.5

新機能
  • コンポーネントの GG_ROOT_CA_PATH 環境変数が追加され、カスタムコンポーネントのルート認証局 (CA) 証明書にアクセスできるようになりました。

バグ修正と機能向上
  • 英語以外の表示言語を使用する Windows デバイスのサポートが追加されました。

  • Greengrass nucleus がインストーラ引数のブール値を解析する方法が更新され、true 値を指定するブール値なしでブール引数を指定できるようになりました。たとえば、--provision true の代わりに --provision をクリックして、自動リソースプロビジョニングを使用してインストールできるようになりました。

  • 特定のシナリオでプロビジョニングした後に、コアデバイスがステータスを AWS IoT Greengrass クラウドサービスに報告しない問題を修正しました。

  • 追加のマイナー修正と機能向上。

2.5.4

バグ修正と機能向上
  • 一般的なバグ修正と機能強化。

2.5.3

新機能
  • ハードウェアセキュリティ統合のサポートが追加されました。ハードウェアセキュリティモジュール (HSM) を使用して、デバイスのプライベートキーと証明書を安全に保存できます。詳細については、「ハードウェアセキュリティ統合」を参照してください。

バグ修正と機能向上
  • nucleus が とMQTTの接続を確立している間のランタイム例外の問題を修正しました AWS IoT Core。

2.5.2

バグ修正と機能向上
  • Greengrass nucleus の更新後、デバイスを停止または再起動した後、Windows サービスが再び起動しない問題を修正しました。

2.5.1

警告

このバージョンは現在利用できません。このバージョンの改善は、このコンポーネントのそれ以降のバージョンで利用できます。

バグ修正と機能向上
  • Windows での Java ランタイム環境 (JRE) の 32 ビットバージョンのサポートを追加しました。

  • AWS IoT ポリシーで、greengrass:ListThingGroupsForCoreDevice 権限が付与されないコアデバイスのモノグループの削除動作が変更されました。このバージョンでは、デプロイは続行され、警告が記録され、モノグループからコアデバイスを削除してもコンポーネントは削除されません。詳細については、「デバイスに AWS IoT Greengrass コンポーネントのデプロイ」を参照してください。

  • Greengrass nucleus が Greengrass コンポーネントプロセスで利用できるようにするシステム環境変数の問題を修正しました。これで、コンポーネントを再起動して、最新のシステム環境変数を使用できます。

2.5.0

新機能
  • Windows を実行するコアデバイスのサポートが追加されました。

  • モノグループを削除する動作が変更されました。このバージョンでは、モノグループからコアデバイスを削除して、次のデプロイでそのモノグループのコンポーネントをアンインストールできるようになりました。

    この変更の結果として、コアデバイスの AWS IoT ポリシーには アクセスgreengrass:ListThingGroupsForCoreDevice許可が必要です。AWS IoT Greengrass Core ソフトウェアインストーラを使用してリソース をプロビジョニングした場合、デフォルトの AWS IoT ポリシーではgreengrass:*、このアクセス許可を含む が許可されます。詳細については、「AWS IoT Greengrass のデバイス認証と認可」を参照してください。

  • HTTPS プロキシ設定のサポートが追加されました。詳細については、「ポート 443 での接続またはネットワークプロキシを通じた接続」を参照してください。

  • 新しい windowsUser 設定パラメータが追加されました。このパラメータを使用して、Windows コアデバイスでコンポーネントを実行するために使用するデフォルトユーザーを指定できます。詳細については、「コンポーネントを実行するユーザーを設定する」を参照してください。

  • HTTP リクエストのタイムアウトをカスタマイズして低速ネットワークのパフォーマンスを向上させるために使用できる新しいhttpClient設定オプションが追加されました。詳細については、「 httpClient設定パラメータ」を参照してください。

バグ修正と機能向上
  • コンポーネントからコアデバイスを再起動するためのブートストラップライフサイクルオプションが修正されました。

  • recipe 変数でハイフンがサポートされるようになりました。

  • オンデマンド Lambda 関数コンポーネントのIPC認可を修正しました。

  • ログメッセージを改善し、クリティカルでないログを INFO から DEBUG レベルに変更したことで、ログの利便性が高まりました。

  • 自動プロビジョニングを使用して Core ソフトウェアをインストールしたときに Greengrass nucleus が作成するデフォルトのトークン交換ロールから アクセスiot:DescribeCertificate許可を削除します。 AWS IoT Greengrassこの権限は Greengrass nucleus では使用されません。

  • iam:CreatePolicy が、同じポリシーで利用できる場合、自動プロビジョニングスクリプトで iam:GetPolicy 権限が必要ないように問題を修正しました。

  • 追加のマイナー修正と機能向上。

2.4.0

新機能
バグ修正と機能向上
  • 起動時にログ設定を更新します。これにより、起動時にログ設定が適用されなかった問題が修正されます。

  • インストール中に、Greengrass ルートフォルダ内のコンポーネントストアを指すように nucleus ローダーのシンボリックリンクを更新します。この更新により、 AWS IoT Greengrass Core ソフトウェアのインストール時にダウンロードした JAR ファイルやその他の nucleus アーティファクトを削除できます。

  • 追加のマイナー修正と機能向上。詳細については、「」のリリースを参照してください GitHub。

2.3.0

新機能
  • iot:thingName の recipe 変数が追加されました。この recipe 変数を使用して、レシピ内のコアデバイスの AWS IoT モノの名前を取得できます。詳細については、「レシピ変数」を参照してください。

バグ修正と機能向上
  • 追加のマイナー修正と機能向上。詳細については、「」のリリースを参照してください GitHub。

2.2.0

新機能
  • ローカルシャドウ管理のIPCオペレーションを追加します。

バグ修正と機能向上
  • JAR ファイルのサイズを小さくします。

  • メモリ使用量を削減します。

  • 特定のケースでログ設定が更新されなかった問題を修正しました。

  • 追加のマイナー修正と機能向上。詳細については、「」のリリースを参照してください GitHub。

2.1.0

新機能
  • Amazon のプライベートリポジトリからの Docker イメージのダウンロードをサポートしますECR。

  • 次のパラメータを追加して、コアデバイスMQTTの設定をカスタマイズします。

    • maxInFlightPublishes – 同時に送信できる未確認MQTTの QoS 1 メッセージの最大数。

    • maxPublishRetry - パブリッシュに失敗したメッセージを再試行する最大回数。

  • fleetstatusservice 設定パラメータを追加して、コアデバイスがデバイスステータスを AWS クラウドに公開する間隔を設定します。

  • 追加のマイナー修正と機能向上。詳細については、「」のリリースを参照してください GitHub。

バグ修正と機能向上
  • nucleus が再起動したときにシャドウデプロイが複製される問題を修正しました。

  • サービスロード例外が発生したときに nucleus がクラッシュする問題を修正しました。

  • 循環依存関係を含むデプロイが失敗するように、コンポーネントの依存関係の解決が改善されました。

  • そのコンポーネントがコアデバイスから削除された場合に、プラグインコンポーネントが再デプロイされない問題を修正しました。

  • Lambda コンポーネントや root で実行するコンポーネントの /greengrass/v2/work ディレクトリに HOME 環境変数が設定される問題を修正しました。コンポーネントを実行するユーザーのホームディレクトリに HOME 変数が正しく設定されるようになりました。

  • 追加のマイナー修正と機能向上。詳細については、「」のリリースを参照してください GitHub。

2.0.5

バグ修正と機能向上
  • AWSが提供するコンポーネントをダウンロードするときに、設定されたネットワークプロキシを介してトラフィックを正しくルーティングします。

  • AWS 中国リージョンで正しい Greengrass データプレーンのエンドポイントが使用されます。

2.0.4

新機能
  • ポート 443 経由のHTTPSトラフィックを有効にします。nucleus コンポーネントのバージョン 2.0.4 の新しいgreengrassDataPlanePort設定パラメータを使用して、デフォルトのポート 8443 ではなく、ポート 443 を通過するようにHTTPS通信を設定できます。詳細については、「ポート 443 HTTPSで を設定する」を参照してください。

  • 作業パスの recipe 変数が追加されました。この recipe 変数を使用して、コンポーネントの作業フォルダへのパスを取得できます。このパスを使用して、コンポーネントとその依存関係間でファイルを共有できます。詳細については、「作業パスの recipe 変数」を参照してください。

バグ修正と機能向上
  • ロールポリシーが既に存在する場合、トークン交換 AWS Identity and Access Management (IAM) ロールポリシーの作成を防止します。

    この変更の結果、--provision true で実行する際にインストーラで iam:GetPolicysts:GetCallerIdentity が必要になります。詳細については、「インストーラがリソースをプロビジョニングするための最小限の IAM ポリシー」を参照してください。

  • まだ正常に登録されていないデプロイのキャンセルが正しく処理されるようおになりました。

  • デプロイをロールバックするときに、新しいタイムスタンプのある古いエントリが削除されるように設定を更新しました。

  • 追加のマイナー修正と機能向上。詳細については、「」のリリースを参照してください GitHub。

2.0.3

当初のバージョン