Tümleştirme ve geliştirme için Azure Stream Analytics CI/CD NuGet paketini kullanma

  • Makale

Bu makalede, sürekli tümleştirme ve dağıtım işlemi ayarlamak için Azure Stream Analytics CI/CD NuGet paketinin nasıl kullanılacağı açıklanmaktadır.

MSBuild desteği almak için Visual Studio için Stream Analytics araçlarının 2.3.0000.0 veya üzeri sürümünü kullanın.

NuGet paketi kullanılabilir: Microsoft.Azure.Stream Analytics.CICD. Stream Analytics Visual Studio projelerinin sürekli tümleştirme ve dağıtım sürecini destekleyen MSBuild, yerel çalıştırma ve dağıtım araçları sağlar.

Not

NuGet paketi yalnızca Visual Studio için Stream Analytics Araçları'nın 2.3.0000.0 veya üzeri sürümüyle kullanılabilir. Visual Studio araçlarının önceki sürümlerinde oluşturulmuş projeleriniz varsa, bunları 2.3.0000.0 veya üzeri sürümle açıp kaydetmeniz gerekir. Ardından yeni özellikler etkinleştirilir.

Daha fazla bilgi için bkz . Visual Studio için Stream Analytics araçları.

MSBuild

Standart Visual Studio MSBuild deneyiminde olduğu gibi, bir proje oluşturmak için iki seçeneğiniz vardır. Projeye sağ tıklayıp Oluştur'u seçebilirsiniz. Komut satırından NuGet paketinde MSBuild de kullanabilirsiniz.

./build/msbuild /t:build [Your Project Full Path] /p:CompilerTaskAssemblyFile=Microsoft.WindowsAzure.StreamAnalytics.Common.CompileService.dll  /p:ASATargetsFilePath="[NuGet Package Local Path]\build\StreamAnalytics.targets"

Stream Analytics Visual Studio projesi başarıyla oluşturulduğunda, aşağıdaki iki Azure Resource Manager şablon dosyasını bin/[Debug/Retail]/Deploy klasörü altında oluşturur:

  • Resource Manager şablon dosyası

    [ProjectName].JobTemplate.json

  • Resource Manager parametre dosyası

    [ProjectName].JobTemplate.parameters.json

parameters.json dosyasındaki varsayılan parametreler Visual Studio projenizdeki ayarlardan alınıyor. Başka bir ortama dağıtmak istiyorsanız, parametreleri uygun şekilde değiştirin.

Not

Tüm kimlik bilgileri için varsayılan değerler null olarak ayarlanır. Buluta dağıtmadan önce değerleri ayarlamanız gerekir.

"Input_EntryStream_sharedAccessPolicyKey": {
      "value": null
    },

Resource Manager şablon dosyası ve Azure PowerShell ile dağıtma hakkında daha fazla bilgi edinin. Resource Manager şablonunda parametre olarak nesne kullanma hakkında daha fazla bilgi edinin.

Azure Data Lake Store 2. Nesil için Yönetilen Kimlik'i çıkış havuzu olarak kullanmak için Azure'a dağıtmadan önce PowerShell kullanarak hizmet sorumlusuna Erişim sağlamanız gerekir. Resource Manager şablonuyla Yönetilen Kimlik ile ADLS 2. Nesil'i dağıtma hakkında daha fazla bilgi edinin.

Komut satırı aracı

Projeyi derleme

NuGet paketinde SA.exe adlı bir komut satırı aracı vardır. Sürekli tümleştirme ve sürekli teslim sürecinizde kullanabileceğiniz rastgele bir makinede proje derleme ve yerel testi destekler.

Dağıtım dosyaları varsayılan olarak geçerli dizinin altına yerleştirilir. Çıkış yolunu belirtmek için aşağıdaki -OutputPath parametresini kullanabilirsiniz:

./tools/SA.exe build -Project [Your Project Full Path] [-OutputPath <outputPath>]

Betiği yerel olarak test edin

Projeniz Visual Studio'da yerel giriş dosyaları belirttiyse localrun komutunu kullanarak otomatik bir betik testi çalıştırabilirsiniz. Çıkış sonucu geçerli dizinin altına yerleştirilir.

localrun -Project [ProjectFullPath]

Stream Analytics PowerShell API'si ile kullanılacak bir iş tanımı dosyası oluşturma

arm komutu, derleme aracılığıyla oluşturulan iş şablonunu ve iş şablonu parametre dosyalarını giriş olarak alır. Ardından bunları Stream Analytics PowerShell API'si ile kullanılabilecek bir iş tanımı JSON dosyasında birleştirir.

arm -JobTemplate <templateFilePath> -JobParameterFile <jobParameterFilePath> [-OutputFile <asaArmFilePath>]

Örnek:

./tools/SA.exe arm -JobTemplate "ProjectA.JobTemplate.json" -JobParameterFile "ProjectA.JobTemplate.parameters.json" -OutputFile "JobDefinition.json"

Sonraki adımlar