Azure IoT Edge cihazlarına sürekli tümleştirme ve sürekli dağıtım (klasik düzenleyici)
Şunlar için geçerlidir: IoT Edge 1.4
Önemli
IoT Edge 1.5 LTS ve IoT Edge 1.4 desteklenen sürümlerdir. Önceki bir sürümdeyseniz bkz. IoT Edge’i güncelleştirme.
Azure Pipelines, Azure IoT Edge uygulamalarınızla DevOps'yu benimsemenize yardımcı olan yerleşik bir Azure IoT Edge görevi içerir. Bu makalede, klasik düzenleyiciyi kullanarak Azure IoT Edge'inize uygulamaları hızlı ve verimli bir şekilde derlemek, test etmek ve dağıtmak için Azure Pipelines'ın sürekli tümleştirme ve sürekli dağıtım özelliklerinin nasıl kullanılacağı gösterilmektedir. Alternatif olarak YAML kullanabilirsiniz.
Bu makalede, IoT Edge çözümünüz için derleme ve yayın işlem hatları oluşturmak üzere Azure Pipelines için yerleşik Azure IoT Edge görevlerini kullanmayı öğreneceksiniz. İşlem hattınıza eklenen her Azure IoT Edge görevi aşağıdaki dört eylemden birini uygular:
Eylem | Açıklama |
---|---|
Modül görüntüleri oluşturma | IoT Edge çözüm kodunuzu alır ve kapsayıcı görüntülerini oluşturur. |
Gönderme modülü görüntüleri | Modül görüntülerini belirttiğiniz kapsayıcı kayıt defterine gönderir. |
Dağıtım bildirimi oluşturma | bir deployment.template.json dosyasını ve değişkenleri alır, ardından son IoT Edge dağıtım bildirim dosyasını oluşturur. |
IoT Edge'e cihazlarına dağıtma | Bir veya daha fazla IoT Edge cihazına IoT Edge dağıtımları oluşturur. |
Aksi belirtilmediği sürece, bu makaledeki yordamlar görev parametreleri aracılığıyla kullanılabilen tüm işlevleri keşfetmez. Daha fazla bilgi edinmek için aşağıdaki kaynaklara bakın:
- Görev sürümü
- Gelişmiş - Varsa, derlenmesini istemediğiniz modülleri belirtin.
- Denetim Seçenekleri
- Ortam Değişkenleri
- Çıkış değişkenleri
Önkoşullar
Azure Repos deposu. Deponuz yoksa projenizde yeni bir Git deposu oluşturabilirsiniz. Bu makale için IoTEdgeRepo adlı bir depo oluşturduk.
İşlenip deponuza gönderilen bir IoT Edge çözümü. Bu makaleyi test etmek için yeni bir örnek çözüm oluşturmak istiyorsanız Visual Studio Code kullanarak Azure IoT Edge modülleri geliştirme başlığındaki adımları izleyin. Bu makale için, depomuzda filtermodule adlı modülün kodunu içeren IoTEdgeSolution adlı bir çözüm oluşturduk.
Bu makalede ihtiyacınız olan tek şey Visual Studio Code veya Visual Studio'da IoT Edge şablonları tarafından oluşturulan çözüm klasörüdür. Devam etmeden önce bu kodu derlemeniz, göndermeniz, dağıtmanız veya hatalarını ayıklamanız gerekmez. Bu işlemleri Azure Pipelines'da ayarlayacaksınız.
Çözümünüzün çeşitli adımlarda kullanılan deployment.template.json dosyasının yolunu bilin. Dağıtım şablonunun rolünü bilmiyorsanız bkz . Modülleri dağıtmayı ve yolları oluşturma hakkında bilgi edinin.
İpucu
Yeni bir çözüm oluşturuyorsanız önce deponuzu yerel olarak kopyalayın. Ardından, çözümü oluşturduğunuzda doğrudan depo klasöründe oluşturmayı seçebilirsiniz. Yeni dosyaları kolayca işleyebilir ve buradan gönderebilirsiniz.
Modül görüntülerini gönderebileceğiniz bir kapsayıcı kayıt defteri. Azure Container Registry veya üçüncü taraf kayıt defteri kullanabilirsiniz.
Ayrı test ve üretim dağıtım aşamalarını test için en az iki IoT Edge cihazına sahip etkin bir Azure IoT hub'ı . Linux veya Windows üzerinde IoT Edge cihazı oluşturmak için hızlı başlangıç makalelerini izleyebilirsiniz
Sürekli tümleştirme için derleme işlem hattı oluşturma
Bu bölümde yeni bir derleme işlem hattı oluşturacaksınız. İşlem hattını otomatik olarak çalışacak ve IoT Edge çözümündeki değişiklikleri iade ettiğiniz her durumda derleme günlüklerini yayımlayacak şekilde yapılandırabilirsiniz.
Azure DevOps kuruluşunuzda (
https://dev.azure.com/{your organization}
) oturum açın ve IoT Edge çözüm deponuzu içeren projeyi açın.Projenizin sol bölme menüsünde İşlem Hatları'nı seçin. Sayfanın ortasında İşlem Hattı Oluştur'u seçin. Derleme işlem hatlarınız zaten varsa sağ üstteki Yeni işlem hattı düğmesini de seçebilirsiniz.
Kodunuz nerede? sayfasının alt kısmında Klasik düzenleyiciyi kullan'ı seçin. Projenizin derleme işlem hatlarını oluşturmak için YAML kullanmak istiyorsanız YAML kılavuzuna bakın.
İşlem hattınızı oluşturmak için istemleri izleyin.
Yeni derleme işlem hattınızın kaynak bilgilerini sağlayın. Kaynak olarak Azure Repos Git'i ve ardından IoT Edge çözüm kodunuzun bulunduğu projeyi, depoyu ve dalı seçin. Ardından Devam'ı seçin.
Şablon yerine Boş iş'i seçin.
İşlem hattınız oluşturulduktan sonra işlem hattı düzenleyicisine yönlendirilirsiniz. Burada işlem hattının adını, aracı havuzunu ve aracı belirtimini değiştirebilirsiniz.
Microsoft tarafından barındırılan bir havuz veya yönettiğiniz şirket içinde barındırılan bir havuz seçebilirsiniz.
İşlem hattı açıklamanızda hedef platformunuza göre doğru aracı belirtimini seçin:
Modüllerinizi Linux kapsayıcıları için platform amd64'te derlemek istiyorsanız ubuntu-18.04'ü seçin
Modüllerinizi Windows 1809 kapsayıcıları için amd64 platformunda oluşturmak istiyorsanız Windows'da şirket içinde barındırılan aracıyı ayarlamanız gerekir.
Modüllerinizi arm32v7 platformunda veya Linux kapsayıcıları için arm64'te oluşturmak istiyorsanız, Linux'ta şirket içinde barındırılan aracıyı ayarlamanız gerekir.
İşlem hattınız, Aracı işi 1 adlı bir iş ile önceden yapılandırılmış olarak gelir. İşe dört görev eklemek için artı işaretini (+) seçin: Azure IoT Edge iki kez, Dosyaları Bir Kez Kopyala ve Derleme Yapıtlarını Bir Kez Yayımla. Her görevi arayın ve Ekle düğmesini görmek için görevin adının üzerine gelin.
Dört görevin tümü eklendiğinde Aracı işiniz aşağıdaki örnekteki gibi görünür:
Düzenlemek için ilk Azure IoT Edge görevini seçin. Bu görev, belirttiğiniz hedef platformla çözümdeki tüm modülleri oluşturur. Görevi aşağıdaki değerlerle düzenleyin:
Parametre Açıklama Görünen ad Eylem alanı değiştiğinde görünen ad otomatik olarak güncelleştirilir. Eylem Modül görüntüleri oluştur'a tıklayın. .template.json dosyası Üç noktayı (...) seçin ve IoT Edge çözümünüzü içeren depodaki deployment.template.json dosyasına gidin. Varsayılan platform Hedeflenen IoT Edge cihazınıza göre modülleriniz için uygun işletim sistemini seçin. Çıkış değişkenleri deployment.json dosyanızın oluşturduğu dosya yoluyla ilişkilendirmek için edge gibi bir başvuru adı sağlayın. Bu görev ve parametreleri hakkında daha fazla bilgi için bkz . Azure IoT Edge görevi.
Bu yapılandırmalar, modül görüntüsünü adlandırmak ve etiketlemek için dosyada
module.json
tanımlanan görüntü deposunu ve etiketini kullanır. Modül görüntüleri derleme, değişkenlerin dosyasında tanımladığınız tam değerle değiştirilmesinemodule.json
de yardımcı olur. Visual Studio veya Visual Studio Code'da, bir.env
dosyada gerçek değeri belirtirsiniz. Azure Pipelines'ta, İşlem Hattı Değişkenleri sekmesinde değeri ayarlarsınız. İşlem hattı düzenleyicisi menüsünde Değişkenler sekmesini seçin ve adı ve değeri aşağıdaki gibi yapılandırın:- ACR_ADDRESS: Azure Container Registry Oturum Açma sunucusu değeriniz. Oturum açma sunucusu değerini Azure portalındaki kapsayıcı kayıt defterinin genel bakış sayfasında bulabilirsiniz.
Projenizde başka değişkenler varsa, bu sekmede adı ve değeri belirtebilirsiniz. Derleme modülü görüntüleri yalnızca biçimdeki
${VARIABLE}
değişkenleri tanır. Dosyalarınızda**/module.json
bu biçimi kullandığınızdan emin olun.Düzenlemek için ikinci Azure IoT Edge görevini seçin. Bu görev tüm modül görüntülerini seçtiğiniz kapsayıcı kayıt defterine gönderir.
Parametre Açıklama Görünen ad Eylem alanı değiştiğinde görünen ad otomatik olarak güncelleştirilir. Eylem Modül görüntülerini gönder'i seçin. Kapsayıcı kayıt defteri türü Varsayılan türü kullanın: Azure Container Registry
.Azure aboneliği Aboneliğinizi seçin. Azure Container Registry Modül görüntülerinizi depolamak için kullandığınız kapsayıcı kayıt defteri türünü seçin. Seçtiğiniz kayıt defteri türüne bağlı olarak form değişir. Azure Container Registry'yi seçerseniz açılan listeleri kullanarak Azure aboneliğini ve kapsayıcı kayıt defterinizin adını seçin. Genel Kapsayıcı Kayıt Defteri'ni seçerseniz, kayıt defteri hizmeti bağlantısı oluşturmak için Yeni'yi seçin. .template.json dosyası Üç noktayı (...) seçin ve IoT Edge çözümünüzü içeren depodaki deployment.template.json dosyasına gidin. Varsayılan platform Hedeflenen IoT Edge cihazınıza göre modülleriniz için uygun işletim sistemini seçin. Dağıtım bildirimine kayıt defteri kimlik bilgileri ekleme Docker görüntülerini dağıtım bildirimine göndermek için kayıt defteri kimlik bilgilerini eklemek için true değerini belirtin. Bu görev ve parametreleri hakkında daha fazla bilgi için bkz . Azure IoT Edge görevi.
Modül görüntülerinizi barındırmak için birden çok kapsayıcı kayıt defteriniz varsa, bu görevi yinelemeniz, farklı kapsayıcı kayıt defteri seçmeniz ve bu özel kayıt defterine ait olmayan görüntüleri atlamak için Gelişmiş ayarlardaki Modülleri atla'yı kullanmanız gerekir.
Düzenlemek için Dosyaları Kopyala görevini seçin. Dosyaları yapıt hazırlama dizinine kopyalamak için bu görevi kullanın.
Parametre Açıklama Görünen ad Varsayılan adı kullanma veya özelleştirme Kaynak klasör Kopyalanacak dosyaların olduğu klasör. İçindekiler İki satır ekleyin: deployment.template.json
ve**/module.json
. Bu iki dosya, IoT Edge dağıtım bildirimini oluşturmak için giriş görevi görür.Hedef Klasör değişkenini $(Build.ArtifactStagingDirectory)
belirtin. Açıklama hakkında bilgi edinmek için bkz . Değişken oluşturma.Bu görev ve parametreleri hakkında daha fazla bilgi için bkz . Dosyaları kopyalama görevi.
Düzenlemek için Derleme Yapıtlarını Yayımla görevini seçin. Yolun yayın işlem hattına yayımlanabilmesi için göreve yapıt hazırlama dizin yolunu sağlayın.
Parametre Açıklama Görünen ad Varsayılan adı kullanın veya özelleştirin. Yayımlama yolu değişkenini $(Build.ArtifactStagingDirectory)
belirtin. Daha fazla bilgi edinmek için bkz . Değişken oluşturma.Yapıt adı Varsayılan adı kullanın: drop Yapıt yayımlama konumu Varsayılan konumu kullanma: Azure Pipelines Bu görev ve parametreleri hakkında daha fazla bilgi için bkz . Derleme yapıtları görevini yayımlama.
Tetikleyiciler sekmesini açın ve Sürekli tümleştirmeyi etkinleştir kutusunu işaretleyin. Kodunuzu içeren dalın eklendiğinden emin olun.
- Kaydet ve kuyruk açılan listesinden Kaydet'i seçin.
Bu işlem hattı artık deponuza yeni kod gönderdiğinizde otomatik olarak çalışacak şekilde yapılandırılmıştır. İşlem hattı yapıtlarını yayımlayarak son görev bir yayın işlem hattını tetikler. Yayın işlem hattını oluşturmak için sonraki bölüme geçin.
Sürekli dağıtım için yayın işlem hattı oluşturma
Bu bölümde, derleme işlem hattınız yapıtları bıraktığında otomatik olarak çalışacak şekilde yapılandırılmış bir yayın işlem hattı oluşturursunuz ve Azure Pipelines'da dağıtım günlüklerini gösterir.
Yeni bir işlem hattı oluşturun ve yeni bir aşama ekleyin:
Yayınlar sekmesinde İşlem Hatları'nın altında + Yeni işlem hattı'nı seçin. Ya da yayın işlem hatlarınız zaten varsa + Yeni düğmesini ve + Yeni yayın işlem hattı'nı seçin.
Şablon seçmeniz istendiğinde Boş iş ile başlamayı seçin.
Yeni yayın işlem hattınız, Aşama 1 adlı tek bir aşamayla başlatılır. Aşama 1'i geliştirme için yeniden adlandırın ve geliştirme ortamınız için sürekli dağıtım işlem hattı olarak değerlendirin. Genellikle sürekli dağıtım işlem hatlarının geliştirme, hazırlama ve üretim gibi birden çok aşaması vardır. DevOps uygulamanıza göre farklı adlar kullanabilir ve daha fazlasını oluşturabilirsiniz. Yeniden adlandırıldıktan sonra aşama ayrıntıları penceresini kapatın.
Ayrıca üstteki "Yeni yayın işlem hattı" metnini seçerek yayın işlem hattınızı yeniden adlandırabilirsiniz.
Sürümü, derleme işlem hattı tarafından yayımlanan derleme yapıtlarına bağlayın. Yapıtlar alanına ekle'ye tıklayın.
Yapıt ekle sayfasında Kaynak türü olarak Oluştur'a tıklayın. Oluşturduğunuz projeyi ve derleme işlem hattını seçin. İsterseniz Kaynak diğer adını daha açıklayıcı bir adla değiştirebilirsiniz. Ardından Ekle'yi seçin.
Yapıt tetikleyicilerini açın ve sürekli dağıtım tetikleyicisini etkinleştirmek için iki durumlu düğmeyi seçin. Artık her yeni derleme kullanılabilir olduğunda yeni bir sürüm oluşturulacaktır.
Geliştirme aşaması bir iş ve sıfır görevle önceden yapılandırılmıştır. İşlem hattı menüsünde Görevler'i ve ardından geliştirme aşamasını seçin. Aracı işini seçin ve Görünen adını Soru-Cevap olarak değiştirin. Aracı işiyle ilgili ayrıntıları yapılandırabilirsiniz, ancak dağıtım görevi platforma duyarsız olduğundan, seçilen Aracı havuzunda herhangi bir Aracı belirtimini kullanabilirsiniz.
Soru-Cevap işinde artı işaretini (+) seçerek iki görev ekleyin. Azure IoT Edge'i iki kez arayın ve ekleyin.
İlk Azure IoT Edge görevini seçin ve aşağıdaki değerlerle yapılandırın:
Parametre Açıklama Görünen ad Eylem alanı değiştiğinde görünen ad otomatik olarak güncelleştirilir. Eylem Generate deployment manifest
öğesini seçin..template.json dosyası Yolu belirtin: $(System.DefaultWorkingDirectory)/Drop/drop/deployment.template.json
. Yol, derleme işlem hattından yayımlanır.Varsayılan platform Hedeflenen IoT Edge cihazınıza göre modülleriniz için uygun işletim sistemini seçin. Çıkış yolu yolunu $(System.DefaultWorkingDirectory)/Drop/drop/configs/deployment.json
girin. Bu yol, son IoT Edge dağıtım bildirim dosyasıdır.Bu yapılandırmalar, dosyadaki modül görüntüsü URL'lerinin değiştirilmesine
deployment.template.json
yardımcı olur. Dağıtım oluştur bildirimi, değişkenlerin dosyasında tanımladığınız tam değerle değiştirilmesinedeployment.template.json
de yardımcı olur. Visual Studio/Visual Studio Code'da, bir.env
dosyadaki gerçek değeri belirtirsiniz. Azure Pipelines'da, Yayın İşlem Hattı Değişkenleri sekmesinde değeri ayarlarsınız. Değişkenler sekmesine gidin ve adı ve değeri aşağıdaki gibi yapılandırın:- ACR_ADDRESS: Azure Container Registry Oturum Açma sunucusu değeriniz. Oturum açma sunucusunu Azure portalındaki kapsayıcı kayıt defterinizin Genel Bakış sayfasından alabilirsiniz.
- ACR_PASSWORD: Azure Container Registry parolanız.
- ACR_USER: Azure Container Registry kullanıcı adınız.
Projenizde başka değişkenler varsa, bu sekmede adı ve değeri belirtebilirsiniz. Dağıtım oluştur bildirimi yalnızca flavor içindeki
${VARIABLE}
değişkenleri tanıyabilir. Dosyalarınızda*.template.json
bu aromayı kullandığınızdan emin olun."registryCredentials": { "<ACR name>": { // Your Azure Container Registry **Registry name** value "username": "${ACR_USER}", "password": "${ACR_PASSWORD}", "address": "${ACR_ADDRESS}" } }
İkinci Azure IoT Edge görevini seçin ve aşağıdaki değerlerle yapılandırın:
Parametre Açıklama Görünen ad Eylem alanı değiştiğinde görünen ad otomatik olarak güncelleştirilir. Eylem Deploy to IoT Edge devices
öğesini seçin.Dağıtım dosyası yolunu $(System.DefaultWorkingDirectory)/Drop/drop/configs/deployment.json
girin. Bu yol, IoT Edge dağıtım bildirim dosyasıdır.Azure aboneliği IoT Hub'ınızı içeren aboneliği seçin. IoT Hub adı IoT hub'ınızı seçin. Tek/birden çok cihaz seçme Yayın işlem hattının bir veya birden çok cihaza dağıtılmasını isteyip istemediğinizi seçin. Tek bir cihaza dağıtım yaparsanız IoT Edge cihaz kimliğini girin. Birden çok cihaza dağıtıyorsanız cihaz hedef koşulunu belirtin. Hedef koşul, IoT Hub'daki bir dizi IoT Edge cihazıyla eşleşecek bir filtredir. Koşul olarak cihaz etiketlerini kullanmak istiyorsanız, ilgili cihaz etiketlerinizi IoT Hub cihaz ikizi ile güncelleştirmeniz gerekir. Gelişmiş ayarlarda IoT Edge dağıtım kimliğini ve IoT Edge dağıtım önceliğini güncelleştirin. Birden çok cihaz için dağıtım oluşturma hakkında daha fazla bilgi için bkz . IoT Edge otomatik dağıtımlarını anlama. Cihaz kimliği veya hedef koşulu Önceki seçime bağlı olarak, birden çok cihaza dağıtmak için bir cihaz kimliği veya hedef koşulu belirtin. Gelişmiş IoT Edge dağıtım kimliği için belirtin $(System.TeamProject)-$(Release.EnvironmentName)
. Bu değişken, proje ve yayın adını IoT Edge dağıtım kimliğiniz ile eşler.Göreviniz genel buluta görünmeyen özel bir Docker Güvenilen Kayıt Defteri'nde bulunan bir görüntü kullanmayı içeriyorsa, görüntü doğrulamayı atlamak için
true
SKIP_MODULE_IMAGE_VALIDATION ortam değişkenini ayarlayabilirsiniz.Değişikliklerinizi yeni yayın işlem hattına kaydetmek için Kaydet'i seçin. Menüden İşlem Hattı sekmesini seçerek işlem hattı görünümüne dönün.
Not
Katmanlı dağıtımlar, Azure DevOps'taki Azure IoT Edge görevlerinde henüz desteklenmemektedir.
Ancak, dağıtımınızı katmanlı dağıtım olarak oluşturmak için Azure DevOps'ta bir Azure CLI görevi kullanabilirsiniz. Satır içi Betik değeri için az iot edge deployment create komutunu kullanabilirsiniz:
az iot edge deployment create -d {deployment_name} -n {hub_name} --content modules_content.json --layered true
Derleme ve yayın işlem hatlarıyla IoT Edge CI/CD'yi doğrulama
Derleme işini tetikleyebilmek için bir işlemeyi kaynak kod deposuna gönderebilir veya el ile tetikleyebilirsiniz. Bu bölümde, CI/CD işlem hattının çalışıp çalışmadığını test etmek için el ile tetiklersiniz. Ardından dağıtımın başarılı olduğunu doğrulayın.
Sol bölme menüsünde İşlem hatları'nı seçin ve bu makalenin başında oluşturduğunuz derleme işlem hattını açın.
Sağ üstteki İşlem hattını çalıştır düğmesini seçerek derleme işlem hattınızda bir derleme işini tetikleyebilirsiniz.
İşlem hattı çalıştırma ayarlarını gözden geçirin. Ardından Çalıştır'ı seçin.
Çalıştırmanın ilerleme durumunu izlemek için Aracı işi 1'i seçin. İşi seçerek işin çıktısının günlüklerini gözden geçirebilirsiniz.
Derleme işlem hattı başarıyla tamamlanırsa geliştirme aşamasına bir yayın tetikler. Başarılı geliştirme sürümü, IoT Edge cihazlarını hedeflemek için IoT Edge dağıtımı oluşturur.
Sürüm günlüklerini görmek için geliştirme aşaması'na tıklayın.
İşlem hattınız başarısız oluyorsa, günlüklere bakarak başlayın. İşlem hattı çalıştırma özetine gidip işi ve görevi seçerek günlükleri görüntüleyebilirsiniz. Belirli bir görev başarısız olursa, söz konusu görevin günlüklerini denetleyin. Günlükleri yapılandırma ve kullanma hakkında ayrıntılı yönergeler için bkz . İşlem hattı sorunlarını tanılamak için günlükleri gözden geçirme.
Sonraki adımlar
- Tek cihazlar için veya uygun ölçekte IoT Edge dağıtımlarını anlama bölümünde IoT Edge dağıtımını anlama
- IoT Edge modüllerini büyük ölçekte dağıtma ve izleme bölümünde dağıtım oluşturma, güncelleştirme veya silme adımlarını izleyin.