Bagikan melalui

Siapkan aset teknis modul IoT Edge

  • Artikel

Artikel ini menjelaskan persyaratan yang harus dipenuhi oleh aset teknis modul Edge Internet of Things (IoT) Anda sebelum dipublikasikan di Azure Marketplace.

Memulai

Modul IoT Edge adalah kontainer yang kompatibel dengan Docker yang berjalan pada perangkat IoT Edge.

Persyaratan Teknis

Modul IoT Edge Anda harus memenuhi persyaratan teknis berikut untuk disertifikasi dan diterbitkan di Azure Marketplace.

Dukungan platform

Modul IoT Edge Anda harus mendukung salah satu opsi platform berikut:

Platform Tingkat 1 yang didukung oleh IoT Edge

Modul Anda harus mendukung semua platform Tingkat 1 yang didukung oleh IoT Edge (seperti yang dicatat dalam dukungan Azure IoT Edge). Kami merekomendasikan opsi ini karena memberikan pengalaman pelanggan yang lebih baik. Modul yang memenuhi kriteria ini akan ditampilkan. Modul yang menggunakan opsi platform ini harus:

Subset platform Tingkat 1 didukung oleh IoT Edge

Modul Anda harus mendukung subset (minimal satu) platform Tingkat 1 yang didukung oleh IoT Edge (seperti yang dicatat dalam dukungan Azure IoT Edge). Modul yang menggunakan opsi platform ini harus:

  • Memberikan tag terbaru dan tag versi (misalnya, 1.0.1) yang dibuat oleh tag manifes dengan alat manifes GitHub jika lebih dari satu platform didukung. Tag manifes bersifat opsional hanya saat satu platform didukung.
  • Menggunakan tab daftar penawaran di Pusat Mitra untuk menambahkan tautan di bagian Tautan yang berguna setidaknya satu perangkat IoT Edge dari katalog perangkat Azure IoT Edge Certified.

Ini adalah gambar bagian Daftar Penawaran di dalam Pusat Mitra

Dimensi perangkat

Dimensi modul IoT Edge (seperti CPU, RAM, penyimpanan, dan GPU) pada perangkat IoT Edge target harus memenuhi persyaratan berikut:

  • Modul harus bekerja dengan setidaknya satu perangkat IoT Edge dari katalog perangkat Azure IoT Edge Certified.

  • Persyaratan minimum perangkat keras harus didokumentasikan sebagai paragraf terakhir dalam deskripsi penawaran (di tab daftar penawaran di Pusat Mitra). Secara opsional, Anda juga dapat mencantumkan persyaratan perangkat keras yang direkomendasikan jika berbeda secara signifikan. Misalnya, tambahkan bagian berikut di akhir deskripsi penawaran Anda:

Salin teks HTML ini atau gunakan fungsi teks kaya terkait di jendela pengeditan.

<p><u>Minimum hardware requirements:</u> Linux x64 and arm32 OS, 1GB of RAM, 500 Mb of storage</p>

Konfigurasi

Modul Anda harus disertai dengan pengaturan konfigurasi default untuk membuat penyebaran ke perangkat IoT Edge sesederhana mungkin. Informasi ini dapat disediakan di halaman Konfigurasi teknis untuk rancangan di Pusat Mitra. Kontainer mungkin juga menyertakan IoT Edge Module SDK untuk mengaktifkan komunikasi dengan edge Hub dan IoT Hub.

Konfigurasi default

Modul IoT Edge harus dapat dimulai dengan pengaturan default yang disediakan di halaman Konfigurasi teknis untuk rancangan di Pusat Mitra. Pengaturan berikut ini tersedia:

  • Rute default
  • Properti yang diinginkan twin modul default
  • Variabel lingkungan default
  • Opsi pembuatan kontainer default

Dalam skenario saat parameter yang diperlukan untuk nilai default tidak masuk akal (misalnya, alamat IP server pelanggan), Anda dapat menambahkan parameter sebagai nilai default. Nilai ini adalah huruf besar dan diapit dalam tanda kurung. Untuk contoh ini, Anda akan menyiapkan variabel lingkungan default berikut:

ServerIPAddress = <MY_SERVER_IP_ADDRESS>

Dokumentasi konfigurasi

Semua pengaturan konfigurasi modul IoT Edge harus didokumentasikan dengan jelas. Misalnya, Anda harus mendokumentasikan cara menggunakan rutenya, properti yang diinginkan twin, variabel lingkungan, createOptions, dan sebagainya. Anda harus memberikan tautan ke dokumentasi Anda atau menjadikannya bagian dari penawaran atau deskripsi rencana Anda. Anda dapat memberikan informasi ini di Daftar penawaran dan halaman Daftar rencana di Pusat Mitra.

Tag dan penerapan versi

Pelanggan harus dengan mudah dapat menyebarkan modul dan secara otomatis mendapatkan pembaruan dari pasar (dalam skenario pengembang). Mereka juga harus dapat menggunakan dan membekukan versi yang tepat yang telah mereka uji (dalam skenario produksi).

Untuk memenuhi harapan pelanggan ini dan diterbitkan di pasar, modul IoT Edge harus memenuhi persyaratan berikut

  • Sertakan tag terbaru manifes yang menunjuk ke versi terbaru di semua platform yang didukung.
  • Buat tag versi dalam formulir X.Y.Z, ketika X, Y, dan Z adalah bilangan bulat.
  • Sertakan tag "versi", seperti 1.0.1, yang menunjuk ke versi tertentu di semua platform yang didukung.
  • Jangan perbarui tag "versi", seperti 1.0.1, karena tidak boleh diubah.

Catatan

Secara opsional, penerapan versi dapat mencakup tag "versi bergulir", seperti 2.0 dan 1.0. Ini mendukung pemeliharaan beberapa versi utama secara paralel.

telemetri

Modul yang menggunakan SDK Modul IoT harus mengatur pengidentifikasi modul yang unik ke PublisherId.OfferId.SkuId untuk tujuan telemetri. Pengidentifikasi unik membantu Azure Marketplace mengidentifikasi jumlah instans modul yang sedang berjalan.

Gunakan salah satu metode berikut dari SDK Modul IoT untuk mengatur ProductInfo ke pengidentifikasi ini:

Untuk modul yang tidak menggunakan SDK Modul IoT, wawasan yang kurang jelas tersedia melalui Pusat Mitra, seperti jumlah unduhan.

Keamanan

Modul IoT Edge harus menghindari modul istimewa. Sebagai gantinya, minta akses yang paling tidak istimewa ke host mungkin.

Modul IoT SDK

SDK Modul IoT bukan termasuk prasyarat untuk sertifikasi. Namun, termasuk SDK Modul IoT mungkin memberikan pengalaman pengguna yang lebih baik. Misalnya, untuk mendukung perutean atau mengirim pesan ke Cloud.

SDK Modul IoT diperlukan untuk mendapatkan data telemetri tentang jumlah instans modul yang sedang berjalan.

Proses sertifikasi ulang

Mitra diberi tahu setiap kali ada perubahan yang melanggar memengaruhi modul mereka, seperti:

  • Matriks dukungan OS/arch Tingkat 1 yang didukung oleh IoT Edge
  • Modul IoT SDK
  • Runtime bahasa umum IoT Edge
  • Panduan sertifikasi modul IoT Edge

Mitra harus memperbarui dan memberikan sertifikasi ulang penawaran mereka dengan menerbitkan ulang di Pusat Mitra.

Penawaran Anda juga akan disertifikasi ulang jika Anda memperbaruinya, seperti menambahkan tag gambar baru.

Modul host di Azure Container Registry

Untuk mengunggah modul IoT Edge Anda ke Azure Marketplace, Anda harus meng-hostingnya terlebih dahulu di Azure Container Registry (ACR). Modul harus menyertakan semua tag yang ingin Anda terbitkan, termasuk tag gambar yang direferensikan oleh tag manifes. Untuk informasi lebih lanjut, lihat tutorial Membuat registri kontainer Azure dan mendorong gambar kontainer.

Konten terkait