安裝器引數 - AWS IoT Greengrass

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

安裝器引數

AWS IoT Greengrass核心軟體包含一個安裝程式，可設定軟體並佈建 Greengrass 核心裝置執行所需的AWS資源。安裝程式包含下列引數，您可以指定用來設定安裝：

-h, --help

(選擇性) 顯示安裝程式的說明資訊。

--version

(選擇性) 顯示AWS IoT Greengrass核心軟體的版本。

-Droot

(選擇性) 用作AWS IoT Greengrass核心軟體根目錄的資料夾路徑。

注意

此引數-jar會設定 JVM 屬性，因此您必須在執行安裝程式之前指定它。例如，指定 java -Droot="/greengrass/v2" -jar /path/to/Greengrass.jar。

預設：

  • Linux：~/.greengrass

  • Windows：%USERPROFILE%/.greengrass

-ar, --aws-region

AWS 區域該AWS IoT Greengrass核心軟件用來檢索或創建其所需的AWS資源。

-p, --provision

(選擇性) 您可以將此裝置註冊為AWS IoT物件，並佈建核心裝置所需的AWS資源。如果您指定true，AWS IoT Greengrass核心軟體會佈建AWS IoT物件、(選用) AWS IoT 物件群組、IAM 角色和AWS IoT角色別名。

預設：false

-tn, --thing-name

(選擇性) 您註冊為此核心裝置的AWS IoT物件名稱。如果名稱的東西不存在於您的內容AWS 帳戶，則 AWS IoT Greengrass Core 軟件將創建它。

注意

物件名稱不能包含冒號 (:) 字元。

您必須指--provision true定套用此引數。

預設值：GreengrassV2IotThing_加上一個隨機的 UUID。

-tgn, --thing-group-name

(選擇性) 您新增此核心裝置AWS IoT物件的AWS IoT物件群組名稱。如果部署以此物件群組為目標，則此核心裝置會在連線至時接收該部署AWS IoT Greengrass。如果具有此名稱的物件群組不存在於您的中AWS 帳戶，則 AWS IoT Greengrass Core 軟體會建立該物件群組。

注意

物件群組名稱不能包含冒號 (:) 字元。

您必須指--provision true定套用此引數。

-tpn, --thing-policy-name

此功能適用於 v2.4.0 和更高版 Greeng rass 核組件。

(選擇性) 要附加至此核心裝置AWS IoT物件憑證的AWS IoT原則名稱。如果您的中不存在具有此名稱的AWS IoT原則AWS 帳戶，則 AWS IoT Greengrass Core 軟體會建立它。

根據預設，AWS IoT GreengrassCore 軟體會建立寬容AWS IoT原則。您可以縮小此原則的範圍，或建立自訂原則，以限制使用案例的權限。如需詳細資訊，請參閱 AWS IoT Greengrass V2核心裝置的最低AWS IoT原則。

您必須指--provision true定套用此引數。

預設：GreengrassV2IoTThingPolicy

-trn, --tes-role-name

(選用) 要用來取得AWS認證的 IAM 角色名稱，讓核心裝置與AWS服務互動。如果您的中不存在具有此名稱的角色AWS 帳戶，則 AWS IoT Greengrass Core 軟體會使用GreengrassV2TokenExchangeRoleAccess原則建立該角色。此角色無法存取託管元件成品的 S3 儲存貯體。因此，您必須在建立元件時，將權限新增至人工因素的 S3 儲存貯體和物件。如需詳細資訊，請參閱 授權核心裝置與 AWS 服務互動。

您必須指--provision true定套用此引數。

預設：GreengrassV2TokenExchangeRole

-tra, --tes-role-alias-name

(選擇性) 指向為此核心裝置提供AWS登入資料的 IAM 角色的角色別名名稱。AWS IoT如果您的中不存在具有此名稱的角色別名AWS 帳戶，則 AWS IoT Greengrass Core 軟體會建立該別名，並將其指向您指定的 IAM 角色。

您必須指--provision true定套用此引數。

預設：GreengrassV2TokenExchangeRoleAlias

-ss, --setup-system-service

(選擇性) 您可以將 AWS IoT Greengrass Core 軟體設定為在此裝置開機時執行的系統服務。系統服務名稱為greengrass。如需詳細資訊，請參閱 將 Greengrass 核配置為系統服務。

在 Linux 作業系統上，此引數要求您必須在裝置上使用 systemd 初始化系統。

重要

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

預設：false

-u, --component-default-user

AWS IoT GreengrassCore 軟體用來執行元件的使用者名稱或識別碼。例如，您可以指定 ggc_user。當您在 Windows 作業系統上執行安裝程式時，需要此值。

在 Linux 作業系統上，您也可以選擇性地指定群組。指定以冒號分隔的使用者和群組。例如 ggc_user:ggc_group。

下列其他考量適用於 Linux 作業系統：

  • 如果您以 root 身份執行，預設元件使用者就是組態檔案中定義的使用者。如果配置文件沒有定義用戶，則默認為ggc_user:ggc_group。如果ggc_user或ggc_group不存在，軟件將創建它們。

  • 如果您以非 root 使用者身分執行，AWS IoT GreengrassCore 軟體會使用該使用者來執行元件。

  • 如果您未指定群組，AWS IoT GreengrassCore 軟體會使用系統使用者的主要群組。

如需詳細資訊，請參閱 設定執行元件的使用者。

-d, --deploy-dev-tools

(選擇性) 您可以下載 Greengrass CLI 元件並將其部署到這個核心裝置。您可以使用此工具來開發和偵錯此核心裝置上的元件。

重要

我們建議您僅在開發環境中使用此元件，而不是在生產環境中使用。此元件可讓您存取通常在生產環境中不需要的資訊和作業。只將此元件部署到您需要的核心裝置，以遵循最低權限原則。

您必須指--provision true定套用此引數。

預設：false

-init, --init-config

(選擇性) 用來安裝 AWS IoT Greengrass Core 軟體的組態檔案路徑。例如，您可以使用此選項來設定具有特定核心組態的新核心裝置。

重要

您指定的組態檔案會與核心裝置上的現有組態檔案合併。這包括核心裝置上的元件和元件組態。我們建議組態檔案僅列出您嘗試變更的組態。

-tp, --trusted-plugin

(選擇性) 要載入為受信任外掛程式之 JAR 檔案的路徑。使用此選項可提供佈建外掛程式 JAR 檔案，例如透過叢集佈建或自訂佈建進行安裝，或使用私密金鑰和憑證安裝在硬體安全性模組中。

-s, --start

(選擇性) 您可以在安裝 AWS IoT Greengrass Core 軟體後啟動該軟體，並選擇性地佈建資源。

預設：true