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

Mempersiapkan untuk menggunakan Katalog Paket Perangkat Lunak

Bagian berikut memberikan ikhtisar siklus hidup versi paket dan informasi untuk menggunakan Katalog AWS IoT Device Management Paket Perangkat Lunak.

Siklus hidup versi paket

Versi paket dapat berkembang melalui status siklus hidup berikut:draft,, published dan. deprecated Bisa jugadeleted.

Konvensi penamaan versi Package

Saat Anda memberi nama versi paket, penting untuk merencanakan dan menerapkan strategi penamaan logis sehingga Anda dan orang lain dapat dengan mudah mengidentifikasi versi paket terbaru dan perkembangan versi. Anda harus memberikan nama versi saat membuat versi paket, tetapi strategi dan formatnya sebagian besar tergantung pada kasus bisnis Anda.

Sebagai praktik terbaik, kami sarankan menggunakan format Versi SemVerSemantik. Misalnya, 1.2.3 di mana 1 versi utama untuk perubahan yang tidak kompatibel secara fungsional, 2 versi utama untuk perubahan yang kompatibel secara fungsional, dan 3 merupakan versi tambalan (untuk perbaikan bug). Untuk informasi selengkapnya, lihat Versioning Semantik 2.0.0. Untuk informasi selengkapnya tentang persyaratan nama versi paket, lihat versionNamedi panduan AWS IoT API referensi.

Versi default

Menyetel versi sebagai default adalah opsional. Anda dapat menambah atau menghapus versi paket default. Anda juga dapat menerapkan versi paket yang tidak dinamai sebagai versi default.

Saat Anda membuat versi paket, itu ditempatkan dalam draft keadaan dan tidak dapat dinamai sebagai versi default sampai Anda mentransisikan versi paket ke diterbitkan. Software Package Catalog tidak secara otomatis memilih versi sebagai default atau memperbarui versi paket yang lebih baru sebagai default. Anda harus dengan sengaja memberi nama versi paket yang Anda pilih melalui konsol atau dengan mengeluarkan operasi. UpdatePackageVersionAPI

Atribut versi

Atribut versi dan nilainya menyimpan informasi penting tentang versi paket Anda. Kami menyarankan Anda menentukan atribut tujuan umum untuk paket atau versi paket. Misalnya, Anda dapat membuat pasangan nama-nilai untuk platform, arsitektur, sistem operasi, tanggal rilis, penulis, atau Amazon S3. URL

Saat Anda membuat AWS IoT pekerjaan dengan dokumen pekerjaan, Anda juga dapat memilih untuk menggunakan variabel substitusi ($parameter) yang mengacu pada nilai atribut. Untuk informasi selengkapnya, lihat Mempersiapkan AWS IoT Pekerjaan.

Atribut versi yang digunakan dalam versi paket tidak akan secara otomatis ditambahkan ke bayangan bernama yang dicadangkan dan tidak dapat diindeks atau ditanyakan melalui Pengindeksan Armada secara langsung. Untuk mengindeks atau menanyakan atribut versi paket melalui Fleet Indexing, Anda dapat mengisi atribut version dalam bayangan bernama cadangan.

Kami merekomendasikan bahwa parameter atribut versi dalam properti yang dilaporkan perangkat tangkapan bayangan bernama yang dicadangkan, seperti sistem operasi dan waktu instalasi. Mereka juga dapat diindeks dan ditanyakan melalui Pengindeksan Armada.

Atribut versi tidak diperlukan untuk mengikuti konvensi penamaan tertentu. Anda dapat membuat pasangan nama-nilai untuk memenuhi kebutuhan bisnis Anda. Ukuran gabungan dari semua atribut pada versi paket dibatasi hingga 3KB. Untuk informasi selengkapnya, lihat Paket perangkat lunak Katalog Paket Perangkat Lunak dan batas versi paket.

Mengaktifkan pengindeksan AWS IoT armada

Anda harus mengaktifkan pengindeksan armada untuk Katalog Paket Perangkat Lunak untuk membuat atau memperbarui paket perangkat lunak dan versi paket. Pengindeksan armada memberikan dukungan yang memungkinkan AWS IoT hal-hal dikelompokkan melalui grup benda dinamis yang difilter berdasarkan versi. Misalnya, pengindeksan armada dapat mengidentifikasi hal-hal yang telah atau tidak memiliki versi paket tertentu yang diinstal, tidak memiliki versi paket yang diinstal, atau cocok dengan pasangan nama-nilai tertentu. Terakhir, pengindeksan armada menyediakan metrik standar dan kustom yang dapat Anda gunakan untuk mendapatkan wawasan tentang keadaan armada Anda. Untuk informasi selengkapnya, lihat Mempersiapkan pengindeksan armada.

Cadangan bernama bayangan

Bayangan bernama yang dicadangkan$package,, mencerminkan keadaan paket perangkat lunak yang diinstal perangkat dan versi paket. Pengindeksan armada menggunakan bayangan bernama cadangan sebagai sumber data untuk membuat metrik standar dan kustom sehingga Anda dapat menanyakan status armada Anda. Untuk informasi selengkapnya, lihat Mempersiapkan pengindeksan armada.

Bayangan bernama cadangan mirip dengan bayangan bernama dengan pengecualian bahwa namanya telah ditentukan sebelumnya dan Anda tidak dapat mengubahnya. Selain itu, bayangan bernama yang dicadangkan tidak diperbarui dengan metadata, dan hanya menggunakan kata kunci dan kata kunciversion. attributes

Permintaan pembaruan yang menyertakan kata kunci laindescription, seperti, akan menerima respons kesalahan di bawah rejected topik. Untuk informasi selengkapnya, lihat Pesan galat Device Shadow.

Ini dapat dibuat ketika Anda membuat AWS IoT sesuatu melalui konsol, ketika AWS IoT pekerjaan berhasil menyelesaikan dan memperbarui bayangan, dan jika Anda mengeluarkan UpdateThingShadowAPIoperasi. Untuk informasi selengkapnya, lihat UpdateThingShadowdi panduan AWS IoT Core pengembang.

Struktur $package bayangan

Bayangan bernama cadangan berisi yang berikut:

{
    "state": {
        "reported": {
            "<packageName>": {
                "version": "",
                "attributes": {
                }
            }
        }
    },
    "version" : 1
    "timestamp" : 1672531201
}

Properti bayangan diperbarui dengan informasi berikut:

Untuk informasi selengkapnya tentang format dan perilaku bayangan bernama, lihat Urutan Layanan AWS IoT Device Shadow pesan.

Menghapus paket perangkat lunak dan versi paketnya

Sebelum Anda menghapus paket perangkat lunak, lakukan hal berikut:

Selama tidak ada versi paket default bernama, Anda dapat menggunakan konsol untuk menghapus paket perangkat lunak dan semua versi paketnya juga akan dihapus. Jika Anda menggunakan API panggilan untuk menghapus paket perangkat lunak, Anda harus menghapus versi paket terlebih dahulu dan kemudian paket perangkat lunak.