Stream Analytics işi için CI/CD işlem hattı oluşturmak için Azure DevOps kullanma

Bu makalede, Azure Stream Analytics CI/CD araçlarını kullanarak Azure DevOps build ve release işlem hatları oluşturmayı öğreneceksiniz.

Stream Analytics projenizi işleme

Başlamadan önce, tüm Stream Analytics projelerinizi kaynak dosyalar olarak bir Azure DevOps deposuna işleyin. Bu örnek deposuna ve Stream Analytics proje kaynak koduna Azure Pipelines içinde referans alabilirsiniz.

Bu makaledeki adımlarda Stream Analytics Visual Studio Code projesi kullanılır. Bir Visual Studio projesi kullanıyorsanız, CI/CD araçlarını kullanarak bir Azure Stream Analytics işinin derlemelerini, testlerini ve dağıtımlarını otomatikleştirme adımlarını takip edin.

Derleme işlem hattı oluşturun

Bu bölümde kurulum işlem hattı nasıl oluşturulacağını öğrenin.

  1. Bir web tarayıcısı açın ve Azure DevOps projenize gidin.

  2. Sol gezinme menüsündeki İşlem Hatları altında Yapılar'ı seçin. Ardından Yeni işlem hattı'yı seçin.

    Derleme işlem hattı bulunamadığını gösteren Azure Pipelines Derlemeler sayfasının ekran görüntüsü ve Yeni işlem hattı düğmesi.

  3. YAML olmadan işlem hattı oluşturmak için Klasik düzenleyiciyi kullan'ı seçin.

  4. Kaynak türünüzü, takım projenizi ve deponuzu seçin. Ardından Devam'ı seçin.

    Azure Repos Git, GitHub ve diğer seçeneklerle depo, dal ve devam et düğmesinin görünür olduğu Azure Pipelines kaynak seçim sayfasının ekran görüntüsü.

  5. Şablon seçin sayfasında boş iş'i seçin.

npm paketini yükleme

  1. Görevler sayfasında Aracı işi 1'in yanındaki artı işaretini seçin. Görev aramasında npm yazın ve npm'yi seçin.

    Sağda Aracı işi 1 seçili, npm arandı ve npm görev seçeneklerinin görüntülendiği Azure Pipelines Görevler sayfasının ekran görüntüsü.

  2. Göreve bir Görüntü adı verin. Command seçeneğini özel olarak değiştirin ve Command ve arguments bölümüne aşağıdaki komutu girin. Diğer varsayılan seçenekleri değiştirmeyin.

    install -g azure-streamanalytics-cicd

    Azure Pipelines görev düzenleyicisinin npm görevi ve azure-streamanalytics-cicd paketini yüklemek için özel komut ile gösteren ekran görüntüsü.

Barındırılan bir Linux aracısı kullanmanız gerekiyorsa aşağıdaki adımları kullanın:

  1. Aracı Belirtiminizi seçin.

    Azure Pipelines Görevler sayfasının ekran görüntüsü; burada, aracı havuzu Azure Pipelines olarak ve aracı belirtimi ubuntu-16.04 olarak ayarlanmış.

  2. Görevler sayfasında Aracı işi 1'in yanındaki artı işaretini seçin. Görev aramasında komut satırı girin ve Komut satırı'nı seçin.

    Komut satırı görevi arama işleminin ekran görüntüsü.

  3. Göreve bir Görüntü adı verin. Betik bölümüne aşağıdaki komutu girin. Diğer varsayılan seçenekleri değiştirmeyin.

    sudo npm install -g azure-streamanalytics-cicd --unsafe-perm=true --allow-root

    cmd görevi için betik girme işleminin ekran görüntüsü.

Derleme görevi ekleme

  1. Değişkenler sayfasında Borulu İşlem değişkenleri kısmında + Ekle seçeneğini seçin. Aşağıdaki değişkenleri ekleyin. Tercihinize göre aşağıdaki değerleri ayarlayın:

    Değişken adı Değer
    projectRootPath [YourProjectName]
    çıktı yolu Çıktı
    deployPath Dağıtma

  2. Görevler sayfasında Aracı işi 1'in yanındaki artı işaretini seçin. Komut satırını arayın.

  3. Görev için bir Gösterilen adı verin ve aşağıdaki betiği girin. Betiği deponuzun adı ve proje adıyla değiştirin.

    Not

    build --v2 komutunu kullanarak ARM şablonunu dağıtım için oluşturmanız şiddetle tavsiye edilir. Yeni ARM şablonu, önceki sürümle aynı işlevselliği korurken daha az parametreye sahiptir.

    Eski ARM şablonu yakında kullanımdan kaldırılacak. Yalnızca kullanılarak build --v2 oluşturulan şablonlar güncelleştirmeleri ve hata düzeltmelerini alır.

    azure-streamanalytics-cicd build --v2 -project $(projectRootPath)/asaproj.json -outputpath $(projectRootPath)/$(outputPath)/$(deployPath)

    Aşağıdaki görüntüde örnek olarak bir Stream Analytics Visual Studio Code projesi kullanılır.

    Azure DevOps işlem hattı düzenleyicisinin, bir Stream Analytics Visual Studio Code projesi oluşturmak için kullanılan komut satırı görevini gösteren ekran görüntüsü.

Test görevi ekleme

  1. Değişkenler sayfasında İşlem hattı değişkenleri için + Ekle seçeneğini seçin. Aşağıdaki değişkenleri ekleyin. Değerleri çıkış yolunuz ve depo adınızla değiştirin.

    Değişken adı Değer
    testPath Test etme

    İşlem hattı değişkenlerinin ve değerlerinin listesini gösteren Azure Pipelines Değişkenleri sayfasının Ekran Görüntüsü; Ekle düğmesi görünür.

  2. Görevler sayfasında Aracı işi 1'in yanındaki artı işaretini seçin. Komut satırını arayın.

  3. Göreve bir Ekran adı verin ve aşağıdaki betiği girin. Betiği proje dosyanızın adı ve test yapılandırma dosyasının yolu ile değiştirin.

    Test çalışmalarını ekleme ve yapılandırma hakkında ayrıntılı bilgi için otomatikleştirilmiş test yönergelerine bakın.

    azure-streamanalytics-cicd test -project $(projectRootPath)/asaproj.json -outputpath $(projectRootPath)/$(outputPath)/$(testPath) -testConfigPath $(projectRootPath)/test/testConfig.json

    Azure Pipelines görev yapılandırmasının ekran görüntüsü.

Dosya kopyalama görevi ekleme

Test özet dosyasını ve Azure Resource Manager şablon dosyalarını yapıt klasörüne kopyalamak için dosya kopyalama görevi ekleyin.

  1. Görevler sayfasında 'Agent görevi 1'+ yanındaki öğeyi seçin. Dosyaları kopyala'yı arayın. Ardından aşağıdaki yapılandırmaları girin. ** 'İçindekiler' kısmına atandığında, test sonuçlarının tüm dosyaları kopyalanır.

    Parametre Giriş
    Görünen ad Dosyaları Kopyala: $(build.artifactstagingdirectory)
    Kaynak Klasör $(system.defaultworkingdirectory)/$(outputPath)/
    İçindekiler **
    Hedef Klasör $(build.artifactstagingdirectory)

  2. Denetim Seçenekleri'ni genişletin. Önceki bir görev başarısız olsa bile, derleme iptal edilmediği sürece Bu görevi çalıştır bölümünde öğesini seçin.

    Kaynak, içerik ve hedef klasör alanlarının doldurulduğu Dosya Kopyalama adımını gösteren Azure DevOps işlem hattı görev ayarlarının ekran görüntüsü.

Derleme yapıtlarını yayımla görevi ekleme

  1. Görevler sayfasında Aracı işi 1'in yanındaki artı işaretini seçin. Derleme yapıtlarını yayımla'yı arayın ve siyah ok simgesiyle seçeneği belirleyin.

  2. Denetim Seçenekleri'ni genişletin. Bu görevi çalıştır bölümünde, Önceki bir görev başarısız olsa bile, derleme iptal edilmediği sürece seçeneğini seçin.

    Denetim Seçenekleri genişletilmiş derleme yapıtları yayımlama ayarlarını gösteren Azure Pipelines görev düzenleyicisinin ekran görüntüsü.

Kaydet ve çalıştır

npm paketini eklemeyi, komut satırını, dosyaları kopyalamayı ve derleme çıktıları görevlerini yayımlamayı tamamladıktan sonra Kaydet ve sıraya al'ı seçin. İstendiğinde, bir kaydetme açıklaması girin ve Kaydet ve çalıştır'ı seçin. Test sonuçlarını işlem hattının Özet sayfasından indirebilirsiniz.

Derleme ve test sonuçlarını kontrol et

Test özet dosyasını ve Azure Resource Manager şablon dosyalarını Published klasöründe bulabilirsiniz.

El ile çalıştırma ayrıntılarını, depo bilgilerini, geçen süreyi ve yayımlanmış test sonucu bağlantısını gösteren Azure Pipelines özet sayfasının ekran görüntüsü.

Derleme ve test sonuçları için klasörler ve dosyalar içeren Yayımlanan sekmesini gösteren Azure Artifacts sayfasının ekran görüntüsü.

Azure Pipelines ile yayımlama

Bu bölümde bir sürüm işlem hattı oluşturmayı öğreneceksiniz.

Bir web tarayıcısı açın ve Azure Stream Analytics Visual Studio Code projenize gidin.

  1. Sol gezinti menüsündeki Hatlar altında Yayınlar seçin. Ardından Yeni işlem hattı'nı seçin.

  2. Boş iş ile başlat'ı seçin.

  3. Yapıtlar kutusunda + Yapıt ekle'yi seçin. Kaynak'ın altında, oluşturduğunuz derleme işlem hattını seçin ve Ekle'yi seçin.

    Azure Pipelines'da Yapıt ekle iletişim kutusunun Ekran görüntüsü: Yapıt türü seçili ve derleme işlem hattı alanları tamamlandı.

  4. 1. Aşama'nın adını İşi test ortamına dağıtacak şekilde değiştirin.

  5. Yeni bir aşama ekleyin ve adını işi üretim ortamına dağıt koyun.

Dağıtım görevlerini ekleyin

Not

Override şablonu parametreleri seçeneği, işlem parametreleri nesne olarak geçirdiğinden Azure Resource Manager v2 derlemelerine uygulanmaz. Bu sınırlamayı geçici olarak çözmek için işlem hattınıza parametre dosyasını JSON olarak okuyan ve gerekli parametre değişikliklerini yapan bir PowerShell betiği ekleyin.

PowerShell betiğini ekleme hakkında daha fazla bilgi için bkz. JSON dosyasında ConvertFrom-Json ve Update Object.

  1. Görevler açılan listesinden Deploy job to test environment seçin.

  2. + Agent job yanındakini seçin ve ARM şablonu dağıtımını arayın. Aşağıdaki parametreleri girin:

    Parametre Değer
    Görünen ad myASAProject'i dağıt
    Azure aboneliği Aboneliğinizi seçin.
    Eylem Kaynak grubu oluşturma veya güncelleştirme
    Kaynak grubu Stream Analytics işinizi içeren test kaynak grubu için bir ad seçin.
    Konum Test kaynak grubunuzun konumunu seçin.
    Şablon konumu Bağlı yapıt
    Şablon $(System.DefaultWorkingDirectory)/_azure-streamanalytics-cicd-demo-CI-Deploy/drop/myASAProject.JobTemplate.json
    Şablon parametreleri $(System.DefaultWorkingDirectory)/_azure-streamanalytics-cicd-demo-CI-Deploy/drop/myASAProject.JobTemplate.parameters.json
    Şablon parametrelerini geçersiz kılma -<arm_template_parameter> "your value". Değişkenleri kullanarak parametreleri tanımlayın.
    Dağıtım modu Artımlı

  3. Görevler açılır listesinden 'İşi üretim ortamına dağıt' seçeneğini seçin.

  4. + yanındaki simgesini seçin ve ARM dağıtım şablonu arayın. Aşağıdaki parametreleri girin:

    Parametre Değer
    Görünen ad myASAProject'i dağıt
    Azure aboneliği Aboneliğinizi seçin.
    Eylem Kaynak grubu oluşturma veya güncelleştirme
    Kaynak grubu Stream Analytics işinizi içeren üretim kaynak grubu için bir ad seçin.
    Konum Üretim kaynak grubunuzun konumunu seçin.
    Şablon konumu Bağlı yapıt
    Şablon $(System.DefaultWorkingDirectory)/_azure-streamanalytics-cicd-demo-CI-Deploy/drop/myASAProject.JobTemplate.json
    Şablon parametreleri $(System.DefaultWorkingDirectory)/_azure-streamanalytics-cicd-demo-CI-Deploy/drop/myASAProject.JobTemplate.parameters.json
    Şablon parametrelerini geçersiz kılma -<arm_template_parameter> "your value"
    Dağıtım modu Artımlı

Sürüm oluşturma

Yayın oluşturmak için sağ üst köşedeki Yayın oluştur'u seçin.

Yapıtlar, aşamalar ve Yayın oluştur düğmesinin vurgulandığı Azure Pipelines yayın işlem hattının ekran görüntüsü.

İlgili içerik

  • Last updated on