Greengrass CLI - AWS IoT Greengrass
VersiTipeSistem operasiPersyaratanDependensiKonfigurasiBerkas log lokalChangelog

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

Greengrass CLI

Komponen Greengrass CLI (aws.greengrass.Cli) menyediakan antarmuka baris perintah lokal yang dapat Anda gunakan pada perangkat inti untuk mengembangkan dan debug komponen secara lokal. Greengrass CLI memungkinkan Anda untuk membuat deployment lokal dan me-restart komponen pada perangkat inti, misalnya.

Anda dapat menginstal komponen ini ketika Anda menginstal perangkat lunak AWS IoT Greengrass Core. Untuk informasi selengkapnya, lihat Tutorial: Memulai dengan AWS IoT Greengrass V2.

penting

Kami menyarankan Anda menggunakan komponen ini hanya di lingkungan pengembangan, bukan lingkungan produksi. Komponen ini menyediakan akses ke informasi dan operasi yang biasanya tidak Anda perlukan di lingkungan produksi. Ikuti prinsip hak istimewa paling sedikit dengan menerapkan komponen ini hanya ke perangkat inti di mana Anda membutuhkannya.

Setelah Anda menginstal komponen ini, jalankan perintah berikut untuk melihat dokumentasi bantuan. Ketika komponen ini diinstal, komponen tersebut menambahkan tautan simbolik ke greengrass-cli dalam folder /greengrass/v2/bin. Anda dapat menjalankan Greengrass CLI dari jalur ini atau menambahkannya ke variabel lingkungan PATH Anda untuk menjalankan greengrass-cli tanpa jalur absolutnya.

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

Perintah berikut me-restart komponen bernama com.example.HelloWorld, misalnya.

Linux or Unix
sudo /greengrass/v2/bin/greengrass-cli component restart --names "com.example.HelloWorld"
Windows
C:\greengrass\v2\bin\greengrass-cli component restart --names "com.example.HelloWorld"

Untuk informasi selengkapnya, lihat Antarmuka Baris Perintah Greengrass.

Versi

Komponen ini memiliki versi berikut:

  • 2.12.x

  • 2.11.x

  • 2.10.x

  • 2.9.x

  • 2.8.x

  • 2.7.x

  • 2.6.x

  • 2.5.x

  • 2.4.x

  • 2.3.x

  • 2.2.x

  • 2.1.x

  • 2.0.x

Tipe

Komponen ini adalah komponen plugin (aws.greengrass.plugin). Inti Greengrass menjalankan komponen plugin dalam Java Virtual Machine (JVM) yang sama sebagai inti. Nukleus dimulai ulang saat Anda mengubah versi komponen ini di perangkat inti.

Komponen plugin menggunakan file log yang sama seperti inti Greengrass. Untuk informasi selengkapnya, lihat Memantau AWS IoT Greengrass log.

Untuk informasi selengkapnya, lihat Jenis komponen.

Sistem operasi

Komponen ini dapat diinstal pada perangkat inti yang menjalankan sistem operasi berikut:

  • Linux

  • Windows

Persyaratan

Komponen ini memiliki persyaratan sebagai berikut:

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

  • Komponen CLI Greengrass didukung untuk berjalan di VPC.

Dependensi

Saat Anda menerapkan komponen, gunakan AWS IoT Greengrass juga versi dependensinya yang kompatibel. Ini berarti bahwa Anda harus memenuhi persyaratan untuk komponen dan semua dependensinya untuk berhasil men-deploy komponen. Bagian ini berisi daftar dependensi untuk versi yang dirilis dari komponen ini dan kendala versi semantik yang menentukan versi komponen untuk setiap dependensi. Anda juga dapat melihat dependensi untuk setiap versi komponen di konsol AWS IoT Greengrass tersebut. Pada halaman detail komponen, cari daftar Dependensi.

2.12.0 – 2.12.6

Tabel berikut mencantumkan dependensi untuk versi 2.12.0 hingga 2.12.6 dari komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.12.0 <2.13.0 Lunak
2.11.0 – 2.11.3

Tabel berikut mencantumkan dependensi untuk versi 2.11.0 hingga 2.11.3 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.11.0 <2.12.0 Lunak
2.10.0 – 2.10.3

Tabel berikut mencantumkan dependensi untuk versi 2.10.0 hingga 2.10.3 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.5.0 <2.11.0 Lunak
2.9.0 – 2.9.6

Tabel berikut mencantumkan dependensi untuk versi 2.9.0 hingga 2.9.6 dari komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.5.0 <2.10.0 Lunak
2.8.0 – 2.8.1

Tabel berikut mencantumkan dependensi untuk versi 2.8.0 dan 2.8.1 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.5.0 <2.9.0 Lunak
2.7.0

Tabel berikut mencantumkan dependensi untuk versi 2.7.0 dari komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.5.0 <2.8.0 Lunak
2.6.0

Tabel berikut mencantumkan dependensi untuk versi 2.6.0 dari komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.5.0 <2.7.0 Lunak
2.5.0 – 2.5.6

Tabel berikut mencantumkan dependensi untuk versi 2.5.0 hingga 2.5.6 dari komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.5.0 <2.6.0 Lunak
2.4.0

Tabel berikut mencantumkan dependensi untuk versi 2.4.0 dari komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.1.0 <2.5.0 Lunak
2.3.0

Tabel berikut mencantumkan dependensi untuk versi 2.3.0 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.1.0 <2.4.0 Lunak
2.2.0

Tabel berikut mencantumkan dependensi untuk versi 2.2.0 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.1.0 <2.3.0 Lunak
2.1.0

Tabel berikut mencantumkan dependensi untuk versi 2.1.0 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.1.0 <2.2.0 Lunak
2.0.x

Tabel berikut mencantumkan dependensi untuk versi 2.0.x komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.0.0 <2.1.0 Lunak
catatan

Versi kompatibel minimum dari nukleus Greengrass sesuai dengan versi patch komponen Greengrass CLI.

Untuk informasi selengkapnya tentang dependensi komponen, lihat referensi resep komponen.

Konfigurasi

Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen.

2.5.x - 2.12.x
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

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

contoh Contoh: Pembaruan gabungan konfigurasi

Contoh konfigurasi berikut menentukan untuk mengotorisasi tiga grup sistem POSIX (group1,1002, dangroup3) dan dua kelompok pengguna Windows (Device OperatorsdanQA Engineers) untuk menggunakan CLI Greengrass.

{
  "AuthorizedPosixGroups": "group1,1002,group3",
  "AuthorizedWindowsGroups": "Device Operators,QA Engineers"
}
2.4.x - 2.0.x
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

contoh Contoh: Pembaruan gabungan konfigurasi

Contoh konfigurasi berikut akan menentukan untuk mengotorisasi tiga kelompok sistem (group1, 1002, dan group3) untuk menggunakan Greengrass CLI.

{
  "AuthorizedPosixGroups": "group1,1002,group3"
}

Berkas log lokal

Komponen ini menggunakan file log yang sama dengan komponen inti Greengrass.

Linux
/greengrass/v2/logs/greengrass.log
Windows
C:\greengrass\v2\logs\greengrass.log
Untuk melihat log komponen ini

  • Jalankan perintah berikut pada perangkat inti untuk melihat file log komponen ini secara real time. Ganti /greengrass/v2 atau C:\greengrass\v2 dengan jalur ke folder AWS IoT Greengrass root.

    Linux
    sudo tail -f /greengrass/v2/logs/greengrass.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait

Changelog

Tabel berikut menjelaskan perubahan dalam setiap versi komponen.

Versi

Perubahan

2.12.6

Versi diperbarui untuk Greengrass nucleus versi 2.12.6 rilis.

2.12.5

Versi diperbarui untuk Greengrass nucleus versi 2.12.5 rilis.

2.12.4

Versi diperbarui untuk Greengrass nucleus versi 2.12.4 rilis.

2.12.3
Awas

Versi ini tidak lagi tersedia. Perbaikan dalam versi ini tersedia di versi yang lebih baru dari komponen ini.

Versi diperbarui untuk Greengrass nucleus versi 2.12.3 rilis.

2.12.2

Versi diperbarui untuk Greengrass nucleus versi 2.12.2 rilis.

2.12.1

Versi diperbarui untuk Greengrass nucleus versi 2.12.1 rilis.

2.12.0

Versi diperbarui untuk Greengrass nucleus versi 2.12.0 rilis.

2.11.3

Versi diperbarui untuk Greengrass nucleus versi 2.11.3 rilis.

2.11.2

Versi diperbarui untuk Greengrass nucleus versi 2.11.2 rilis.

2.11.1

Versi diperbarui untuk Greengrass nucleus versi 2.11.1 rilis.

2.11.0
Fitur baru

  • Memungkinkan Anda membatalkan penerapan lokal.

  • Memungkinkan Anda mengonfigurasi kebijakan penanganan kegagalan untuk penerapan lokal.

  • Meningkatkan pelaporan status penyebaran terperinci.

2.10.3

Versi diperbarui untuk Greengrass nucleus versi 2.10.3 rilis.

2.10.2

Versi diperbarui untuk Greengrass nucleus versi 2.10.2 rilis.

2.10.1

Versi diperbarui untuk Greengrass nucleus versi 2.10.1 rilis.

2.10.0

Versi diperbarui untuk Greengrass nucleus versi 2.10.0 rilis.

2.9.6

Versi diperbarui untuk Greengrass nucleus versi 2.9.6 rilis.

2.9.5

Versi diperbarui untuk Greengrass nucleus versi 2.9.5 rilis.

2.9.4

Versi diperbarui untuk Greengrass nucleus versi 2.9.4 rilis.

2.9.3

Versi diperbarui untuk Greengrass nucleus versi 2.9.3 rilis.

2.9.2

Versi diperbarui untuk Greengrass nucleus versi 2.9.2 rilis.

2.9.1

Versi diperbarui untuk Greengrass nucleus versi 2.9.1 rilis.

2.9.0

 Versi diperbarui untuk Greengrass nucleus versi 2.9.0 rilis.

2.8.1

Versi diperbarui untuk Greengrass nucleus versi 2.8.1 rilis.

2.8.0

 Versi diperbarui untuk Greengrass nucleus versi 2.8.0 rilis.

2.7.0

Versi diperbarui untuk Greengrass nucleus versi 2.7.0 rilis.

2.6.0
Fitur baru

  • Menambahkan dukungan untuk komponen khusus untuk memanggil operasi komunikasi antarproses (IPC) yang digunakan CLI Greengrass. Anda dapat menggunakan operasi IPC ini untuk mengelola penerapan lokal, melihat detail komponen, dan membuat kata sandi yang dapat Anda gunakan untuk masuk ke konsol debug lokal. Untuk informasi selengkapnya, lihat IPC: Mengelola penerapan dan komponen lokal.

Perbaikan bug dan peningkatan

  • Peningkatan dan perbaikan kecil tambahan.

2.5.6

Versi diperbarui untuk Greengrass nucleus versi 2.5.6 rilis.

2.5.5

Versi diperbarui untuk Greengrass nucleus versi 2.5.5 rilis.

2.5.4

Versi diperbarui untuk Greengrass nucleus versi 2.5.4 rilis.

2.5.3

Versi diperbarui untuk Greengrass nucleus versi 2.5.3 rilis.

2.5.2

Versi diperbarui untuk Greengrass nucleus versi 2.5.2 rilis.

2.5.1

Versi diperbarui untuk Greengrass nucleus versi 2.5.1 rilis.

2.5.0
Fitur baru

  • Menambahkan dukungan untuk perangkat inti yang menjalankan Windows.

  • Menambahkan parameter AuthorizedWindowsGroups konfigurasi baru yang dapat Anda tentukan untuk mengotorisasi grup sistem untuk menggunakan CLI Greengrass pada perangkat Windows.

  • Menambahkan windowsUser parameter untuk penerapan lokal. Anda dapat menggunakan parameter ini menentukan pengguna yang akan digunakan untuk menjalankan komponen pada perangkat inti Windows.

2.4.0
Fitur baru

2.3.0

Versi yang diperbarui untuk rilis inti Greengrass versi 2.3.0.

2.2.0

Versi yang diperbarui untuk rilis inti Greengrass versi 2.2.0.

2.1.0

Versi yang diperbarui untuk rilis inti Greengrass versi 2.1.0.

2.0.5

 Versi yang diperbarui untuk rilis inti Greengrass versi 2.0.5.

2.0.4

 Versi yang diperbarui untuk rilis inti Greengrass versi 2.0.4.

2.0.3

Versi awal.