Azure IoT Edge cihazlarına sürekli tümleştirme ve sürekli dağıtım (klasik düzenleyici)

Makale
08/26/2021

Şunlar için geçerlidir: IoT Edge 1.4

Önemli

IoT Edge 1.4 desteklenen sürümdür. Ö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.

Geliştirme ve üretim için sürekli tümleştirme ve sürekli geliştirme dallarının diyagramı.

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.
1. 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.
2. Ş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ştirilmesine module.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.

Sürekli tümleştirme tetikleyicisini açmayı gösteren ekran görüntüsü.

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ştirilmesine deployment.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}"
  }
}

Değişkenler sekmesinde yayın işlem hattınızın değişkenlerini yapılandırma

İ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.

Geliştirme aşamanız için Azure IoT Edge görevleri ekleme

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.

Aracılığıyla paylaş