Instal Greengrass CLI - AWS IoT Greengrass
PrasyaratTerapkan 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 CLI Greengrass 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.

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

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

Prasyarat

Untuk menggunakan 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 menginstal dan mengonfigurasi file. 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 hal berikut untuk menggunakan GreengrassCLI:

    • 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 Greengrass CLI.

Terapkan komponen Greengrass CLI

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

  1. Masuk ke konsol AWS IoT Greengrass tersebut.

  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, buat deployment.json file untuk menentukan konfigurasi penerapan komponen GreengrassCLI. File ini akan terlihat seperti berikut:

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

    • Di target bidang, ganti targetArn dengan Amazon Resource Name (ARN) dari grup benda atau benda yang akan ditargetkan untuk penerapan, 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 GreengrassCLI.

      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 Core. AWS IoT Greengrass Anda dapat menentukan nama grup atau grupIDs. Misalnya, group1,1002,group3 mengotorisasi tiga kelompok sistem (group1,1002, dangroup3) untuk menggunakan CLI Greengrass.

      Jika Anda tidak menentukan grup apa pun untuk diotorisasi, Anda dapat menggunakan CLI Greengrass sebagai pengguna root sudo () 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 Core. AWS IoT Greengrass Anda dapat menentukan nama grup atau grupIDs. Misalnya, group1,1002,group3 mengotorisasi tiga kelompok sistem (group1,1002, dangroup3) untuk menggunakan CLI Greengrass.

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

  2. Jalankan perintah berikut untuk menyebarkan komponen CLI Greengrass pada perangkat:

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

Selama instalasi, komponen menambahkan tautan simbolis ke greengrass-cli dalam /greengrass/v2/bin folder di perangkat Anda, dan Anda menjalankan Greengrass dari jalur ini. CLI Untuk menjalankan CLI Greengrass tanpa jalur absolutnya, tambahkan /greengrass/v2/bin folder Anda ke variabel Anda. PATH Untuk memverifikasi instalasi CLI Greengrass, 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, penerapan mungkin gagal menginstal CLI Greengrass. Untuk informasi selengkapnya, lihat Pemecahan masalah AWS IoT Greengrass V2.