Greengrass をインストールする CLI - AWS IoT Greengrass
前提条件Greengrass CLIコンポーネントのデプロイ

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Greengrass をインストールする CLI

Greengrass は、次のいずれかCLIの方法でインストールできます。

  • デバイスで AWS IoT Greengrass Core ソフトウェアを初めてセットアップするときは、 --deploy-dev-tools引数を使用します。また、この引数を適用するには --provision true も指定する必要があります。

  • Greengrass CLIコンポーネント (aws.greengrass.Cli) をデバイスにデプロイします。

このセクションでは、Greengrass CLIコンポーネントをデプロイする手順について説明します。初期設定CLI時に Greengrass をインストールする方法については、「」を参照してくださいチュートリアル: AWS IoT Greengrass V2 の開始方法。

前提条件

Greengrass CLIコンポーネントをデプロイするには、次の要件を満たす必要があります。

  • AWS IoT Greengrass コアデバイスにインストールおよび設定されているコアソフトウェア。詳細については、「チュートリアル: AWS IoT Greengrass V2 の開始方法」を参照してください。

  • を使用して Greengrass を AWS CLI デプロイするにはCLI、 をインストールして設定しておく必要があります AWS CLI。詳細については、「AWS CLIユーザーガイド」の「AWS Command Line Interface の設定。」を参照してください。

  • AWS IoT Greengrass Core ソフトウェアを操作するには、Greengrass CLI を使用する権限が必要です。Greengrass を使用するには、次のいずれかを実行しますCLI。

    • AWS IoT Greengrass Core ソフトウェアを実行するシステムユーザーを使用します。

    • root 権限または管理者権限を持つユーザーを使用する。Linux コアデバイスでは、sudo を使用して root 権限を取得できます。

    • 設定をデプロイする際に、AuthorizedPosixGroups または AuthorizedWindowsGroups 設定パラメータで指定したグループのシステムユーザーを使用する。詳細については、「Greengrass CLIコンポーネント設定」を参照してください。

Greengrass CLIコンポーネントのデプロイ

Greengrass CLIコンポーネントをコアデバイスにデプロイするには、次のステップを実行します。

  1. AWS IoT Greengrass コンソール にサインインします。

  2. ナビゲーションメニューで、[Components] (コンポーネント) を選択します。

  3. [Components] (コンポーネント) ページの [Public components] (公開コンポーネント) タブで、[aws.greengrass.Cli] を選択します。

  4. [aws.greengrass.Cli] ページで、[Deploy] (デプロイ) を選択します。

  5. [Add to deployment] (デプロイに追加) から [Create new deployment] (デプロイを新規作成) を選択します。

  6. [Specify target] (ターゲットを指定) ページの [Deployment targets] (デプロイターゲット) の [Target Name] (ターゲット名) リストで、デプロイ先にする Greengrass グループを選択し、[Next] (次へ) を選択します。

  7. [Select components] (コンポーネントを選択) ページで、aws.greengrass.Cli コンポーネントが選択されていることを確認して、[Next] (次へ) を選択します。

  8. [Configure components] (コンポーネント設定) ページで、デフォルト設定のままにして、[Next] (次へ) を選択します。

  9. [Configure advanced setting] (高度な設定を設定) ページで、デフォルト構成設定のままにして [Next] (次) を選択します。

  10. [Review] (確認) ページで [Deploy] (デプロイ) をクリックします。

  1. デバイスで、deployment.jsonファイルを作成して Greengrass CLIコンポーネントのデプロイ設定を定義します。このファイルは次のようになります:

    {
  "targetArn":"targetArn",
  "components": {
    "aws.greengrass.Cli": {
      "componentVersion": "2.13.0",
      "configurationUpdate": {
        "merge": "{\"AuthorizedPosixGroups\":\"<group1>,<group2>,...,<groupN>\",\"AuthorizedWindowsGroups\":\"<group1>,<group2>,...,<groupN>\"}"
      }
    }
  }
}

    • target フィールドで、 targetArnをデプロイの対象となるモノまたはモノグループの Amazon リソースネーム (ARN) に置き換えます。形式は次のとおりです。

      • モノ: arn:aws:iot:region:account-id:thing/thingName

      • モノのグループ: arn:aws:iot:region:account-id:thinggroup/thingGroupName

    • aws.greengrass.Cli コンポーネントオブジェクトで、以下のように値を指定します。

      version

      Greengrass CLIコンポーネントのバージョン。

      configurationUpdate.AuthorizedPosixGroups

      (オプション) システムグループのカンマ区切りリストを含む文字列。これらのシステムグループが Greengrass を使用して AWS IoT Greengrass Core ソフトウェアとやり取りCLIすることを許可します。グループ名またはグループ を指定できますIDs。例えば、 は 3 つのシステムグループ (group1、1002、および group3) に Greengrass の使用group1,1002,group3を許可しますCLI。

      承認するグループを指定しない場合は、CLIルートユーザー (sudo) または AWS IoT Greengrass Core ソフトウェアを実行するシステムユーザーとして Greengrass を使用できます。

      configurationUpdate.AuthorizedWindowsGroups

      (オプション) システムグループのカンマ区切りリストを含む文字列。これらのシステムグループが Greengrass を使用して AWS IoT Greengrass Core ソフトウェアとやり取りCLIすることを許可します。グループ名またはグループ を指定できますIDs。例えば、 は 3 つのシステムグループ (group1、1002、および group3) に Greengrass の使用group1,1002,group3を許可しますCLI。

      承認するグループを指定しない場合は、Greengrass をCLI管理者または AWS IoT Greengrass Core ソフトウェアを実行するシステムユーザーとして使用できます。

  2. 次のコマンドを実行して、デバイスに Greengrass CLIコンポーネントをデプロイします。

    $ aws greengrassv2 create-deployment --cli-input-json file://path/to/deployment.json

インストール中、コンポーネントはデバイスの /greengrass/v2/binフォルダgreengrass-cliにシンボリックリンクを に追加し、このパスCLIから Greengrass を実行します。Greengrass を絶対パスCLIなしで実行するには、 /greengrass/v2/binフォルダを PATH 変数に追加します。Greengrass CLIのインストールを確認するには、次のコマンドを実行します。

Linux or Unix
/greengrass/v2/bin/greengrass-cli help
Windows
C:\greengrass\v2\bin\greengrass-cli help

以下の出力が表示されます。

Usage: greengrass-cli [-hV] [--ggcRootPath=<ggcRootPath>] [COMMAND]
Greengrass command line interface

      --ggcRootPath=<ggcRootPath>
                  The AWS IoT Greengrass V2 root directory.
  -h, --help      Show this help message and exit.
  -V, --version   Print version information and exit.
Commands:
  help                Show help information for a command.
  component           Retrieve component information and stop or restart
                        components.
  deployment          Create local deployments and retrieve deployment status.
  logs                Analyze Greengrass logs.
  get-debug-password  Generate a password for use with the HTTP debug view
                        component.

greengrass-cli が見つからない場合、デプロイは Greengrass のインストールに失敗した可能性がありますCLI。詳細については、「トラブルシューティング AWS IoT Greengrass V2」を参照してください。