Tümleştirme ve geliştirme için Azure Stream Analytics CI/CD NuGet paketini kullanma
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.jsonResource 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"