Instal Greengrass CLI - AWS IoT Greengrass
PrasyaratDeploy komponen Greengrass CLI

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Instal Greengrass CLI

Anda dapat menginstal Greengrass CLI dengan salah satu cara berikut:

  • Gunakan --deploy-dev-tools argumen saat pertama kali menyiapkan perangkat lunak AWS IoT Greengrass Core di perangkat Anda. Anda juga harus menentukan --provision true untuk menerapkan argumen ini.

  • Deploy komponen Greengrass CLI (aws.greengrass.Cli) di perangkat Anda.

Bagian ini menjelaskan langkah-langkah untuk men-deploy komponen Greengrass CLI. Untuk informasi tentang menginstal Greengrass CLI selama pengaturan awal, lihat Tutorial: Memulai dengan AWS IoT Greengrass V2.

Prasyarat

Untuk menerapkan komponen CLI Greengrass, Anda harus memenuhi persyaratan berikut:

  • AWS IoT Greengrass Perangkat lunak inti diinstal dan dikonfigurasi pada perangkat inti Anda. Untuk informasi selengkapnya, lihat Tutorial: Memulai dengan AWS IoT Greengrass V2.

  • Untuk menggunakan AWS CLI untuk menyebarkan CLI Greengrass, Anda harus telah menginstal dan mengkonfigurasi. AWS CLI Untuk informasi lebih lanjut, lihat Mengonfigurasi AWS CLI di Panduan Pengguna AWS Command Line Interface .

  • Anda harus diberi wewenang untuk menggunakan CLI Greengrass untuk berinteraksi dengan perangkat lunak Core. AWS IoT Greengrass Lakukan salah satu langkah berikut untuk menggunakan Greengrass CLI:

    • Gunakan pengguna sistem yang menjalankan perangkat lunak AWS IoT Greengrass Core.

    • Gunakan pengguna dengan izin root atau adminstratif. Pada perangkat inti Linux, Anda dapat menggunakan sudo untuk mendapatkan izin root.

    • Gunakan pengguna sistem yang berada dalam grup yang Anda tentukan dalam parameter AuthorizedPosixGroups atau AuthorizedWindowsGroups konfigurasi saat Anda menerapkan komponen. Untuk informasi selengkapnya, lihat konfigurasi komponen CLI Greengrass.

Deploy komponen Greengrass CLI

Selesaikan langkah-langkah berikut untuk men-deploy komponen Greengrass CLI ke perangkat inti Anda:

  1. Masuk ke konsol AWS IoT Greengrass.

  2. Dalam menu navigasi, pilih Komponen.

  3. Pada halaman Komponen, pada tab Komponen publik, pilih aws.greengrass.Cli.

  4. Pada halaman aws.greengrass.Cli pilih Deploy.

  5. Dari Tambahkan ke deployment, pilih Buat deployment baru.

  6. Pada halaman Tentukan target, di bawah Target deployment, di daftar Nama target, pilih grup Greengrass yang ingin Anda deploy, dan pilih Selanjutnya.

  7. Pada halaman Pilih komponen, verifikasi bahwa komponen aws.greengrass.Cli tersebut dipilih, dan pilih Selanjutnya.

  8. Pada halaman Konfigurasikan komponen, simpan pengaturan konfigurasi default, dan pilih Selanjutnya.

  9. Pada halaman Konfigurasikan pengaturan lanjutan, simpan pengaturan konfigurasi default tersebut, dan pilih Selanjutnya.

  10. Di halaman Tinjauan, klik Deploy.

  1. Di perangkat Anda, buatlah file deployment.json untuk menentukan konfigurasi deployment untuk komponen Greengrass CLI. File ini akan terlihat seperti berikut:

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

    • Di kolom target, ganti targetArn dengan Amazon Resource Name (ARN) dari grup objek atau objek yang ditargetkan untuk deployment tersebut, dalam format berikut:

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

      • Grup objek: arn:aws:iot:region:account-id:thinggroup/thingGroupName

    • Di objek komponen aws.greengrass.Cli, tentukan nilai-nilai sebagai berikut:

      version

      Versi komponen Greengrass CLI.

      configurationUpdate.AuthorizedPosixGroups

      (Opsional) String yang berisi daftar kelompok sistem yang dipisahkan dengan koma. Anda mengizinkan grup sistem ini untuk menggunakan CLI Greengrass untuk berinteraksi dengan perangkat lunak Inti. AWS IoT Greengrass Anda dapat menentukan nama grup atau ID grup. Misalnya, group1,1002,group3 mengotorisasi tiga grup sistem (group1, 1002, dan group3) untuk menggunakan Greengrass CLI.

      Jika Anda tidak menentukan grup apa pun untuk diotorisasi, Anda dapat menggunakan Greengrass CLI sebagai sudo pengguna root () atau sebagai pengguna sistem yang menjalankan perangkat lunak Core. AWS IoT Greengrass

      configurationUpdate.AuthorizedWindowsGroups

      (Opsional) String yang berisi daftar kelompok sistem yang dipisahkan dengan koma. Anda mengizinkan grup sistem ini untuk menggunakan CLI Greengrass untuk berinteraksi dengan perangkat lunak Inti. AWS IoT Greengrass Anda dapat menentukan nama grup atau ID grup. Misalnya, group1,1002,group3 mengotorisasi tiga grup sistem (group1, 1002, dan group3) untuk menggunakan Greengrass CLI.

      Jika Anda tidak menentukan grup apa pun untuk diotorisasi, Anda dapat menggunakan CLI Greengrass sebagai administrator atau sebagai pengguna sistem yang menjalankan perangkat lunak Core. AWS IoT Greengrass

  2. Jalankan perintah berikut untuk men-deploy komponen Greengrass CLI pada perangkat:

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

Selama instalasi, komponen menambahkan link simbolik ke greengrass-cli dalam folder /greengrass/v2/bin pada perangkat Anda, dan Anda menjalankan Greengrass CLI dari jalur ini. Untuk menjalankan Greengrass CLI tanpa path absolut, tambahkan folder /greengrass/v2/bin Anda ke variabel PATH Anda. Untuk memverifikasi instalasi Greengrass CLI, jalankan perintah berikut:

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

Anda akan melihat output berikut:

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.

Jika greengrass-cli tidak ditemukan, deployment mungkin gagal untuk menginstal Greengrass CLI. Untuk informasi selengkapnya, lihat Pemecahan masalah AWS IoT Greengrass V2.