Mengelola manifes penyebaran IoT Edge di aplikasi IoT Central Anda

Manifes penyebaran memungkinkan Anda menentukan modul yang harus diunduh dan dikonfigurasi oleh runtime IoT Edge. Perangkat IoT Edge dapat mengunduh manifes penyebaran saat pertama kali terhubung ke aplikasi IoT Central Anda. Artikel ini menjelaskan cara Anda mengelola manifes penyebaran di aplikasi IoT Central Anda.

Untuk mempelajari lebih lanjut tentang IoT Edge dan IoT Central, lihat Sambungkan perangkat Azure IoT Edge ke aplikasi Azure IoT Central.

Untuk mempelajari cara mengelola manifes penyebaran dengan menggunakan IoT Central REST API, lihat Cara menggunakan REST API IoT Central untuk mengelola manifes penyebaran.

Mengelola manifes penyebaran

Halaman manifes Edge memungkinkan Anda mengelola manifes penyebaran di aplikasi Anda. Dari halaman ini Anda dapat:

  • Mengunggah atau membuat manifes penyebaran
  • Mengubah manifes penyebaran yang ada
  • Menghapus manifes penyebaran

Mengunggah dan membuat manifes penyebaran

Saat membuat manifes penyebaran baru, Anda dapat mengunggah file JSON manifes penyebaran atau memulai dengan manifes yang ada:

  1. Pada halaman Manifes Edge, pilih + Baru.

  2. Masukkan nama untuk manifes penyebaran.

  3. Jika aplikasi Anda menggunakan organisasi, pilih organisasi untuk mengaitkan manifes penyebaran.

  4. Telusuri file manifes penyebaran untuk mengunggah atau memilih manifes penyebaran yang ada sebagai titik awal untuk yang baru Anda. IoT Central memvalidasi file yang diunggah.

    Screenshot that shows an uploaded and validated deployment manifest.

  5. Pilih Selanjutnya. Halaman Tinjau dan selesai menampilkan informasi tentang manifes penyebaran dan modul yang ditentukannya. Anda juga dapat melihat JSON mentah.

  6. Pilih Buat. Halaman Manifes Edge sekarang menyertakan manifes penyebaran baru.

Tip

Jika Anda memiliki manifes penyebaran dalam jumlah besar, Anda dapat mengurutkan dan memfilter daftar yang diperlihatkan di halaman manifes Edge.

Mengedit sumber JSON manifes penyebaran

Untuk mengubah manifes penyebaran dengan mengedit JSON secara langsung:

  1. Navigasikan ke halaman manifes Edge.

  2. Pilih Edit JSON di menu konteks untuk manifes penyebaran yang ingin Anda ubah.

  3. Gunakan editor JSON untuk membuat perubahan yang diperlukan. Kemudian pilih Simpan.

Mengganti konten manifes penyebaran

Untuk sepenuhnya mengganti konten manifes penyebaran:

  1. Navigasikan ke halaman manifes Edge.

  2. Pilih manifes penyebaran yang ingin Anda ganti.

  3. Dalam dialog Kustomisasi, telusuri file manifes penyebaran baru untuk mengunggah atau memilih manifes penyebaran yang ada sebagai titik awal. IoT Central memvalidasi file yang diunggah.

  4. Pilih Selanjutnya. Halaman Tinjau dan selesai menampilkan informasi tentang manifes penyebaran baru dan modul yang ditentukannya. Anda juga dapat melihat JSON mentah.

  5. Pilih Simpan. Halaman Manifes Edge sekarang menyertakan manifes penyebaran yang diperbarui.

Mengelola perangkat IoT Edge

Saat menambahkan perangkat IoT Edge di halaman perangkat, Anda dapat memilih manifes penyebaran untuk perangkat. Dalam dialog Buat perangkat baru, Anda dapat memilih dari daftar manifes perangkat yang diunggah sebelumnya di halaman manifes Edge. Anda juga dapat menambahkan manifes penyebaran langsung ke perangkat setelah Anda membuat perangkat.

Jika Anda menambahkan perangkat IoT Edge yang tidak ditetapkan ke templat perangkat, dialog Buat perangkat baru terlihat seperti cuplikan layar berikut:

Screenshot that shows adding an unassigned device to your application.

Untuk memilih manifes penyebaran untuk perangkat:

  1. Alihkan perangkat Azure IoT Edge? ke Ya.

  2. Pilih manifes penyebaran IoT Edge untuk digunakan. Anda juga dapat memilih untuk menetapkan manifes penyebaran setelah membuat perangkat.

  3. Pilih Buat.

Jika Anda menambahkan perangkat IoT Edge yang ditetapkan ke templat perangkat, dialog Buat perangkat baru terlihat seperti cuplikan layar berikut:

Screenshot that shows adding an assigned device to your application.

Untuk memilih manifes penyebaran untuk perangkat:

  1. Pengalih perangkat Azure IoT Edge? sudah diatur ke Ya karena IoT Central mengenali bahwa Anda menggunakan templat perangkat IoT Edge.

  2. Pilih manifes penyebaran IoT Edge untuk digunakan. Anda juga dapat memilih untuk menetapkan manifes penyebaran setelah membuat perangkat.

  3. Pilih Buat.

Saat perangkat IoT Edge terhubung ke aplikasi Anda untuk pertama kalinya, perangkat mengunduh manifes penyebaran, mengonfigurasi modul yang ditentukan dalam manifes penyebaran, dan menjalankan modul.

Jika Anda tidak memilih manifes penyebaran saat membuat perangkat IoT Edge, Anda dapat menetapkannya nanti satu per satu atau ke beberapa perangkat dengan menggunakan pekerjaan.

Memperbarui manifes penyebaran yang digunakan perangkat

Anda dapat mengelola manifes penyebaran untuk perangkat yang ada:

Screenshot that shows the options to manage a deployment manifest on a device.

Gunakan Tetapkan manifes edge untuk memilih manifes penyebaran yang diunggah sebelumnya dari halaman manifes Edge. Anda juga dapat menggunakan opsi ini untuk memberi tahu perangkat secara manual jika Anda mengubah manifes penyebaran di halaman manifes Edge.

Gunakan Edit manifes untuk mengubah manifes penyebaran untuk perangkat ini. Perubahan yang Anda buat di sini tidak memengaruhi manifes penyebaran di halaman manifes Edge.

Pekerjaan

Untuk menetapkan atau memperbarui manifes penyebaran untuk beberapa perangkat, gunakan pekerjaan. Gunakan jenis pekerjaan manifes penyebaran tepi perubahan:

Screenshot that shows the deployment manifest job type.

Menambahkan modul dan properti ke templat perangkat

Manifes penyebaran menentukan modul yang akan dijalankan pada perangkat dan properti yang dapat ditulis secara opsional yang dapat Anda gunakan untuk mengonfigurasi modul.

Jika Anda menetapkan templat perangkat ke perangkat IoT Edge, Anda mungkin ingin menentukan modul dan properti bisa-tulis di templat perangkat. Untuk menambahkan modul dan definisi properti ke templat perangkat:

  1. Buka halaman Ringkasan Modul dari templat perangkat IoT Edge.
  2. Pilih Impor modul dari manifes.
  3. Pilih manifes penyebaran yang sesuai dari daftar.
  4. Pilih impor. IoT Central menambahkan modul kustom yang ditentukan dalam manifes penyebaran ke templat perangkat. Nama modul dalam templat perangkat cocok dengan nama modul kustom dalam manifes penyebaran. Antarmuka yang dihasilkan mencakup definisi properti untuk properti yang ditentukan untuk modul kustom dalam manifes penyebaran:

Screenshot the shows importing module definitions to a device template.