Greengrass CLI のインストール

フォーカスモード

Greengrass CLI のインストール - AWS IoT Greengrass

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

デバイスで AWS IoT Greengrass Core ソフトウェアを初めてセットアップするときは、 --deploy-dev-tools引数を使用します。また、この引数を適用するには --provision true も指定する必要があります。
デバイスに Greengrass CLI コンポーネント (aws.greengrass.Cli) をデプロイします。

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

前提条件

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

AWS IoT Greengrass コアデバイスにインストールおよび設定されたコアソフトウェア。詳細については、「チュートリアル: の開始方法 AWS IoT Greengrass V2」を参照してください。
を使用して Greengrass CLI を AWS 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 コンポーネントをデプロイします。

AWS IoT Greengrass コンソールにサインインします。
ナビゲーションメニューで、[Components] (コンポーネント) を選択します。
[Components] (コンポーネント) ページの [Public components] (公開コンポーネント) タブで、[aws.greengrass.Cli] を選択します。
[aws.greengrass.Cli] ページで、[Deploy] (デプロイ) を選択します。
[Add to deployment] (デプロイに追加) から [Create new deployment] (デプロイを新規作成) を選択します。
[Specify target] (ターゲットを指定) ページの [Deployment targets] (デプロイターゲット) の [Target Name] (ターゲット名) リストで、デプロイ先にする Greengrass グループを選択し、[Next] (次へ) を選択します。
[Select components] (コンポーネントを選択) ページで、aws.greengrass.Cli コンポーネントが選択されていることを確認して、[Next] (次へ) を選択します。
[Configure components] (コンポーネント設定) ページで、デフォルト設定のままにして、[Next] (次へ) を選択します。
[Configure advanced setting] (高度な設定を設定) ページで、デフォルト構成設定のままにして [Next] (次) を選択します。
[Review] (確認) ページで [Deploy] (デプロイ) をクリックします。

Greengrass CLI コンポーネントをデプロイするには (コンソール)

AWS IoT Greengrass コンソールにサインインします。
ナビゲーションメニューで、[Components] (コンポーネント) を選択します。
[Components] (コンポーネント) ページの [Public components] (公開コンポーネント) タブで、[aws.greengrass.Cli] を選択します。
[aws.greengrass.Cli] ページで、[Deploy] (デプロイ) を選択します。
[Add to deployment] (デプロイに追加) から [Create new deployment] (デプロイを新規作成) を選択します。
[Specify target] (ターゲットを指定) ページの [Deployment targets] (デプロイターゲット) の [Target Name] (ターゲット名) リストで、デプロイ先にする Greengrass グループを選択し、[Next] (次へ) を選択します。
[Select components] (コンポーネントを選択) ページで、aws.greengrass.Cli コンポーネントが選択されていることを確認して、[Next] (次へ) を選択します。
[Configure components] (コンポーネント設定) ページで、デフォルト設定のままにして、[Next] (次へ) を選択します。
[Configure advanced setting] (高度な設定を設定) ページで、デフォルト構成設定のままにして [Next] (次) を選択します。
[Review] (確認) ページで [Deploy] (デプロイ) をクリックします。

デバイスで deployment.json ファイルを作成して、Greengrass CLI コンポーネントのデプロイ設定を定義します。このファイルは次のようになります:
```
{
  "targetArn":"targetArn",
  "components": {
    "aws.greengrass.Cli": {
      "componentVersion": "2.14.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 CLI を使用して AWS IoT Greengrass Core ソフトウェアとやり取りすることを許可します。グループ名またはグループ ID を指定できます。例:group1,1002,group3 は 3 つのシステムグループ (group1、1002 および group3) に Greengrass CLI の使用を認可します。
  
  承認するグループを指定しない場合は、Greengrass CLI をルートユーザー (sudo) または AWS IoT Greengrass Core ソフトウェアを実行するシステムユーザーとして使用できます。
  
  configurationUpdate.AuthorizedWindowsGroups
  
  (オプション) システムグループのカンマ区切りリストを含む文字列。これらのシステムグループが Greengrass CLI を使用して AWS IoT Greengrass Core ソフトウェアとやり取りすることを許可します。グループ名またはグループ ID を指定できます。例:group1,1002,group3 は 3 つのシステムグループ (group1、1002 および group3) に Greengrass CLI の使用を認可します。
  
  承認するグループを指定しない場合は、Greengrass CLI を管理者または AWS IoT Greengrass Core ソフトウェアを実行するシステムユーザーとして使用できます。
次のコマンドを実行して、デバイスに Greengrass CLI コンポーネントをデプロイします。
```
$ aws greengrassv2 create-deployment --cli-input-json file://path/to/deployment.json
```

Greengrass CLI コンポーネントをデプロイするには (AWS CLI)

デバイスで deployment.json ファイルを作成して、Greengrass CLI コンポーネントのデプロイ設定を定義します。このファイルは次のようになります:
```
{
  "targetArn":"targetArn",
  "components": {
    "aws.greengrass.Cli": {
      "componentVersion": "2.14.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 CLI を使用して AWS IoT Greengrass Core ソフトウェアとやり取りすることを許可します。グループ名またはグループ ID を指定できます。例:group1,1002,group3 は 3 つのシステムグループ (group1、1002 および group3) に Greengrass CLI の使用を認可します。
  
  承認するグループを指定しない場合は、Greengrass CLI をルートユーザー (sudo) または AWS IoT Greengrass Core ソフトウェアを実行するシステムユーザーとして使用できます。
  
  configurationUpdate.AuthorizedWindowsGroups
  
  (オプション) システムグループのカンマ区切りリストを含む文字列。これらのシステムグループが Greengrass CLI を使用して AWS IoT Greengrass Core ソフトウェアとやり取りすることを許可します。グループ名またはグループ ID を指定できます。例:group1,1002,group3 は 3 つのシステムグループ (group1、1002 および group3) に Greengrass CLI の使用を認可します。
  
  承認するグループを指定しない場合は、Greengrass CLI を管理者または AWS IoT Greengrass Core ソフトウェアを実行するシステムユーザーとして使用できます。
次のコマンドを実行して、デバイスに Greengrass CLI コンポーネントをデプロイします。
```
$ aws greengrassv2 create-deployment --cli-input-json file://path/to/deployment.json
```

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

anchor anchor


/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」を参照してください。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

Greengrass コマンドラインインターフェイス

Greengrass CLI コマンド

このページの内容

Cookie の設定を選択する

Cookie の設定をカスタマイズする

Essential

Performance

Functional

Advertising

Cookie の設定を保存できません

Greengrass CLI のインストール

前提条件

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

Greengrass CLI コンポーネントをデプロイするには (コンソール)

Greengrass CLI コンポーネントをデプロイするには (AWS CLI)

このページの内容

このページは役に立ちましたか?

次のトピック

前のトピック:

ヘルプが必要ですか?