安裝程式引數 - AWS IoT Greengrass

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

安裝程式引數

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

-h, --help

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

--version

(選用) 顯示 AWS IoT Greengrass 核心軟體版本。

-Droot

(選用) 要用作 AWS IoT Greengrass Core 軟體根資料夾的路徑。

注意

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

預設:

  • Linux:~/.greengrass

  • Windows:%USERPROFILE%/.greengrass

-ar, --aws-region

Core AWS IoT Greengrass 軟體用來擷取或建立其必要 AWS 資源 AWS 區域 的 。

-p, --provision

(選用) 您可以將此裝置註冊為 AWS IoT 物件, AWS 並佈建核心裝置所需的資源。如果您指定 true, AWS IoT Greengrass Core 軟體會佈建 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

此功能適用於 Greengrass 核元件的 v2.4.0 和更新版本。

(選用) 要連接到此核心裝置 AWS IoT 物件憑證 AWS IoT 的政策名稱。如果您的 中不存在具有此名稱 AWS IoT 的政策 AWS 帳戶,則 AWS IoT Greengrass Core 軟體會建立該政策。

AWS IoT Greengrass 核心軟體預設會建立寬鬆 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 作業系統上,此引數要求 系統化初始化系統可在裝置上使用。

重要

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

預設:false

-u, --component-default-user

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

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

下列其他考量事項適用於 Linux 作業系統:

  • 如果您以根身分執行,預設元件使用者即為組態檔案中定義的使用者。如果組態檔案未定義使用者,則預設為 ggc_user:ggc_group。如果 ggc_userggc_group 不存在,軟體會建立它們。

  • 如果您以非根使用者身分執行 ,則 AWS IoT Greengrass Core 軟體會使用該使用者來執行元件。

  • 如果您未指定群組, AWS IoT Greengrass 則 Core 軟體會使用系統使用者的主要群組。

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

-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 核心軟體安裝後啟動,並選擇性地佈建資源。

預設:true