

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

# Greengrass nucleus lite
<a name="greengrass-nucleus-lite-component"></a>

Greengrass nucleus lite (`aws.greengrass.NucleusLite`) は、メモリフットプリントを最小限に抑えるように最適化された制約のあるエッジデバイスのデバイスランタイムです (15MB 未満の RAM を使用）。 AWS IoT Greengrass バージョン 2.14.0 リリースで導入され、 AWS IoT Greengrass 汎用コンポーネント、Greengrass V2 API、および SDK との下位互換性があります。

Greengrass nucleus lite は、一般的な [Greengrass nucleus (`aws.greengrass.Nucleus`)](https://docs.aws.amazon.com/greengrass/v2/developerguide/greengrass-nucleus-component.html) の代替として提供され、Greengrass デバイスの異種混在フリートで使用できます。

**Topics**
+ [バージョン](#greengrass-nucleus-lite-component-versions)
+ [オペレーティングシステム](#greengrass-nucleus-lite-component-os-support)
+ [要件](#greengrass-nucleus-lite-component-requirements)
+ [互換性](#greengrass-nucleus-lite-component-compatibility)
+ [ダウンロードとインストール](#greengrass-nucleus-lite-component-install)
+ [設定](#greengrass-nucleus-lite-component-configuration)
+ [ローカルログファイル](#greengrass-nucleus-lite-component-log-file)
+ [変更ログ](#greengrass-nucleus-lite-component-changelog)

## バージョン
<a name="greengrass-nucleus-lite-component-versions"></a>

このコンポーネントには、次のバージョンがあります。
+ 2.5.x
+ 2.4.x
+ 2.3.x
+ 2.2.x
+ 2.1.x
+ 2.0.x

## オペレーティングシステム
<a name="greengrass-nucleus-lite-component-os-support"></a>

このコンポーネントは、次のオペレーティングシステムを実行するコアデバイスにインストールできます。
+ Linux (systemd を使用したディストリビューション)

詳細については、「[Greengrass nucleus](https://docs.aws.amazon.com/greengrass/v2/developerguide/operating-system-feature-support-matrix.html)」を参照してください。

## 要件
<a name="greengrass-nucleus-lite-component-requirements"></a>

デバイスは、nucleus AWS IoT Greengrass lite と AWS IoT Greengrass Core ソフトウェアをインストールして実行する特定の要件を満たしている必要があります。詳細については、「[Setup guide](https://github.com/aws-greengrass/aws-greengrass-lite/blob/main/docs/SETUP.md#setting-up-greengrass-nucleus-lite)」を参照してください。
+ nucleus ランタイム用の 15MB の RAM スペース。
+ 5 MB のストレージ (ディスク/FLASH)。

その他のシステム依存関係については、「[Setup Guide](https://github.com/aws-greengrass/aws-greengrass-lite/blob/main/docs/SETUP.md#dependencies)」を参照してください。

Greengrass nucleus コンポーネントは、VPC での実行がサポートされています。このコンポーネントを VPC にデプロイするには、以下が必要です。
+ Greengrass nucleus は、 AWS IoT データ、 AWS IoT 認証情報、Amazon S3 に接続する必要があります。

 AWS IoT Greengrass nucleus lite を非ルートユーザーとして実行するには、ルートレスコンテナを使用できます。詳細については、 AWS IoT Greengrass nucleus lite GitHub リポジトリの[「Podman](https://github.com/aws-greengrass/aws-greengrass-lite/blob/main/docs/BUILD.md#optional-using-podman) の使用」を参照してください。

## 互換性
<a name="greengrass-nucleus-lite-component-compatibility"></a>

 AWS IoT Greengrass nucleus lite は、v2 API ( のサブセット) AWS IoT Greengrass およびサポートされている SDKs。特定の言語ランタイム/VM には依存しませんが、デプロイに追加されるコンポーネントには特定のランタイム (Java JVM、Python など) が必要になる場合があります。Greengrass nucleus lite でサポートされている機能の詳細については、「[Greengrass 機能の互換性](operating-system-feature-support-matrix.md)」を参照してください。

## ダウンロードとインストール
<a name="greengrass-nucleus-lite-component-install"></a>

apt パッケージをダウンロードしたり、[ソースから構築](https://github.com/aws-greengrass/aws-greengrass-lite/blob/main/README.md#getting-started)したり、[Yocto レイヤーを使用](https://github.com/aws4embeddedlinux/meta-aws)したり、互換性のあるデバイス (RaspberryPi など) 用に[構築済みの Yocto イメージをダウンロード](https://github.com/aws4embeddedlinux/meta-aws-demos)したりできます。[AWS IoT Core コンソール](https://console.aws.amazon.com/iot/home)から、デバイスのすべての認証情報と初期設定を含む**接続キット**をダウンロードできます。インストールする手順は、各特定のディストリビューション方法に含まれています。

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

## 設定
<a name="greengrass-nucleus-lite-component-configuration"></a>

Nucleus は以下の[設定](https://github.com/aws-greengrass/aws-greengrass-lite/blob/main/docs/SETUP.md#configuring-greengrass)パラメータを提供します。一部のパラメータでは、 Core AWS IoT Greengrass ソフトウェアを有効にするために再起動する必要があります。

`iotRoleAlias`  
トークン交換 IAM AWS IoT ロールを指すロールエイリアス。 AWS IoT 認証情報プロバイダーはこのロールを引き受けて、Greengrass コアデバイスが AWS サービスとやり取りできるようにします。詳細については、[「 コアデバイスが AWS サービスとやり取りすることを許可する」を参照してください。](https://docs.aws.amazon.com/greengrass/v2/developerguide/device-service-role.html)

`iotDataEndpoint`  
<a name="nucleus-component-configuration-iot-data-endpoint"></a> AWS IoT のデータエンドポイント AWS アカウント。

`iotCredEndpoint`  
<a name="nucleus-component-configuration-iot-cred-endpoint"></a>の AWS IoT 認証情報エンドポイント AWS アカウント。

`greengrassDataPlanePort`  
データプレーン接続に使用するポート。詳細については、「[Connect on port 443 or through a network proxy](https://docs.aws.amazon.com/greengrass/v2/developerguide/configure-greengrass-core-v2.html#configure-alpn-network-proxy)」を参照してください。  
デバイスがアウトバウンド接続を確立できるポートを指定する必要があります。ブロックされているポートを指定すると、デバイスは に接続 AWS IoT Greengrass してデプロイを受信できなくなります。次のオプションから選択します。  
+ `443`
+ `8443`
+ デフォルト: `8443`

`awsRegion`  
 AWS リージョン 使用する 。

`runWithDefault`  
コンポーネントの実行に使用するシステムユーザー。  
<a name="nucleus-component-parameter-restart-para"></a>この設定パラメータに変更をデプロイすると、変更を有効にするために AWS IoT Greengrass Core ソフトウェアが再起動します。
このオブジェクトには、次の情報が含まれます。    
`posixUser`  
コアデバイスが汎用コンポーネントを実行するために使用するシステムユーザーの名前または ID、およびシステムグループ (オプション)。ユーザーとグループを `user:group` の形式に従ってコロン (`:`) で区切って指定します。グループはオプションです。グループを指定しない場合、 AWS IoT Greengrass Core ソフトウェアはユーザーのプライマリグループを使用します。たとえば、`ggc_user` や `ggc_user:ggc_group` と指定することができます。詳細については、「[コンポーネントを実行するユーザーを設定する](configure-greengrass-core-v2.md#configure-component-user)」を参照してください。

`networkProxy`  
(オプション) すべての接続に使用するネットワークプロキシ。詳細については、「[ポート 443 での接続またはネットワークプロキシを通じた接続](configure-greengrass-core-v2.md#configure-alpn-network-proxy)」を参照してください。  
この設定パラメータに変更をデプロイすると、その変更は AWS IoT Greengrass Core ソフトウェアの次回の再起動後に有効になります。
このオブジェクトには、次の情報が含まれます。    
`noProxyAddresses`  
(オプション) プロキシの対象外となる IP アドレスやホスト名のカンマ区切りリスト。  
`proxy`  
接続先のプロキシ。このオブジェクトには、次の情報が含まれます。    
`url`  
プロキシサーバーの URL (`http://host:port` 形式)。  
+ `scheme` - スキーム。`http` である必要があります。
+ `host` – プロキシサーバーのホスト名または IP アドレス。
+ `port` - (オプション) ポート番号。ポートを指定しない場合、Greengrass コアデバイスは以下のデフォルト値を使用します。
  + `http` – 80

## ローカルログファイル
<a name="greengrass-nucleus-lite-component-log-file"></a>

メッセージは stdout に記録され、ログファイルは systemd によって処理されます。

**このコンポーネントのログを確認するには**
+ `journalctl` を使用してログを表示します。

## 変更ログ
<a name="greengrass-nucleus-lite-component-changelog"></a>


|  **バージョン**  |  **変更**  | 
| --- | --- | 
| 2.5.1 |  **バグ修正と機能向上**<br />   設定値が実際に変更されなかったときに がサブスクライバーに通知`SubscribeToConfigurationUpdate`できる問題を修正しました。   コンポーネントのデプロイソース ARN が無関係なデプロイによって上書きされる可能性がある問題を修正しました。   5xx や 429 などの再試行可能なエラーコードで HTTP アーティファクトのダウンロードの再試行がトリガーされない問題を修正しました。     | 
| 2.5.0 |  **新機能**<br />   PKCS\#11 サポートを追加しました。OpenSSL プロバイダーでは、PKCS\#11-backed キーと証明書ハンドルを使用できます。   フリートプロビジョニングで TPM を使用するためのサポートを追加しました。   <br />**バグ修正と機能向上**<br />   v2.4.0 で導入されたフリートプロビジョニングのリグレッションを修正しました。   v2.4.0 で発生したアーティファクトアクセス許可の所有権の問題を修正しました。     | 
| 2.4.0 |  **新機能**<br />   ローカルデプロイ`--group-name`と`--remove-component`オプションのサポートを追加しました。   レシピからアーティファクトのアクセス許可を適用します。   <br />**バグ修正と機能向上**<br />   MQTT メッセージが次のキープアライブ間隔まで遅延する問題を修正しました。   iotcored がデッドロックに入って再接続できない問題を修正しました。   HTTP プロキシを使用する場合の SSL 検証の失敗を修正しました。   接続の信頼性が向上しました。     | 
| 2.3.3 |  **バグ修正と機能向上**<br />   デプロイ中にコンポーネントを作成する際のファイル記述子のリークを修正しました。   デプロイジョブのステータスレポートが拒否される可能性がある問題を修正しました。   デプロイに失敗する前に、コンポーネントのインストールフェーズが最大 3 回再試行できるようにします。   一般的なバグ修正と機能強化。     | 
| 2.3.2 |  **バグ修正と機能向上**<br />   正しい nucleus バージョンレポート用にバージョンファイルを更新します。     | 
| 2.3.1 |  **バグ修正と機能向上**<br />   GG は、キャンセルされたジョブのデプロイ状態の更新を試みません。   fdopendir からの DIR が閉じていることを確認します。   フリートプロビジョニングでは、実行ごとに証明書ファイルの上書きがトリガーされるようになりました。   その他の軽微なバグ修正。     | 
| 2.3.0 |  **新機能**<br />   IoT Core MQTT 認可に [ TPM 2.0 を使用する](gg-lite-with-tpm-tutorial.md)ためのサポート。   サンプル apt パッケージは、より多くのオペレーティングシステムをサポートするようになりました: Ubuntu 22.04、Ubuntu 24.04、Debian 12、および Debian 13。   RestartComponent IPC がサポートされるようになりました。   <br />**バグ修正と機能向上**<br />   ローカルデプロイでは、インターネットアクセスが不要になりました。   GetConfiguration が Greengrass Nucleus ランタイム動作と一致するように更新されました。(**重大な変更**)   一般的なバグ修正と機能強化。     | 
| 2.2.2 |  **バグ修正と機能向上**<br />   変更されていないコンポーネントにアーティファクトとして実行中の実行可能ファイルがある場合に、変更されていないコンポーネントバージョンを含む改訂されたデプロイが失敗する問題を修正しました。   補間された値にネストされたサブオブジェクトが 4 つ以上ある場合のレシピ変数の補間を修正しました。   引用符やシェル特殊文字を含むレシピ変数の補間を修正しました。    MQTT 接続が失敗した場合の fds のリークを修正しました。     | 
| 2.2.1 |  **バグ修正と機能向上**<br />   Nucleus が TES 認証情報を取得できない問題を修正しました。     | 
| 2.2.0 |  **新機能**<br />   コンテナイメージアーティファクト URI のサポートを追加しました。   <br />**バグ修正と機能向上**<br />   一般的なバグ修正と機能強化。     | 
| 2.1.0 |  **新機能**<br />   `networkProxy` 設定オプションを使用して設定できる HTTP プロキシのサポートを追加しました。   <br />**バグ修正と機能向上**<br />   古い `libcurl` バージョンを実行しているデバイスに対応するため、`libcurl` の要件を 7.86 から 7.82 に引き下げました。   `journalctl` ログを更新して、recipe-runner ではなくコンポーネントに帰属するようにしました。   IPC 呼び出しのエラーレスポンスを改善しました。   汎用コンポーネントアーティファクトの S3 ダウンロード試行の再試行を追加しました。   軽微なバグを修正。     | 
| 2.0.2 |  **バグ修正と機能向上**<br />   `cgroup-tools` を含むように apt パッケージの依存関係を修正しました。     | 
| 2.0.1 |  **バグ修正と機能向上**<br />   Greengrass レシピのタイムアウトセクションのレシピ変数補間サポートを追加しました。   ストリームマネージャーの ValidateAuthorizationToken IPC コマンドのサポートを追加しました。   フリートプロビジョニングからの警告を修正しました。   ジョブリスナーに再試行とバックオフを追加しました。   一般的なバグ修正と機能強化。     | 
| 2.0.0 | 当初のバージョン | 