IoT Edge modülü teknik varlıklarını hazırlama
Bu makalede, Nesnelerin İnterneti (IoT) Edge modülü teknik varlıklarınızın Azure Market yayımlanmadan önce karşılaması gereken gereksinimler açıklanmaktadır.
Başlarken
IoT Edge modülü, IoT Edge cihazında çalışan Docker uyumlu bir kapsayıcıdır.
- IoT Edge modülleri hakkında daha fazla bilgi edinmek için bkz . Azure IoT Edge modüllerini anlama.
- IoT Edge modülü geliştirmenize başlamak için bkz . Kendi IoT Edge modüllerinizi geliştirme.
Teknik gereksinimler
IoT Edge modülünüzün Azure Market sertifikalanması ve yayımlanması için aşağıdaki teknik gereksinimleri karşılaması gerekir.
Platform desteği
IoT Edge modülünüz aşağıdaki platform seçeneklerinden birini desteklemelidir:
IoT Edge tarafından desteklenen Katman 1 platformları
Modülünüz IoT Edge tarafından desteklenen tüm Katman 1 platformlarını desteklemelidir (Azure IoT Edge desteğinde kaydedildiği gibi). Daha iyi bir müşteri deneyimi sağladığından bu seçeneği öneririz. Bu ölçütleri karşılayan modüller gösterilecektir. Bu platform seçeneğini kullanan bir modül:
GitHub Manifest-tool ile oluşturulan bildirim etiketleri olan en son etiketi ve sürüm etiketini (örneğin, 1.0.1) sağlayın.
Azure IoT Edge Sertifikalı cihaz kataloğunun Yararlı bağlantılar bölümünün altında bir bağlantı eklemek için İş Ortağı Merkezi'ndekiteklif listesi sekmesini kullanın.
IoT Edge tarafından desteklenen Katman 1 platformlarının bir alt kümesi
Modülünüzün IoT Edge tarafından desteklenen Katman 1 platformlarının bir alt kümesini (en az bir) desteklemesi gerekir (Azure IoT Edge desteğinde belirtildiği gibi). Bu platform seçeneğini kullanan bir modül:
- Birden fazla platform destekleniyorsa GitHub bildirim aracıyla oluşturulan bildirim etiketleri olan en son etiketi ve sürüm etiketini (örneğin, 1.0.1) sağlayın. Bildirim etiketleri yalnızca bir platform desteklendiğinde isteğe bağlıdır.
- Azure IoT Edge Sertifikalı cihaz kataloğundan en az bir IoT Edge cihazına Yararlı bağlantılar bölümünün altında bir bağlantı eklemek için İş Ortağı Merkezi'ndekiteklif listesi sekmesini kullanın.
Cihaz boyutları
Hedeflenen IoT Edge cihazlarında IoT Edge modülü boyutlarının (CPU, RAM, depolama ve GPU gibi) aşağıdaki gereksinimleri karşılaması gerekir:
Modülün Azure IoT Edge Sertifikalı cihaz kataloğundan en az bir IoT Edge cihazıyla çalışması gerekir.
En düşük donanım gereksinimleri, teklifin açıklamasında (İş Ortağı Merkezi'ndeki teklif listesi sekmesinin altında) son paragraf olarak belgelenmelidir. İsteğe bağlı olarak, önemli ölçüde farklılık gösteriyorsa önerilen donanım gereksinimlerini de listeleyebilirsiniz. Örneğin, teklif açıklamanızın sonuna aşağıdaki bölümü ekleyin:
Bu HTML metnini kopyalayın veya düzenleme penceresinde ilgili zengin metin işlevlerini kullanın.
<p><u>Minimum hardware requirements:</u> Linux x64 and arm32 OS, 1GB of RAM, 500 Mb of storage</p>
Yapılandırma
Bir IoT Edge cihazına dağıtımı mümkün olduğunca basit hale getirmek için modülünüzün varsayılan yapılandırma ayarlarını içermesi gerekir. Bu bilgiler İş Ortağı Merkezi'ndeki planın Teknik yapılandırma sayfasında sağlanabilir. Kapsayıcı, edge Hub ve IoT Hub ile iletişimi etkinleştirmek için IoT Edge Modülü SDK'sını da içerebilir.
Varsayılan yapılandırma
IoT Edge modülleri, İş Ortağı Merkezi'ndeki planın Teknik yapılandırma sayfasında sağlanan varsayılan ayarlarla başlayabilmelidir. Aşağıdaki varsayılan ayarlar kullanılabilir:
- Varsayılan yollar
- Varsayılan modül ikizi istenen özellikleri
- Varsayılan ortam değişkenleri
- Varsayılan kapsayıcı oluşturma seçenekleri
Varsayılan değer için gerekli olan bir parametrenin anlamlı olmadığı bir senaryoda (örneğin, müşterinin sunucusunun IP adresi), varsayılan değer olarak bir parametre ekleyin. Bu değer büyük harftir ve köşeli ayraç içine alınır. Bu örnekte, aşağıdaki varsayılan ortam değişkenini ayarlarsınız:
ServerIPAddress = <MY_SERVER_IP_ADDRESS>
Yapılandırma belgeleri
IoT Edge modülünün tüm yapılandırma ayarları açıkça belgelenmelidir. Örneğin, yollarını, istenen ikizi özelliklerini, ortam değişkenlerini, createOptions vb. kullanmayı belgelemelisiniz. Belgelerinize bir bağlantı sağlamanız veya bunu teklifinizin veya plan açıklamanızın bir parçası yapmanız gerekir. Bu bilgileri İş Ortağı Merkezi'ndeki Teklif listeleme ve Plan listeleme sayfasında sağlayabilirsiniz.
Etiketler ve sürüm oluşturma
Müşterilerin kolayca bir modül dağıtabilmesi ve marketten (geliştirici senaryosunda) güncelleştirmeleri otomatik olarak alabilmesi gerekir. Ayrıca test ettikleri tam sürümü kullanabilmeli ve dondurabilmelidir (üretim senaryosunda).
Bu müşteri beklentilerini karşılamak ve markette yayımlanmak için IoT Edge modüllerinin aşağıdaki gereksinimleri karşılaması gerekir
- Desteklenen tüm platformlarda en son sürüme işaret eden bir bildirim en son etiketi ekleyin.
- Sürüm etiketlerini X.Y.Z biçiminde yapın; burada X, Y ve Z tamsayılardır.
- Desteklenen tüm platformlarda belirli bir sürüme işaret eden 1.0.1 gibi bir "sürüm" etiketi ekleyin.
- Değiştirilmemeleri gerektiğinden 1.0.1 gibi "sürüm" etiketlerini güncelleştirin.
Dekont
İsteğe bağlı olarak, sürüm oluşturma 2.0 ve 1.0 gibi "sıralı sürüm" etiketlerini içerebilir. Bu, birden çok ana sürümün paralel olarak korunmasını destekler.
Telemetri
IoT Modülü SDK'sını kullanan modüllerin telemetri amacıyla benzersiz modül tanımlayıcısını PublisherId.OfferId.SkuId olarak ayarlaması gerekir. Benzersiz tanımlayıcı, çalışan modül örneklerinin sayısını Azure Market belirlemenize yardımcı olur.
ProductInfo değerini bu tanımlayıcıya ayarlamak için IoT Modülü SDK'larından aşağıdaki yöntemlerden birini kullanın:
IoT Modülü SDK'sını kullanmayan modüller için, İş Ortağı Merkezi aracılığıyla indirme sayısı gibi daha az kesin içgörüler sağlanır.
Güvenlik
IoT Edge modülleri ayrıcalıklı modüllerden kaçınmalıdır. Bunun yerine, mümkün olduğunca konak için en az ayrıcalıklı erişimi isteyin.
Modül IoT SDK'sı
IoT Modülü SDK'sını dahil etme, sertifikasyon için bir önkoşul değildir. Ancak IoT Modülü SDK'sı dahil olmak daha iyi bir kullanıcı deneyimi sağlayabilir. Örneğin, Buluta ileti yönlendirmeyi veya göndermeyi desteklemek için.
IoT Modülü SDK'sı, çalışmakta olan modül örneği sayısıyla ilgili telemetri verilerini almak için gereklidir.
Yeniden onaylama işlemi
Aşağıdakiler gibi modüllerini etkileyen hataya neden olan bir değişiklik olduğunda iş ortaklarına bildirim gönderilir:
- IoT Edge tarafından desteklenen Katman 1 işletim sistemi/kemer destek matrisi
- IoT Modülü SDK'sı
- IoT Edge çalışma zamanı
- IoT Edge modülü sertifikasyon yönergeleri
İş ortaklarının tekliflerini İş Ortağı Merkezi'nde yeniden yayımlayarak güncelleştirmeleri ve yeniden onaylamaları gerekir.
Ayrıca, yeni görüntü etiketleri ekleme gibi güncelleştirmeler yaparsanız teklifiniz de yeniden onaylanır.
Azure Container Registry'de konak modülü
IoT Edge modülünüzü Azure Market yüklemek için önce bir Azure Container Registry'de (ACR) barındırmanız gerekir. Modül, bir bildirim etiketi tarafından başvuruda bulunılan görüntü etiketleri de dahil olmak üzere yayımlamak istediğiniz tüm etiketleri içermelidir. Daha fazla bilgi için Bkz . Azure kapsayıcı kayıt defteri oluşturma ve kapsayıcı görüntüsü gönderme.
Sonraki adımlar
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin