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

# Memulai dengan Software Package Catalog
<a name="getting-started-with-software-package-catalog"></a>

Anda dapat membangun dan memelihara Katalog Paket AWS IoT Device Management Perangkat Lunak melalui Konsol Manajemen AWS, operasi AWS IoT Core API, dan AWS Command Line Interface (AWS CLI).

**catatan**  
Mengaktifkan pengindeksan AWS IoT armada adalah persyaratan untuk menggunakan Katalog Paket Perangkat Lunak. Operasi dasar seperti membuat versi paket perangkat lunak di Konsol Manajemen AWS dan menggunakan perintah `CreatePackage` API akan gagal tanpa pengindeksan AWS IoT armada diaktifkan.  
Untuk informasi selengkapnya tentang penggunaan pengindeksan AWS IoT armada dengan Katalog Paket Perangkat Lunak, lihat[Mempersiapkan pengindeksan armada](preparing-fleet-indexing.md).

**Menggunakan konsol**

Untuk menggunakan Konsol Manajemen AWS, masuk ke AWS akun Anda dan navigasikan ke [AWS IoT Core](https://console.aws.amazon.com/iot/home). Di panel navigasi, pilih **Paket perangkat lunak**. Anda kemudian dapat membuat dan mengelola paket dan versinya dari bagian ini.

**Menggunakan operasi API atau CLI**

Anda dapat menggunakan operasi AWS IoT Core API untuk membuat dan mengelola fitur Katalog Paket Perangkat Lunak. Untuk informasi selengkapnya, lihat [Referensi AWS IoT API AWS](https://docs.aws.amazon.com/iot/latest/apireference/) [SDKs dan Toolkit](https://aws.amazon.com/developer/tools/). AWS CLI Perintah juga mengelola katalog Anda. Untuk informasi selengkapnya, lihat Referensi [Perintah AWS IoT CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/index.html).

**Topics**
+ [Membuat paket perangkat lunak dan versi paket](creating-package-and-version.md)
+ [Menerapkan versi paket melalui pekerjaan AWS IoT](deploying-package-version.md)
+ [Mengaitkan versi paket ke suatu AWS IoT hal](associating-package-version.md)

# Membuat paket perangkat lunak dan versi paket
<a name="creating-package-and-version"></a>

Anda dapat menggunakan langkah-langkah berikut untuk membuat paket dan hal versi awal melalui Konsol Manajemen AWS.

**Untuk membuat paket perangkat lunak**

1. Masuk ke AWS akun Anda dan arahkan ke [AWS IoT konsol](https://console.aws.amazon.com/iot/home). 

1.  Pada panel navigasi, pilih **Paket perangkat lunak**. 

1.  Pada halaman **paket AWS IoT perangkat lunak**, pilih **Buat paket**. Kotak dialog **Aktifkan dependensi untuk manajemen paket** muncul. 

1.  Di bawah **Pengindeksan armada**, pilih **Tambahkan paket dan versi perangkat lunak perangkat**. Ini diperlukan untuk Katalog Paket Perangkat Lunak dan menyediakan pengindeksan armada dan metrik tentang armada Anda. 

1. [Opsional] Jika Anda ingin AWS IoT lowongan memperbarui bayangan bernama cadangan saat pekerjaan berhasil diselesaikan, pilih **Perbarui bayangan otomatis dari pekerjaan**. Jika Anda tidak ingin AWS IoT pekerjaan melakukan pembaruan ini, biarkan kotak centang ini tidak dipilih.

1.  [Opsional] Untuk memberikan AWS IoT lowongan hak untuk memperbarui bayangan bernama yang dicadangkan, di bawah **Pilih peran**, pilih **Buat peran**. Jika Anda tidak ingin AWS IoT lowongan melakukan pembaruan ini, peran ini tidak diperlukan. 

1. Buat atau pilih peran.

   1. Jika Anda **tidak memiliki peran** untuk tujuan ini: Saat kotak dialog **Buat peran** muncul, masukkan **nama Peran**, lalu pilih **Buat**.

   1. Jika **Anda memiliki peran** untuk tujuan ini: Untuk **peran Pilih, pilih peran** Anda, lalu pastikan kotak centang **Lampirkan kebijakan ke peran IAM** dipilih.

1. Pilih **Konfirmasi**. Halaman **Buat paket baru** muncul.

1. Di bawah **Package detail**, masukkan **nama Package**.

1. Di bawah **Package description**, masukkan informasi untuk membantu Anda mengidentifikasi dan mengelola paket ini.

1. [Opsional] Anda dapat menggunakan tag untuk membantu Anda mengkategorikan dan mengelola paket ini. Untuk menambahkan tag, perluas **Tag**, pilih **Tambahkan tag**, dan masukkan pasangan nilai kunci. Anda dapat memasukkan hingga 50 tag. Untuk informasi selengkapnya, lihat [Menandai AWS IoT sumber daya Anda](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot.html).

**Untuk menambahkan versi paket saat membuat paket baru**

1. Di bawah **Versi awal**, masukkan **nama Versi**.

   Sebaiknya gunakan [SemVer format](https://semver.org/) (misalnya,`1.0.0.0`) untuk mengidentifikasi versi paket Anda secara unik. Anda juga dapat menggunakan strategi pemformatan berbeda yang lebih sesuai dengan kasus penggunaan Anda. Untuk informasi selengkapnya, lihat [Siklus hidup versi paket](preparing-to-use-software-package-catalog.md#package-version-lifecycle). 

1. Di bawah **Deskripsi versi**, masukkan informasi yang akan membantu Anda mengidentifikasi dan mengelola versi paket ini.
**catatan**  
Kotak centang **versi Default** dinonaktifkan karena versi paket dibuat dalam `draft` keadaan. Anda dapat memberi nama versi default setelah Anda membuat versi paket dan ketika Anda mengubah status menjadi`published`. Untuk informasi selengkapnya, lihat [Siklus hidup versi paket](preparing-to-use-software-package-catalog.md#package-version-lifecycle).

1. [Opsional] Untuk membantu Anda mengelola versi ini atau untuk mengkomunikasikan informasi ke perangkat Anda, masukkan satu atau beberapa pasangan nama-nilai untuk atribut **Versi**. Pilih **Tambahkan atribut** untuk setiap pasangan nama-nilai yang Anda masukkan. Untuk informasi selengkapnya, lihat [Atribut versi](preparing-to-use-software-package-catalog.md#version-attributes).

1. [Opsional] Anda dapat menggunakan tag untuk membantu Anda mengkategorikan dan mengelola paket ini. Untuk menambahkan tag, perluas **Tag**, pilih **Tambahkan** tag, dan masukkan pasangan nilai kunci. Anda dapat memasukkan hingga 50 tag. Untuk informasi selengkapnya, lihat [Menandai AWS IoT sumber daya Anda](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot.html).

1. Pilih **Berikutnya**.

**Kaitkan Tagihan Materi Perangkat Lunak ke Versi Package (Opsional)**

1. Pada **Langkah 3: Versi SBOMs (Opsional)** di jendela **konfigurasi SBOM**, pilih format file SBOM default dan mode validasi yang digunakan untuk memvalidasi tagihan materi perangkat lunak Anda sebelum dikaitkan dengan versi paket Anda.

1. Di jendela **Tambahkan file SBOM**, masukkan Nama Sumber Daya Amazon (ARN) yang mewakili bucket Amazon S3 berversi Anda dan format file SBOM pilihan jika jenis default tidak berfungsi.
**catatan**  
Anda dapat menambahkan satu file SBOM atau satu file zip yang berisi beberapa SBOMs jika Anda memiliki lebih dari satu tagihan materi perangkat lunak untuk versi paket Anda. 

1. Di jendela **file Added SBOM**, Anda dapat melihat file SBOM yang Anda tambahkan untuk versi paket Anda.

1. Pilih **Buat paket dan versi**. Halaman versi paket muncul dan Anda dapat melihat status validasi file SBOM Anda di jendela file **SBOM Ditambahkan**. Status awal adalah `In progress` saat file SBOM mengalami validasi. 
**catatan**  
Status validasi file SBOM adalah`Invalid file`,,,`Not started`, `In progress` `Validated (SPDX)``Validated (CycloneDX)`, dan alasan kegagalan validasi.

# Menerapkan versi paket melalui pekerjaan AWS IoT
<a name="deploying-package-version"></a>

Anda dapat menggunakan langkah-langkah berikut untuk menyebarkan versi paket melalui. Konsol Manajemen AWS

**Prasyarat:**

Sebelum memulai, lakukan hal berikut:
+ Daftarkan AWS IoT hal-hal dengan AWS IoT Core. Untuk petunjuk arah untuk menambahkan perangkat Anda AWS IoT Core, lihat [Membuat objek benda](https://docs.aws.amazon.com/iot/latest/developerguide/create-iot-resources.html#create-aws-thing).
+ [Opsional] Buat grup AWS IoT benda atau grup benda dinamis untuk menargetkan perangkat yang akan Anda gunakan versi paket. Untuk petunjuk arah untuk membuat grup benda, lihat [Membuat grup benda statis](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html#create-thing-group). Untuk petunjuk arah untuk membuat grup benda dinamis, lihat [Membuat grup hal dinamis](https://docs.aws.amazon.com/iot/latest/developerguide/dynamic-thing-groups.html#create-dynamic-thing-group).
+ Buat paket perangkat lunak dan versi paket. Untuk informasi selengkapnya, lihat [Membuat paket perangkat lunak dan versi paket](creating-package-and-version.md).
+ Buat dokumen pekerjaan. Untuk informasi selengkapnya, lihat [Mempersiapkan dokumen pekerjaan dan versi paket untuk penerapan](https://docs.aws.amazon.com/iot/latest/developerguide/preparing-jobs-for-service-package-catalog.html#preparing-to-deploy).

**Untuk menyebarkan pekerjaan AWS IoT**

1. Di [AWS IoT konsol](https://console.aws.amazon.com/iot/home), pilih **Paket perangkat lunak**.

1. Pilih paket perangkat lunak yang ingin Anda gunakan. Halaman **detail paket perangkat lunak** muncul.

1. Pilih versi paket yang ingin Anda terapkan, di bawah **Versi**, dan pilih **Terapkan versi pekerjaan**.

1. Jika ini adalah pertama kalinya Anda menerapkan pekerjaan melalui portal ini, kotak dialog yang menjelaskan persyaratan akan muncul. Tinjau informasi dan pilih **Akui**.

1. Masukkan nama untuk penyebaran atau tinggalkan nama yang dibuat secara otomatis di bidang **Nama**.

1. [Opsional] Di bidang **Deskripsi**, masukkan deskripsi yang mengidentifikasi tujuan atau isi penyebaran, atau tinggalkan informasi yang dibuat secara otomatis. 

   **Catatan:** Kami menyarankan agar Anda tidak menggunakan informasi identitas pribadi di kolom Nama dan deskripsi Job.

1. [Opsional] Tambahkan tag apa pun untuk dikaitkan dengan pekerjaan ini.

1. Pilih **Berikutnya**.

1. Di bawah **target Job**, pilih hal-hal atau kelompok hal yang harus menerima pekerjaan.

1. Di bidang **File Job**, tentukan file JSON dokumen pekerjaan.

1. **Integrasi Open Jobs dengan layanan Package Catalog**.

1. Pilih paket dan versi yang ditentukan dalam dokumen pekerjaan Anda.
**catatan**  
Anda diminta untuk memilih paket dan versi paket yang sama yang ditentukan dalam dokumen pekerjaan. Anda dapat memasukkan lebih banyak, tetapi pekerjaan akan mengeluarkan instruksi hanya untuk paket dan versi yang disertakan dalam dokumen pekerjaan. Untuk informasi selengkapnya, lihat [Penamaan paket dan versi saat menerapkan](https://docs.aws.amazon.com/iot/latest/developerguide/preparing-jobs-for-service-package-catalog.html#naming-package-versions).

1. Pilih **Berikutnya**.

1. Pada halaman konfigurasi Job, pilih salah satu jenis pekerjaan berikut di kotak dialog konfigurasi Job:
   + **Pekerjaan snapshot:** Pekerjaan snapshot selesai ketika selesai dijalankan pada perangkat dan grup target.
   + **Pekerjaan berkelanjutan: Pekerjaan** berkelanjutan berlaku untuk grup benda dan berjalan di perangkat apa pun yang nantinya Anda tambahkan ke grup target tertentu.

1. Di kotak dialog **Konfigurasi tambahan - opsional**, tinjau konfigurasi pekerjaan opsional berikut dan buat pilihan Anda sesuai. Untuk informasi selengkapnya, lihat [Peluncuran Job, penjadwalan, dan membatalkan konfigurasi serta batas waktu [eksekusi Job](https://docs.aws.amazon.com/iot/latest/developerguide/jobs-configurations-details.html#job-timeout-retry) dan konfigurasi](https://docs.aws.amazon.com/iot/latest/developerguide/jobs-configurations-details.html#job-rollout-abort-scheduling) coba lagi.
   + Konfigurasi peluncuran
   + Konfigurasi penjadwalan
   + Konfigurasi batas waktu eksekusi Job
   + Konfigurasi coba lagi eksekusi Job
   + Batalkan konfigurasi

1. Tinjau pilihan pekerjaan dan kemudian pilih **Kirim**.

Setelah Anda membuat pekerjaan, konsol menghasilkan tanda tangan JSON dan menempatkannya di dokumen pekerjaan Anda. Anda dapat menggunakan AWS IoT konsol untuk melihat status pekerjaan, atau membatalkan atau menghapus pekerjaan. Untuk mengelola pekerjaan, buka [hub Job konsol](https://console.aws.amazon.com/iot/home#/jobhub).

# Mengaitkan versi paket ke suatu AWS IoT hal
<a name="associating-package-version"></a>

Setelah Anda menginstal perangkat lunak pada perangkat Anda, Anda dapat mengaitkan versi paket ke AWS IoT sesuatu yang dicadangkan bernama shadow. Jika AWS IoT pekerjaan telah dikonfigurasi untuk memperbarui bayangan bernama yang dicadangkan setelah pekerjaan diterapkan dan berhasil diselesaikan, Anda tidak perlu menyelesaikan prosedur ini. Untuk informasi selengkapnya, lihat [Cadangan bernama bayangan](preparing-to-use-software-package-catalog.md#reserved-named-shadow). 

**Prasyarat:**

Sebelum memulai, lakukan hal berikut:
+ Buat AWS IoT sesuatu, atau benda, dan bangun telemetri melalui. AWS IoT Core Untuk informasi selengkapnya, lihat [Memulai dengan AWS IoT Core](https://docs.aws.amazon.com/iot/latest/developerguide/iot-gs.html). 
+  Buat paket perangkat lunak dan versi paket. Untuk informasi selengkapnya, lihat [Membuat paket perangkat lunak dan versi paket](creating-package-and-version.md). 
+  Instal perangkat lunak versi paket pada perangkat. 

**catatan**  
Mengaitkan versi paket ke AWS IoT sesuatu tidak memperbarui atau menginstal perangkat lunak pada perangkat fisik. Versi paket harus digunakan ke perangkat. 

**Untuk mengaitkan versi paket ke suatu AWS IoT hal**

1. Pada panel navigasi [AWS IoT konsol](https://console.aws.amazon.com/iot/home), perluas menu **Semua perangkat** dan pilih **Things**.

1. Identifikasi AWS IoT hal yang ingin Anda perbarui dari daftar dan pilih nama benda untuk menampilkan halaman detailnya.

1. Di bagian **Detail**, pilih **Paket dan versi**.

1.  Pilih **Tambahkan ke paket dan versi**. 

1.  Untuk **Pilih paket perangkat, pilih paket** perangkat lunak yang Anda inginkan. 

1.  Untuk **Pilih versi**, pilih versi perangkat lunak yang Anda inginkan. 

1.  Pilih **Tambahkan paket perangkat**. 

    Paket dan versi muncul di daftar **Paket dan versi yang dipilih**. 

1.  Ulangi langkah-langkah ini untuk setiap paket dan versi yang ingin Anda kaitkan dengan hal ini. 

1.  Setelah selesai, pilih **Tambahkan paket dan detail versi**. Halaman **Detail Thing** terbuka dan Anda dapat melihat paket dan versi baru dalam daftar.