使用 AWS IoT 機群佈建安裝 AWS IoT Greengrass 核心軟體

1. 取得 AWS IoT 的資料端點 AWS 帳戶。

   aws iot describe-endpoint --endpoint-type iot:Data-ATS

   如果請求成功，回應看起來與下列範例類似。

   {
     "endpointAddress": "device-data-prefix-ats.iot.us-west-2.amazonaws.com"
   }

2. 取得 的 AWS IoT 登入資料端點 AWS 帳戶。

   aws iot describe-endpoint --endpoint-type iot:CredentialProvider

   如果請求成功，回應看起來與下列範例類似。

   {
     "endpointAddress": "device-credentials-prefix.credentials.iot.us-west-2.amazonaws.com"
   }

將宣告憑證下載至裝置

1. 將宣告憑證和私有金鑰複製到裝置。如果在開發電腦和裝置上啟用 SSH 和 SCP，您可以使用開發電腦上的 scp命令來傳輸宣告憑證和私有金鑰。下列範例命令claim-certs會將開發電腦上名為 的資料夾傳輸至裝置。將 device-ip-address 取代為您裝置的 IP 地址。

   scp -r claim-certs/ device-ip-address:~

2. 在裝置上建立 Greengrass 根資料夾。您稍後將安裝 AWS IoT Greengrass Core 軟體到此資料夾。

   注意

   Windows 的路徑長度限制為 260 個字元。如果您使用的是 Windows，請使用根資料夾，例如 C:\greengrass\v2或 D:\greengrass\v2 ，將 Greengrass 元件路徑保持在 260 個字元限制以下。

   Linux or Unix

   • /greengrass/v2 將 取代為要使用的資料夾。

   sudo mkdir -p /greengrass/v2

   Windows Command Prompt

   • 將 C：\greengrass\v2 取代為要使用的資料夾。

   mkdir C:\greengrass\v2

   PowerShell

   • 將 C：\greengrass\v2 取代為要使用的資料夾。

   mkdir C:\greengrass\v2

   anchoranchoranchor
   • Linux or Unix
   • Windows Command Prompt
   • PowerShell

   • /greengrass/v2 將 取代為要使用的資料夾。

   sudo mkdir -p /greengrass/v2

3. （僅限 Linux) 設定 Greengrass 根資料夾父項的許可。

   • 將 /greengrass 取代為根資料夾的父系。

   sudo chmod 755 /greengrass

4. 將宣告憑證移至 Greengrass 根資料夾。

   • 將 /greengrass/v2或 C：\greengrass\v2 取代為 Greengrass 根資料夾。

   Linux or Unix

   sudo mv ~/claim-certs /greengrass/v2

   Windows Command Prompt (CMD)

   move %USERPROFILE%\claim-certs C:\greengrass\v2

   PowerShell

   mv -Path ~\claim-certs -Destination C:\greengrass\v2

   anchoranchoranchor
   • Linux or Unix
   • Windows Command Prompt (CMD)
   • PowerShell

   sudo mv ~/claim-certs /greengrass/v2

5. 根據預設，下載 Amazon 根憑證授權機構 (CA) certificate. AWS IoT certificates 會與 Amazon 的根 CA 憑證相關聯。

   Linux or Unix

   sudo curl -o /greengrass/v2/AmazonRootCA1.pem https://www.amazontrust.com/repository/AmazonRootCA1.pem

   Windows Command Prompt (CMD)

   curl -o C:\greengrass\v2\\AmazonRootCA1.pem https://www.amazontrust.com/repository/AmazonRootCA1.pem

   PowerShell

   iwr -Uri https://www.amazontrust.com/repository/AmazonRootCA1.pem -OutFile C:\greengrass\v2\\AmazonRootCA1.pem

   anchoranchoranchor
   • Linux or Unix
   • Windows Command Prompt (CMD)
   • PowerShell

   sudo curl -o /greengrass/v2/AmazonRootCA1.pem https://www.amazontrust.com/repository/AmazonRootCA1.pem

為 設定 Linux 裝置 AWS IoT Greengrass V2

1. 安裝 AWS IoT Greengrass 執行核心軟體所需的 Java 執行期。我們建議您使用 Amazon Corretto 或 OpenJDK 長期支援版本。第 8 版或更新版本為必要項目。下列命令說明如何在裝置上安裝 OpenJDK。

   • 針對 Debian 為基礎或 Ubuntu 為基礎的發行版本：

     sudo apt install default-jdk

   • 針對 Red Hat 為基礎的發行版本：

     sudo yum install java-11-openjdk-devel

   • 針對 Amazon Linux 2：

     sudo amazon-linux-extras install java-openjdk11

   • 針對 Amazon Linux 2023：

     sudo dnf install java-11-amazon-corretto -y

   安裝完成時，請執行下列命令，以確認 Java 在您的 Linux 裝置上執行。

   java -version

   命令會列印在裝置上執行的 Java 版本。例如，在 Debian 型分佈上，輸出看起來可能會類似下列範例。

   openjdk version "11.0.9.1" 2020-11-04
   OpenJDK Runtime Environment (build 11.0.9.1+1-post-Debian-1deb10u2)
   OpenJDK 64-Bit Server VM (build 11.0.9.1+1-post-Debian-1deb10u2, mixed mode)

2. （選用） 建立在裝置上執行元件的預設系統使用者和群組。您也可以選擇讓 AWS IoT Greengrass Core 軟體安裝程式在安裝期間使用--component-default-user安裝程式引數建立此使用者和群組。如需詳細資訊，請參閱安裝程式引數。

   sudo useradd --system --create-home ggc_user
   sudo groupadd --system ggc_group

3. 確認執行 AWS IoT Greengrass Core 軟體的使用者 （通常為 root) 具有許可，可sudo搭配任何使用者和任何群組執行 。

   1. 執行下列命令以開啟 /etc/sudoers 檔案。

      sudo visudo

   2. 確認使用者的許可如下所示。

      root    ALL=(ALL:ALL) ALL

4. （選用） 若要執行容器化 Lambda 函數，您必須啟用 cgroups v1，而且必須啟用並掛載記憶體和裝置 cgroups。如果您不打算執行容器化 Lambda 函數，您可以略過此步驟。

   若要啟用這些 cgroups 選項，請使用下列 Linux 核心參數啟動裝置。

   cgroup_enable=memory cgroup_memory=1 systemd.unified_cgroup_hierarchy=0

   如需有關檢視和設定裝置核心參數的資訊，請參閱您作業系統和開機載入器的文件。依照指示永久設定核心參數。

5. 在裝置上安裝所有其他必要的相依性，如 中的需求清單所示裝置要求。

為 設定 Windows 裝置 AWS IoT Greengrass V2

1. 安裝 AWS IoT Greengrass 執行核心軟體所需的 Java 執行期。我們建議您使用 Amazon Corretto 或 OpenJDK 長期支援版本。第 8 版或更新版本為必要項目。

2. 檢查 PATH 系統變數上是否提供 Java，如果沒有，請新增 Java。LocalSystem 帳戶會執行 AWS IoT Greengrass Core 軟體，因此您必須將 Java 新增至 PATH 系統變數，而不是使用者的 PATH 使用者變數。請執行下列操作：

   1. 按 Windows 鍵開啟開始選單。

   2. 輸入 environment variables 以從開始功能表搜尋系統選項。

   3. 在開始功能表搜尋結果中，選擇編輯系統環境變數以開啟系統屬性視窗。

   4. 選擇環境變數...以開啟環境變數視窗。

   5. 在系統變數下，選取路徑，然後選擇編輯。在編輯環境變數視窗中，您可以在單獨的一行上檢視每個路徑。

   6. 檢查 Java 安裝bin資料夾的路徑是否存在。路徑看起來可能會類似下列範例。

      C:\\Program Files\\Amazon Corretto\\jdk11.0.13_8\\bin

   7. 如果路徑中缺少 Java 安裝的bin資料夾，請選擇新增以新增，然後選擇確定。

3. 以管理員身分開啟 Windows 命令提示字元 (cmd.exe)。

4. 在 Windows 裝置上的 LocalSystem 帳戶中建立預設使用者。將密碼取代為安全密碼。

   net user /add ggc_user password

   提示

   根據您的 Windows 組態，使用者的密碼可能會設定為在未來的日期過期。為了確保您的 Greengrass 應用程式持續運作，請追蹤密碼過期的時間，並在過期前更新它。您也可以將使用者的密碼設定為永不過期。

   • 若要檢查使用者及其密碼何時過期，請執行下列命令。

     net user ggc_user | findstr /C:expires

   • 若要將使用者的密碼設定為永不過期，請執行下列命令。

     wmic UserAccount where "Name='ggc_user'" set PasswordExpires=False

   • 如果您使用的是wmic已棄用命令的 Windows 10 或更新版本，請執行下列 PowerShell 命令。

     Get-CimInstance -Query "SELECT * from Win32_UserAccount WHERE name = 'ggc_user'" | Set-CimInstance -Property @{PasswordExpires="False"}

5. 在裝置上從 Microsoft 下載並安裝 PsExec 公用程式。

6. 使用 PsExec 公用程式，將預設使用者的使用者名稱和密碼存放在 LocalSystem 帳戶的 Credential Manager 執行個體中。將密碼取代為您先前設定的使用者密碼。

   psexec -s cmd /c cmdkey /generic:ggc_user /user:ggc_user /pass:password

   如果 PsExec License Agreement開啟，請選擇 以Accept同意授權並執行 命令。

   注意

   在 Windows 裝置上，LocalSystem 帳戶會執行 Greengrass 核，而且您必須使用 PsExec 公用程式將預設使用者資訊存放在 LocalSystem 帳戶中。使用 Credential Manager 應用程式會將此資訊存放在目前登入使用者的 Windows 帳戶中，而不是 LocalSystem 帳戶。

下載 AWS IoT Greengrass Core 軟體

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

   Linux or Unix

   curl -s https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-nucleus-latest.zip > greengrass-nucleus-latest.zip

   Windows Command Prompt (CMD)

   curl -s https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-nucleus-latest.zip > greengrass-nucleus-latest.zip

   PowerShell

   iwr -Uri https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-nucleus-latest.zip -OutFile greengrass-nucleus-latest.zip

   anchoranchoranchor
   • Linux or Unix
   • Windows Command Prompt (CMD)
   • PowerShell

   curl -s https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-nucleus-latest.zip > greengrass-nucleus-latest.zip

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

2. （選用） 驗證 Greengrass 核軟體簽章

   注意

   此功能適用於 Greengrass nucleus 2.9.5 版及更新版本。

   1. 使用下列命令來驗證 Greengrass 核子成品的簽章：

      Linux or Unix

      jarsigner -verify -certs -verbose greengrass-nucleus-latest.zip

      Windows Command Prompt (CMD)

      檔案名稱看起來可能會有所不同，視您安裝的 JDK 版本而定。jdk17.0.6_10 將 取代為您安裝的 JDK 版本。

      "C:\\Program Files\\Amazon Corretto\\jdk17.0.6_10\\bin\\jarsigner.exe" -verify -certs -verbose greengrass-nucleus-latest.zip

      PowerShell

      檔案名稱看起來可能會有所不同，視您安裝的 JDK 版本而定。jdk17.0.6_10 將 取代為您安裝的 JDK 版本。

      'C:\\Program Files\\Amazon Corretto\\jdk17.0.6_10\\bin\\jarsigner.exe' -verify -certs -verbose greengrass-nucleus-latest.zip

      anchoranchoranchor
      • Linux or Unix
      • Windows Command Prompt (CMD)
      • PowerShell

      jarsigner -verify -certs -verbose greengrass-nucleus-latest.zip

   2. jarsigner 調用會產生輸出，指出驗證結果。

      1. 如果已簽署 Greengrass 核 zip 檔案，輸出會包含下列陳述式：

         jar verified.

      2. 如果未簽署 Greengrass 核 zip 檔案，輸出會包含下列陳述式：

         jar is unsigned.

   3. 如果您提供 Jarsigner -certs選項以及 -verify和 -verbose選項，輸出也會包含詳細的簽署者憑證資訊。

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

   Linux or Unix

   unzip greengrass-nucleus-latest.zip -d GreengrassInstaller && rm greengrass-nucleus-latest.zip

   Windows Command Prompt (CMD)

   mkdir GreengrassInstaller && tar -xf greengrass-nucleus-latest.zip -C GreengrassInstaller && del greengrass-nucleus-latest.zip

   PowerShell

   Expand-Archive -Path greengrass-nucleus-latest.zip -DestinationPath .\\GreengrassInstaller
   rm greengrass-nucleus-latest.zip

   anchoranchoranchor
   • Linux or Unix
   • Windows Command Prompt (CMD)
   • PowerShell

   unzip greengrass-nucleus-latest.zip -d GreengrassInstaller && rm greengrass-nucleus-latest.zip

4. （選用） 執行下列命令以查看 AWS IoT Greengrass Core 軟體的版本。

   java -jar ./GreengrassInstaller/lib/Greengrass.jar --version

下載 AWS IoT 機群佈建外掛程式

• 在您的裝置上，將 AWS IoT 機群佈建外掛程式下載至名為 的檔案aws.greengrass.FleetProvisioningByClaim.jar。將 GreengrassInstaller 取代為您要使用的資料夾。

  Linux or Unix

  curl -s https://d2s8p88vqu9w66.cloudfront.net/releases/aws-greengrass-FleetProvisioningByClaim/fleetprovisioningbyclaim-latest.jar > GreengrassInstaller/aws.greengrass.FleetProvisioningByClaim.jar

  Windows Command Prompt (CMD)

  curl -s https://d2s8p88vqu9w66.cloudfront.net/releases/aws-greengrass-FleetProvisioningByClaim/fleetprovisioningbyclaim-latest.jar > GreengrassInstaller/aws.greengrass.FleetProvisioningByClaim.jar

  PowerShell

  iwr -Uri https://d2s8p88vqu9w66.cloudfront.net/releases/aws-greengrass-FleetProvisioningByClaim/fleetprovisioningbyclaim-latest.jar -OutFile GreengrassInstaller/aws.greengrass.FleetProvisioningByClaim.jar

  anchoranchoranchor
  • Linux or Unix
  • Windows Command Prompt (CMD)
  • PowerShell

  curl -s https://d2s8p88vqu9w66.cloudfront.net/releases/aws-greengrass-FleetProvisioningByClaim/fleetprovisioningbyclaim-latest.jar > GreengrassInstaller/aws.greengrass.FleetProvisioningByClaim.jar

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

安裝 AWS IoT Greengrass Core 軟體

1. 檢查 AWS IoT Greengrass Core 軟體的版本。

   • 將 GreengrassInstaller 取代為包含 軟體之資料夾的路徑。

   java -jar ./GreengrassInstaller/lib/Greengrass.jar --version

2. 使用文字編輯器來建立名為 的組態檔案config.yaml，以提供給安裝程式。

   例如，在以 Linux 為基礎的系統上，您可以執行下列命令來使用 GNU nano 來建立 檔案。

   nano GreengrassInstaller/config.yaml

   將下列 YAML 內容複製到 檔案。此部分組態檔案會指定機群佈建外掛程式的參數。如需您可以指定之選項的詳細資訊，請參閱設定 AWS IoT 機群佈建外掛程式。

   Linux or Unix

   ---
   services:
     aws.greengrass.Nucleus:
       version: "2.14.0"
     aws.greengrass.FleetProvisioningByClaim:
       configuration:
         rootPath: "/greengrass/v2"
         awsRegion: "us-west-2"
         iotDataEndpoint: "device-data-prefix-ats.iot.us-west-2.amazonaws.com"
         iotCredentialEndpoint: "device-credentials-prefix.credentials.iot.us-west-2.amazonaws.com"
         iotRoleAlias: "GreengrassCoreTokenExchangeRoleAlias"
         provisioningTemplate: "GreengrassFleetProvisioningTemplate"
         claimCertificatePath: "/greengrass/v2/claim-certs/claim.pem.crt"
         claimCertificatePrivateKeyPath: "/greengrass/v2/claim-certs/claim.private.pem.key"
         rootCaPath: "/greengrass/v2/AmazonRootCA1.pem"
         templateParameters:
           ThingName: "MyGreengrassCore"
           ThingGroupName: "MyGreengrassCoreGroup"

   Windows

   ---
   services:
     aws.greengrass.Nucleus:
       version: "2.14.0"
     aws.greengrass.FleetProvisioningByClaim:
       configuration:
         rootPath: "C:\\greengrass\\v2"
         awsRegion: "us-west-2"
         iotDataEndpoint: "device-data-prefix-ats.iot.us-west-2.amazonaws.com"
         iotCredentialEndpoint: "device-credentials-prefix.credentials.iot.us-west-2.amazonaws.com"
         iotRoleAlias: "GreengrassCoreTokenExchangeRoleAlias"
         provisioningTemplate: "GreengrassFleetProvisioningTemplate"
         claimCertificatePath: "C:\\greengrass\\v2\\claim-certs\\claim.pem.crt"
         claimCertificatePrivateKeyPath: "C:\\greengrass\\v2\\claim-certs\\claim.private.pem.key"
         rootCaPath: "C:\\greengrass\\v2\\AmazonRootCA1.pem"
         templateParameters:
           ThingName: "MyGreengrassCore"
           ThingGroupName: "MyGreengrassCoreGroup"

   anchoranchor
   • Linux or Unix
   • Windows

   ---
   services:
     aws.greengrass.Nucleus:
       version: "2.14.0"
     aws.greengrass.FleetProvisioningByClaim:
       configuration:
         rootPath: "/greengrass/v2"
         awsRegion: "us-west-2"
         iotDataEndpoint: "device-data-prefix-ats.iot.us-west-2.amazonaws.com"
         iotCredentialEndpoint: "device-credentials-prefix.credentials.iot.us-west-2.amazonaws.com"
         iotRoleAlias: "GreengrassCoreTokenExchangeRoleAlias"
         provisioningTemplate: "GreengrassFleetProvisioningTemplate"
         claimCertificatePath: "/greengrass/v2/claim-certs/claim.pem.crt"
         claimCertificatePrivateKeyPath: "/greengrass/v2/claim-certs/claim.private.pem.key"
         rootCaPath: "/greengrass/v2/AmazonRootCA1.pem"
         templateParameters:
           ThingName: "MyGreengrassCore"
           ThingGroupName: "MyGreengrassCoreGroup"

   然後，執行下列動作：

   • 將 2.14.0 取代為 AWS IoT Greengrass 核心軟體版本。

   • 將 /greengrass/v2或 C：\greengrass\v2 的每個執行個體取代為 Greengrass 根資料夾。

     注意

     在 Windows 裝置上，您必須將路徑分隔符號指定為雙反斜線 (\\)，例如 C:\\greengrass\\v2。

   • 將 us-west-2 取代為您建立佈建範本和其他資源 AWS 的區域。

   • 將 取代iotDataEndpoint為 AWS IoT 資料端點。

   • 將 取代iotCredentialEndpoint為您的 AWS IoT 登入資料端點。

   • 以字符交換角色別名的名稱取代 GreengrassCoreTokenExchangeRoleAlias。

   • 以機群佈建範本的名稱取代 GreengrassFleetProvisioningTemplate。

   • 將 取代claimCertificatePath為裝置上的宣告憑證路徑。

   • 將 取代claimCertificatePrivateKeyPath為裝置上的宣告憑證私有金鑰路徑。

   • 將範本參數 (templateParameters) 取代為用來佈建裝置的值。此範例是指定義 ThingName和 ThingGroupName 參數的範例範本。

   注意

   在此組態檔案中，您可以自訂其他組態選項，例如要使用的連接埠和網路代理，如下列範例所示。如需詳細資訊，請參閱 Greengrass 核組態。

   Linux or Unix

   ---
   services:
     aws.greengrass.Nucleus:
       version: "2.14.0"
       configuration:
         mqtt:
           port: 443
         greengrassDataPlanePort: 443
         networkProxy:
           noProxyAddresses: "http://192.168.0.1,www.example.com"
           proxy:
             url: "http://my-proxy-server:1100"
             username: "Mary_Major"
             password: "pass@word1357"
     aws.greengrass.FleetProvisioningByClaim:
       configuration:
         rootPath: "/greengrass/v2"
         awsRegion: "us-west-2"
         iotDataEndpoint: "device-data-prefix-ats.iot.us-west-2.amazonaws.com"
         iotCredentialEndpoint: "device-credentials-prefix.credentials.iot.us-west-2.amazonaws.com"
         iotRoleAlias: "GreengrassCoreTokenExchangeRoleAlias"
         provisioningTemplate: "GreengrassFleetProvisioningTemplate"
         claimCertificatePath: "/greengrass/v2/claim-certs/claim.pem.crt"
         claimCertificatePrivateKeyPath: "/greengrass/v2/claim-certs/claim.private.pem.key"
         rootCaPath: "/greengrass/v2/AmazonRootCA1.pem"
         templateParameters:
           ThingName: "MyGreengrassCore"
           ThingGroupName: "MyGreengrassCoreGroup"
         mqttPort: 443
         proxyUrl: "http://my-proxy-server:1100"
         proxyUserName: "Mary_Major"
         proxyPassword: "pass@word1357"

   Windows

   ---
   services:
     aws.greengrass.Nucleus:
       version: "2.14.0"
       configuration:
         mqtt:
           port: 443
         greengrassDataPlanePort: 443
         networkProxy:
           noProxyAddresses: "http://192.168.0.1,www.example.com"
           proxy:
             url: "http://my-proxy-server:1100"
             username: "Mary_Major"
             password: "pass@word1357"
     aws.greengrass.FleetProvisioningByClaim:
       configuration:
         rootPath: "C:\\greengrass\\v2"
         awsRegion: "us-west-2"
         iotDataEndpoint: "device-data-prefix-ats.iot.us-west-2.amazonaws.com"
         iotCredentialEndpoint: "device-credentials-prefix.credentials.iot.us-west-2.amazonaws.com"
         iotRoleAlias: "GreengrassCoreTokenExchangeRoleAlias"
         provisioningTemplate: "GreengrassFleetProvisioningTemplate"
         claimCertificatePath: "C:\\greengrass\\v2\\claim-certs\\claim.pem.crt"
         claimCertificatePrivateKeyPath: "C:\\greengrass\\v2\\claim-certs\\claim.private.pem.key"
         rootCaPath: "C:\\greengrass\\v2\\AmazonRootCA1.pem"
         templateParameters:
           ThingName: "MyGreengrassCore"
           ThingGroupName: "MyGreengrassCoreGroup"
         mqttPort: 443
         proxyUrl: "http://my-proxy-server:1100"
         proxyUserName: "Mary_Major"
         proxyPassword: "pass@word1357"

   anchoranchor

   • Linux or Unix
   • Windows

   ---
   services:
     aws.greengrass.Nucleus:
       version: "2.14.0"
       configuration:
         mqtt:
           port: 443
         greengrassDataPlanePort: 443
         networkProxy:
           noProxyAddresses: "http://192.168.0.1,www.example.com"
           proxy:
             url: "http://my-proxy-server:1100"
             username: "Mary_Major"
             password: "pass@word1357"
     aws.greengrass.FleetProvisioningByClaim:
       configuration:
         rootPath: "/greengrass/v2"
         awsRegion: "us-west-2"
         iotDataEndpoint: "device-data-prefix-ats.iot.us-west-2.amazonaws.com"
         iotCredentialEndpoint: "device-credentials-prefix.credentials.iot.us-west-2.amazonaws.com"
         iotRoleAlias: "GreengrassCoreTokenExchangeRoleAlias"
         provisioningTemplate: "GreengrassFleetProvisioningTemplate"
         claimCertificatePath: "/greengrass/v2/claim-certs/claim.pem.crt"
         claimCertificatePrivateKeyPath: "/greengrass/v2/claim-certs/claim.private.pem.key"
         rootCaPath: "/greengrass/v2/AmazonRootCA1.pem"
         templateParameters:
           ThingName: "MyGreengrassCore"
           ThingGroupName: "MyGreengrassCoreGroup"
         mqttPort: 443
         proxyUrl: "http://my-proxy-server:1100"
         proxyUserName: "Mary_Major"
         proxyPassword: "pass@word1357"

   若要使用 HTTPS 代理，您必須使用 1.1.0 版或更新版本的機群佈建外掛程式。您必須另外在 rootCaPath下指定 system，如下列範例所示。

   Linux or Unix

   ---
   system:
     rootCaPath: "/greengrass/v2/AmazonRootCA1.pem"
   services:
     ...

   Windows

   ---
   system:
     rootCaPath: "C:\\greengrass\\v2\\AmazonRootCA1.pem"
   services:
     ...

   anchoranchor

   • Linux or Unix
   • Windows

   ---
   system:
     rootCaPath: "/greengrass/v2/AmazonRootCA1.pem"
   services:
     ...

3. 執行安裝程式。指定 --trusted-plugin以提供機群佈建外掛程式，並指定 --init-config 提供組態檔案。

   • /greengrass/v2 將 取代為 Greengrass 根資料夾。

   • 將 GreengrassInstaller 的每個執行個體取代為您解壓縮安裝程式的資料夾。

   Linux or Unix

   sudo -E java -Droot="/greengrass/v2" -Dlog.store=FILE \
     -jar ./GreengrassInstaller/lib/Greengrass.jar \
     --trusted-plugin ./GreengrassInstaller/aws.greengrass.FleetProvisioningByClaim.jar \
     --init-config ./GreengrassInstaller/config.yaml \
     --component-default-user ggc_user:ggc_group \
     --setup-system-service true

   Windows Command Prompt (CMD)

   java -Droot="C:\greengrass\v2" "-Dlog.store=FILE" ^
     -jar ./GreengrassInstaller/lib/Greengrass.jar ^
     --trusted-plugin ./GreengrassInstaller/aws.greengrass.FleetProvisioningByClaim.jar ^
     --init-config ./GreengrassInstaller/config.yaml ^
     --component-default-user ggc_user ^
     --setup-system-service true

   PowerShell

   java -Droot="C:\greengrass\v2" "-Dlog.store=FILE" `
     -jar ./GreengrassInstaller/lib/Greengrass.jar `
     --trusted-plugin ./GreengrassInstaller/aws.greengrass.FleetProvisioningByClaim.jar `
     --init-config ./GreengrassInstaller/config.yaml `
     --component-default-user ggc_user `
     --setup-system-service true

   anchoranchoranchor
   • Linux or Unix
   • Windows Command Prompt (CMD)
   • PowerShell

   sudo -E java -Droot="/greengrass/v2" -Dlog.store=FILE \
     -jar ./GreengrassInstaller/lib/Greengrass.jar \
     --trusted-plugin ./GreengrassInstaller/aws.greengrass.FleetProvisioningByClaim.jar \
     --init-config ./GreengrassInstaller/config.yaml \
     --component-default-user ggc_user:ggc_group \
     --setup-system-service true

   重要

   在 Windows 核心裝置上，您必須指定 將 AWS IoT Greengrass 核心軟體--setup-system-service true設定為系統服務。

   如果您指定 --setup-system-service true，Successfully set up Nucleus as a system service安裝程式會在設定和執行軟體時列印為系統服務。否則，如果安裝程式成功安裝軟體，就不會輸出任何訊息。

   注意

   當您在沒有 deploy-dev-tools 引數的情況下執行安裝程式時，無法使用 --provision true引數來部署本機開發工具。如需直接在您的裝置上部署 Greengrass CLI 的詳細資訊，請參閱Greengrass 命令列界面。

4. 檢視根資料夾中的檔案來驗證安裝。

   Linux or Unix

   ls /greengrass/v2

   Windows Command Prompt (CMD)

   dir C:\greengrass\v2

   PowerShell

   ls C:\greengrass\v2

   anchoranchoranchor
   • Linux or Unix
   • Windows Command Prompt (CMD)
   • PowerShell

   ls /greengrass/v2

   如果安裝成功，根資料夾包含數個資料夾，例如 config、 packages和 logs。