Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Artikel ini menjelaskan manifes apt, file JSON yang menjelaskan detail pembaruan yang diperlukan oleh handler pembaruan apt. Anda dapat mengimpor file ini ke Pembaruan Perangkat seperti pembaruan lainnya. Untuk informasi selengkapnya, lihat Mengimpor pembaruan ke Pembaruan Perangkat.
Saat Anda mengirimkan manifes apt ke agen Pembaruan Perangkat sebagai pembaruan, agen memproses manifes dan melakukan operasi yang diperlukan. Operasi ini termasuk mengunduh dan menginstal paket yang ditentukan dalam file manifes apt dan dependensinya dari repositori yang ditentukan.
Pembaruan Perangkat mendukung jenis pembaruan apt dan handler pembaruan. Dukungan ini memungkinkan agen Pembaruan Perangkat untuk mengevaluasi paket Debian yang diinstal dan memperbarui paket yang diperlukan.
Anda dapat menggunakan manifes apt untuk memperbarui agen Pembaruan Perangkat itu sendiri dan dependensinya. Cantumkan nama agen pembaruan perangkat dan versi yang diinginkan dalam manifes apt seperti yang Anda lakukan pada paket lainnya. Anda kemudian dapat mengimpor manifes apt ini dan menyebarkannya melalui alur Pembaruan Perangkat.
Skema
File manifes apt adalah file JSON dengan skema berversi.
{
"name": "<name>",
"version": "<version>",
"packages": [
{
"name": "<package name>",
"version": "<version specifier>"
}
]
}
Contohnya:
{
"name": "contoso-iot-edge",
"version": "1.0.0.0",
"packages": [
{
"name" : "thermocontrol",
"version" : "1.0.1"
},
{
"name" : "tempreport",
"version" : "2.0.0"
}
]
}
Setiap manifes apt mencakup properti berikut:
-
Nama: Nama untuk manifes apt ini, yang dapat berupa nama atau ID yang bermakna yang sesuai dengan skenario Anda. Contohnya,
contoso-iot-edge. -
Versi: Nomor versi untuk manifes apt ini, misalnya
1.0.0.0. -
Paket: Daftar objek yang berisi properti khusus paket.
-
Nama: Nama paket atau ID, misalnya
iotedge. -
Versi: Kriteria versi paket yang diinginkan, misalnya,
1.0.8-2.
-
Nama: Nama paket atau ID, misalnya
Penerapan versi
Manifes apt hanya mendukung nomor versi yang tepat. Nomor versi adalah versi paket Debian yang diinginkan dalam format <epoch>:<upstream_version>-<debian_revision>, di mana epoch adalah int yang tidak ditandatangani dan upstream_version dimulai dengan digit dan dapat menyertakan alfanumerik dan karakter seperti ., , ,+, -, dan ~. Nilai versi tidak boleh berisi tanda sama dengan.
Misalnya, "name":"iotedge" dan "version":"1.0.8-2" setara dengan menginstal paket menggunakan perintah apt-get install iotedge=1.0.8-2. Versi 1.0.8 sama dengan 1.0.8-0.
Jika versi dihilangkan, Pembaruan Perangkat menginstal versi terbaru yang tersedia dari paket yang ditentukan. Untuk informasi selengkapnya tentang bagaimana paket Debian diberi versi, lihat manual kebijakan Debian.
Catatan
Manajer paket apt mengabaikan persyaratan pembuatan versi yang diberikan oleh sebuah paket ketika paket-paket dependen yang akan diinstal sedang diselesaikan secara otomatis. Kecuali versi eksplisit dari paket dependen diberikan, mereka menggunakan yang terbaru, meskipun paket itu sendiri dapat menentukan persyaratan ketat (=) pada versi tertentu. Resolusi otomatis ini dapat menyebabkan kesalahan terkait dependensi yang tidak terpenuhi.
Oleh karena itu, ketika Anda menginstal versi paket tertentu, yang terbaik adalah juga menyertakan versi eksplisit dari paket dependen untuk diinstal. Untuk informasi selengkapnya, lihat apt-get tidak menyelesaikan dependensi dengan benar pada versi tetap dalam paket Debian/Ubuntu.
Jika Anda memperbarui versi tertentu dari daemon keamanan Azure IoT Edge, Anda harus menyertakan versi paket yang aziot-edge diinginkan dan paket dependennya aziot-identity-service dalam manifes apt Anda. Untuk informasi selengkapnya, lihat Cara memperbarui IoT Edge.
Kriteria terinstal
Nilai kriteria yang diinstal yang direkomendasikan untuk manifes apt adalah <name>-<version>, di mana <name> adalah nama manifes apt dan <version> merupakan versinya. Contohnya,contoso-iot-edge-1.0.0.0.
Penghapusan paket
Anda juga dapat menggunakan manifes apt untuk menghapus paket yang diinstal dari perangkat. Anda dapat menggunakan manifes apt tunggal untuk menghapus, menambahkan, dan memperbarui beberapa paket.
Untuk menghapus paket, tambahkan tanda - minus setelah nama paket. Jangan sertakan nomor versi untuk paket yang Anda hapus. Menghapus paket melalui manifes apt tidak menghapus dependensi dan konfigurasinya.
Misalnya, manifes apt berikut menghapus paket contoso1 dari perangkat apa pun tempatnya disebarkan.
{
"name": "contoso-video",
"version": "2.0.0.1",
"packages": [
{
"name" : "contoso1-"
}
]
}
Panduan pembuatan manifes Apt
Ingatlah panduan berikut saat Anda membuat manifes apt:
Pastikan bahwa manifes apt adalah file JSON yang terbentuk dengan baik.
Berikan setiap manifes apt versi yang unik. Cobalah untuk membuat metodologi standar untuk meningkatkan versi manifes apt, sehingga masuk akal untuk skenario Anda dan mudah diikuti.
Untuk status yang diinginkan dari setiap paket individual, tentukan nama dan versi paket yang tepat yang ingin Anda instal di perangkat Anda. Selalu validasi nilai terhadap konten repositori paket sumber.
Cantumkan paket dalam manifes apt dalam urutan paket harus diinstal atau dihapus.
Selalu validasi penginstalan paket pada perangkat pengujian untuk memastikan hasil yang diinginkan.
Saat Anda menginstal versi paket tertentu, misalnya
iotedge 1.0.9-1, sertakan juga versi eksplisit paket dependen untuk diinstal, misalnyalibiothsm 1.0.9-1.Meskipun tidak diperlukan, selalu membuat kumulatif manifes apt Anda menghindari masuknya perangkat ke status yang tidak diketahui. Pembaruan kumulatif memastikan bahwa perangkat Anda memiliki versi yang diinginkan dari setiap paket yang relevan, bahkan jika perangkat melewati pembaruan karena kegagalan penginstalan atau offline.
Misalnya, pertimbangkan manifes apt dasar berikut:
{ "name": "contoso-iot-edge", "version": "1.0", "packages": [ { "name": "contoso1", "version": "1.0.1" } ] }Pembaruan versi 2.0 berikut menyertakan
contoso2paket, tetapi bukancontoso1paket. Semua perangkat yang menerima pembaruan 2.0 mungkin tidak memilikicontoso1paket.{ "name": "contoso-iot-edge", "version": "2.0", "packages": [ { "name": "contoso2", "version": "3.0.2" } ] }Pembaruan kumulatif versi 2.0 berikut mencakup
contoso1paket dancontoso2:{ "name": "contoso-iot-edge", "version": "2.0", "packages": [ { "name": "contoso1", "version": "1.0.1" }, { "name": "contoso2", "version": "3.0.2" } ] }