AWS IoT GreengrassKit Pengembangan Antarmuka Baris Perintah - AWS IoT Greengrass
PrasyaratChangelog

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

AWS IoT GreengrassKit Pengembangan Antarmuka Baris Perintah

AWS IoT GreengrassDevelopment Kit Command-Line Interface (GDK CLI) menyediakan fitur yang membantu Anda mengembangkan komponen Greengrass khusus. Anda dapat menggunakan CLI GDK untuk membuat, membangun, dan menerbitkan komponen kustom. Saat Anda membuat repositori komponen dengan CLI GDK, Anda dapat memulai dari template atau komponen komunitas dari Katalog Perangkat Lunak Greengrass. Kemudian, Anda dapat memilih sistem build yang mengemas file sebagai arsip ZIP, menggunakan skrip build Maven atau Gradle, atau menjalankan perintah build kustom. Setelah membuat komponen, Anda dapat menggunakan CLI GDK untuk mempublikasikannya ke AWS IoT Greengrass layanan, sehingga Anda dapat menggunakan AWS IoT Greengrass konsol atau API untuk menyebarkan komponen ke perangkat inti Greengrass Anda.

Saat Anda mengembangkan komponen Greengrass tanpa CLI GDK, Anda harus memperbarui versi dan URI artefak dalam file resep komponen setiap kali Anda membuat versi baru komponen. Saat Anda menggunakan CLI GDK, CLI dapat secara otomatis memperbarui versi dan URI artefak untuk Anda setiap kali Anda menerbitkan versi baru komponen.

CLI GDK adalah open source dan tersedia di. GitHub Anda dapat menyesuaikan dan memperluas CLI GDK untuk memenuhi kebutuhan pengembangan komponen Anda. Kami mengundang Anda untuk membuka masalah dan menarik permintaan pada GitHub repositori. Anda dapat menemukan sumber CLI GDK di tautan berikut: https://github.com/aws-greengrass/. aws-greengrass-gdk-cli

Prasyarat

Untuk menginstal dan menggunakan CLI Greengrass Development Kit, Anda memerlukan yang berikut ini:

  • Sesi Akun AWS. Jika Anda tidak memilikinya, lihat Menyiapkan sebuah Akun AWS.

  • Komputer pengembangan seperti Windows, macOS, atau Unix dengan koneksi internet.

  • Untuk GDK CLI versi 1.1.0 atau yang lebih baru, Python 3.6 atau yang lebih baru diinstal pada komputer pengembangan Anda.

    Untuk GDK CLI versi 1.0.0, Python 3.8 atau yang lebih baru diinstal pada komputer pengembangan Anda.

  • Git diinstal pada komputer pengembangan Anda.

  • AWS Command Line Interface(AWS CLI) diinstal dan dikonfigurasi dengan kredensional di komputer pengembangan Anda. Untuk informasi selengkapnya, lihat Menginstal, memperbarui, dan melepas pemasangan AWS CLI dan Mengonfigurasi AWS CLI di Panduan Pengguna AWS Command Line Interface.

    catatan

    Jika Anda menggunakan Raspberry Pi atau perangkat ARM 32-bit lainnya, instal V1 AWS CLI. AWS CLI V2 tidak tersedia untuk perangkat ARM 32-bit. Untuk informasi selengkapnya, lihat Menginstal, memperbarui, dan mencopot instalasi AWS CLI versi 1.

  • Untuk menggunakan CLI GDK untuk mempublikasikan komponen ke AWS IoT Greengrass layanan, Anda harus memiliki izin berikut:

    • s3:CreateBucket

    • s3:GetBucketLocation

    • s3:PutObject

    • greengrass:CreateComponentVersion

    • greengrass:ListComponentVersions

  • Untuk menggunakan CLI GDK untuk membangun komponen yang artefaknya ada di bucket S3 dan bukan di sistem file lokal, Anda harus memiliki izin berikut:

    • s3:ListBucket

    Fitur ini tersedia untuk GDK CLI v1.1.0 dan yang lebih baru.

Changelog

Tabel berikut menjelaskan perubahan di setiap versi CLI GDK. Untuk informasi selengkapnya, lihat halaman Rilis CLI GDK di. GitHub

Versi

Perubahan

1.6.2
Perbaikan bug dan peningkatan

  • Memperbaiki masalah di mana Windows gradlew.bat tidak berfungsi karena jalur relatif.

  • Perbaikan kecil pada logging, pengujian, dan pengemasan.

1.6.1
Perbaikan bug dan peningkatan

  • Menambahkan perbaikan keamanan untuk penguraian argumen CLI.

  • Mengaktifkan GDK untuk mendapatkan nama rilis Greengrass Testing Framework (GTF) terbaru sebagai versi GTF default.

  • Memungkinkan GDK untuk merekomendasikan pelanggan menggunakan versi GTF yang lebih lama yang mereka perbarui ke versi terbaru.

1.6.0
Fitur baru

  • Menambahkan pemeriksaan validasi resep terhadap skema resep Greengrass selama perintah and. component build component publish Pembaruan ini membantu pengembang mengidentifikasi masalah yang dapat ditindaklanjuti dalam resep komponen mereka sebelumnya dalam proses pembuatan komponen.

  • Menambahkan suite uji kepercayaan ke template yang dapat ditarik ke bawah oleh test-e2e init perintah. Rangkaian uji kepercayaan diri ini mencakup delapan tes generik yang dapat digunakan dan diperluas agar sesuai dengan kebutuhan pengujian komponen dasar.

Perbaikan bug dan peningkatan

  • Memperbarui versi Greengrass Testing Framework (GTF) default yang digunakan oleh perintah ke versi 1.2.0. test-e2e

1.5.0
Perbaikan bug dan peningkatan

Memperbarui pola yang dikenali oleh opsi excludes build kapan build_systemzip. Versi ini sekarang akan mengenali pola glob yang cocok dengan nama jalur berdasarkan karakter wildcard mereka. Ini memungkinkan spesifikasi khusus direktori mana yang akan dikecualikan.
1.4.0
Fitur baru

  • Menambahkan config perintah baru yang memulai prompt interaktif untuk memodifikasi bidang dalam file konfigurasi GDK yang ada.

  • Memodifikasi gdk component publish perintah gdk component build dan untuk memverifikasi bahwa ukuran resep berada dalam persyaratan Greengrass (<=16000 byte) sebelum melanjutkan.

Perbaikan bug dan peningkatan

  • Menambahkan logging tambahan dalam output gdk component build perintah saat kesalahan sintaks resep mencegah build selesai untuk kesadaran.

  • Mengganti nama otf-options dan otf-version ke gtf-options dan gtf-version masing-masing, karena penggantian nama Open Test Framework menjadi Greengrass Testing Framework.
1.3.0
Fitur baru

  • Menambahkan test-e2e perintah baru untuk mendukung end-to-end pengujian komponen menggunakan Open Test Framework.

  • Menambahkan opsi konfigurasi baru,zip_name, untuk mendukung nama file zip yang dapat dikonfigurasi dengan sistem pembuatan zip.

  • Membuat region properti dalam file konfigurasi GDK opsional.

Perbaikan bug dan peningkatan

  • Memperbaiki masalah di mana direktori baru dibuat bahkan ketika template atau repositori yang ditentukan tidak ada saat menginisialisasi proyek GDK dengan argumen. --name
1.2.3
Perbaikan bug dan peningkatan

  • Memperbaiki masalah saat pembuatan bucket gagal karena penanganan kesalahan yang salah.

  • Memperbaiki masalah di mana struktur daftar dalam resep komponen dihapus.
1.2.2
Perbaikan bug dan peningkatan

  • Kunci resep tidak lagi peka huruf besar/kecil.

  • Menambahkan pemeriksaan untuk menentukan apakah ada bucket di Wilayah AWS dan dapat diakses oleh pengguna sebelum membuat bucket baru. Membutuhkan pengguna untuk memiliki GetBucketLocation izin.

  • Memperbaiki masalah dengan excludes kata kunci dalam file konfigurasi CLI GDK.
1.2.1
Perbaikan bug dan peningkatan

  • Menerima Kanada (Tengah) (ca-central-1) Wilayah AWS di entri konfigurasi wilayah dalam gdk-config.json file.

  • Memperbaiki masalah dengan argumen --region CLI GDK ke perintah. publish
1.2.0
Fitur baru

  • Menambahkan options entri ke build konfigurasi dalam file konfigurasi CLI GDK. Mendukung excludes under options untuk mengecualikan file tertentu dari artefak zip saat menggunakan sistem zip build.

  • Menambahkan sistem gradlew build untuk menggunakan Gradle Wrapper untuk membangun komponen.

  • Menambahkan dukungan untuk file build DSL Kotlin untuk opsi gradle build.

  • Menambahkan options entri ke publish konfigurasi dalam file konfigurasi CLI GDK. Mendukung file_upload_args under options untuk memberikan argumen tambahan saat mengunggah file ke Amazon S3.

Perbaikan bug dan peningkatan

  • Memperbaiki masalah saat build Gradle tidak dibersihkan sebelum menjalankan perintah build.

  • Memperbaiki masalah saat build tidak keluar saat perintah build gagal.

  • Meningkatkan format output gdk component list perintah.

1.1.0
Fitur baru

  • Menambahkan dukungan untuk sistem build Gradle.

  • Menambahkan dukungan untuk sistem build Maven di perangkat Windows.

  • Menambahkan --bucket argumen ke perintah component publish. Anda dapat menggunakan argumen ini untuk menentukan bucket yang tepat di mana CLI GDK mengunggah artefak komponen.

  • Menambahkan --name argumen ke perintah komponen init. Anda dapat menggunakan opsi ini untuk menentukan folder tempat CLI GDK menginisialisasi komponen.

  • Menambahkan dukungan untuk artefak komponen yang ada di bucket S3 tetapi tidak di folder build komponen lokal. Anda dapat menggunakan fitur ini untuk mengurangi biaya bandwidth untuk artefak komponen besar, seperti model pembelajaran mesin.

Perbaikan bug dan peningkatan

  • Memperbarui perintah component publish untuk memeriksa apakah komponen dibangun sebelum menerbitkan komponen. Jika komponen tidak dibangun, perintah ini sekarang membangun komponen untuk Anda.

  • Memperbaiki masalah di mana sistem pembuatan zip gagal dibangun di perangkat Windows saat nama file ZIP berisi huruf kapital.

  • Meningkatkan format pesan log dan mengubah tingkat log default ke INFO perangkat yang menjalankan versi Python lebih awal dari 3.8.

  • Mengubah persyaratan versi Python minimum ke Python 3.6.

1.0.0

Versi awal.