安裝 AWS IoT Greengrass 核心軟體 (CLI)

注意

這些步驟不適用於 nucleus lite。

安裝和設定 AWS IoT Greengrass Core 軟體

在您的 Greengrass 核心裝置上，執行下列命令以切換到主目錄。
Linux or Unix
```
cd ~
```
Windows Command Prompt (CMD)
```
cd %USERPROFILE%
```
PowerShell
```
cd ~
```

在您的核心裝置上，將 AWS IoT Greengrass Core 軟體下載至名為的檔案greengrass-nucleus-latest.zip。

下載此軟體，即表示您同意 Greengrass 核心軟體授權合約之規定。

將 AWS IoT Greengrass Core 軟體解壓縮至裝置上的資料夾。將 GreengrassInstaller 取代為您要使用的資料夾。

執行下列命令來啟動 AWS IoT Greengrass Core 軟體安裝程式。此命令會執行下列動作：
- 建立核心裝置操作所需的 AWS 資源。
- 將 AWS IoT Greengrass Core 軟體設定為開機時執行的系統服務。在 Linux 裝置上，這需要 Systemd init 系統。
  
  重要
  在 Windows 核心裝置上，您必須將 AWS IoT Greengrass Core 軟體設定為系統服務。
- 部署 AWS IoT Greengrass CLI 元件，這是一種命令列工具，可讓您在核心裝置上開發自訂 Greengrass 元件。
- 指定使用ggc_user系統使用者在核心裝置上執行軟體元件。在 Linux 裝置上，此命令也會指定使用ggc_group系統群組，而安裝程式會為您建立系統使用者和群組。
如下所示取代命令中的引數值。
1. /greengrass/v2 或 C：\greengrass\v2：用來安裝 AWS IoT Greengrass Core 軟體的根資料夾路徑。
2. GreengrassInstaller。解壓縮 AWS IoT Greengrass Core 軟體安裝程式的資料夾路徑。
3. 區域。尋找或建立資源 AWS 區域的。
4. MyGreengrassCore。Greengrass 核心裝置的 AWS IoT 物件名稱。如果物件不存在，安裝程式會建立它。安裝程式會下載憑證以驗證做為 AWS IoT 物件。如需詳細資訊，請參閱的裝置身分驗證和授權 AWS IoT Greengrass。
  
  注意
  物件名稱不能包含冒號 (:) 字元。
5. MyGreengrassCoreGroup。Greengrass 核心裝置的 AWS IoT 物件群組名稱。如果物件群組不存在，安裝程式會建立該物件並將其新增至該物件。如果物件群組存在且具有作用中部署，核心裝置會下載並執行部署指定的軟體。
  
  注意
  物件群組名稱不能包含冒號 (:) 字元。
6. GreengrassV2IoTThingPolicy。允許 Greengrass 核心裝置與 AWS IoT 和通訊 AWS IoT 的政策名稱 AWS IoT Greengrass。如果 AWS IoT 政策不存在，安裝程式會使用此名稱建立寬鬆 AWS IoT 政策。您可以限制此政策的使用案例許可。如需詳細資訊，請參閱AWS IoT Greengrass V2 核心裝置的最低 AWS IoT 政策。
7. GreengrassV2TokenExchangeRole。允許 Greengrass 核心裝置取得臨時 AWS 憑證的 IAM 角色名稱。如果角色不存在，安裝程式會建立該角色，並建立和連接名為的政策GreengrassV2TokenExchangeRoleAccess。如需詳細資訊，請參閱授權核心裝置與 AWS 服務互動。
8. GreengrassCoreTokenExchangeRoleAlias。IAM 角色的別名，允許 Greengrass 核心裝置稍後取得臨時憑證。如果角色別名不存在，安裝程式會建立它，並將其指向您指定的 IAM 角色。如需詳細資訊，請參閱授權核心裝置與 AWS 服務互動。
Linux or Unix
```
sudo -E java -Droot="/greengrass/v2" -Dlog.store=FILE \
  -jar ./GreengrassInstaller/lib/Greengrass.jar \
  --aws-region region \
  --thing-name MyGreengrassCore \
  --thing-group-name MyGreengrassCoreGroup \
  --thing-policy-name GreengrassV2IoTThingPolicy \
  --tes-role-name GreengrassV2TokenExchangeRole \
  --tes-role-alias-name GreengrassCoreTokenExchangeRoleAlias \
  --component-default-user ggc_user:ggc_group \
  --provision true \
  --setup-system-service true \
  --deploy-dev-tools true
```
Windows Command Prompt (CMD)
```
java -Droot="C:\greengrass\v2" "-Dlog.store=FILE" ^
  -jar ./GreengrassInstaller/lib/Greengrass.jar ^
  --aws-region region ^
  --thing-name MyGreengrassCore ^
  --thing-group-name MyGreengrassCoreGroup ^
  --thing-policy-name GreengrassV2IoTThingPolicy ^
  --tes-role-name GreengrassV2TokenExchangeRole ^
  --tes-role-alias-name GreengrassCoreTokenExchangeRoleAlias ^
  --component-default-user ggc_user ^
  --provision true ^
  --setup-system-service true ^
  --deploy-dev-tools true
```
PowerShell
```
java -Droot="C:\greengrass\v2" "-Dlog.store=FILE" `
  -jar ./GreengrassInstaller/lib/Greengrass.jar `
  --aws-region region `
  --thing-name MyGreengrassCore `
  --thing-group-name MyGreengrassCoreGroup `
  --thing-policy-name GreengrassV2IoTThingPolicy `
  --tes-role-name GreengrassV2TokenExchangeRole `
  --tes-role-alias-name GreengrassCoreTokenExchangeRoleAlias `
  --component-default-user ggc_user `
  --provision true `
  --setup-system-service true `
  --deploy-dev-tools true
```
注意
如果您在記憶體有限的 AWS IoT Greengrass 裝置上執行，您可以控制 AWS IoT Greengrass Core 軟體使用的記憶體量。若要控制記憶體配置，您可以在核子元件的jvmOptions組態參數中設定 JVM 堆積大小選項。如需詳細資訊，請參閱使用 JVM 選項控制記憶體配置。

當您執行此命令時，您應該會看到下列訊息，指出安裝程式已成功執行。
```
Successfully configured Nucleus with provisioned resource details!
Configured Nucleus to deploy aws.greengrass.Cli component
Successfully set up Nucleus as a system service
```
注意
如果您有 Linux 裝置且尚未系統化，安裝程式不會將軟體設定為系統服務，也不會看到將核設定為系統服務的成功訊息。

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

安裝 AWS IoT Greengrass Core 軟體（主控台）

執行 Greengrass 軟體 (Linux)

安裝 AWS IoT Greengrass 核心軟體 (CLI)

注意

安裝和設定 AWS IoT Greengrass Core 軟體

重要

注意

注意

注意

注意