本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

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

Greengrass nucleus lite (`aws.greengrass.NucleusLite`) 是一種裝置執行時間，適用於針對最少記憶體使用量 （使用少於 5MB RAM) 進行最佳化的限制邊緣裝置。它隨 2.14.0 AWS IoT Greengrass 版推出，並且與 AWS IoT Greengrass 一般元件、Greengrass V2 API 和 SDK 回溯相容。

Greengrass 核精簡版是通用 [Greengrass 核 (`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)
+ [Configuration](#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 核](https://docs.aws.amazon.com/greengrass/v2/developerguide/operating-system-feature-support-matrix.html)。

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

裝置必須符合特定需求，才能安裝和執行 nucleus lite AWS IoT Greengrass 和 AWS IoT Greengrass Core 軟體。如需詳細資訊，請參閱[設定指南](https://github.com/aws-greengrass/aws-greengrass-lite/blob/main/docs/SETUP.md#setting-up-greengrass-nucleus-lite)。
+ 核執行時間的 5MB RAM 空間。
+ 5MB 的儲存體 （磁碟/快閃記憶體）。

其他系統相依性記錄在 [設定指南](https://github.com/aws-greengrass/aws-greengrass-lite/blob/main/docs/SETUP.md#dependencies)中。

Greengrass 核元件支援在 VPC 中執行。若要在 VPC 中部署此元件，需要下列項目：
+ Greengrass 核必須能夠連線至 AWS IoT 資料、 AWS IoT 憑證和 Amazon S3。

若要以非根使用者身分執行 AWS IoT Greengrass nucleus lite，您可以使用無根容器。如需詳細資訊，請參閱在 nucleus lite GitHub AWS IoT Greengrass 儲存庫中使用 [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 與 AWS IoT Greengrass v2 API （子集） 和支援的 SDKs 相容。它不依賴於任何特定語言執行時間/VMs但新增至部署的元件可能需要特定執行時間 （例如：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 layer](https://github.com/aws4embeddedlinux/meta-aws)，或[下載相容裝置 （例如 RaspberryPi) 的預先建置 Yocto 映像](https://github.com/aws4embeddedlinux/meta-aws-demos)。 RaspberryPi 從 [AWS IoT Core 主控台](https://console.aws.amazon.com/iot/home)，您將能夠下載包含裝置所有登入資料和初始組態的**連線套件**。如何安裝的指示會包含在每個特定的分發方法中。

您也可以遵循教學課程來安裝 nucleus lite AWS IoT Greengrass 並探索 Greengrass 元件開發。如需詳細資訊，請參閱[教學課程：入門 AWS IoT Greengrass V2](getting-started.md)。

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

核提供下列[組態](https://github.com/aws-greengrass/aws-greengrass-lite/blob/main/docs/SETUP.md#configuring-greengrass)參數。有些參數需要 AWS IoT Greengrass Core 軟體重新啟動才能生效。

`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`  
用於資料平面連線的連接埠。如需詳細資訊，請參閱[連接埠 443 上的連線或透過網路代理連線](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 核心軟體會重新啟動，讓變更生效。
此物件包含下列資訊：    
`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 核心軟體後生效。
此物件包含下列資訊：    
`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 |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html)  | 
| 2.5.0 |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html)  | 
| 2.4.0 |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html)  | 
| 2.3.3 |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html)  | 
| 2.3.2 |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html)  | 
| 2.3.1 |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html)  | 
| 2.3.0 |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html)  | 
| 2.2.2 |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html)  | 
| 2.2.1 |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html)  | 
| 2.2.0 |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html)  | 
| 2.1.0 |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html)  | 
| 2.0.2 |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html)  | 
| 2.0.1 |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html)  | 
| 2.0.0 | 初始版本。 |