Použití balíčku NuGet CI/CD Azure Stream Analytics pro integraci a vývoj

  • Článek

Tento článek popisuje, jak pomocí balíčku NuGet CI/CD Azure Stream Analytics nastavit proces kontinuální integrace a nasazování.

Pokud chcete získat podporu nástroje Stream Analytics pro Visual Studio, použijte verzi 2.3.0000.0 nebo vyšší.

K dispozici je balíček NuGet: Microsoft.Azure.Stream Analytics.CICD. Poskytuje nástroje MSBuild, místní spuštění a nasazení, které podporují proces kontinuální integrace a nasazování projektů Stream Analytics sady Visual Studio.

Poznámka:

Balíček NuGet lze použít pouze s verzí 2.3.0000.0 nebo vyšší verzí Stream Analytics Tools pro Visual Studio. Pokud máte projekty vytvořené v předchozích verzích nástrojů sady Visual Studio, stačí je otevřít ve verzi 2.3.0000.0 nebo vyšší a uložit. Pak jsou nové funkce povolené.

Další informace najdete v tématu Nástroje Stream Analytics pro Visual Studio.

MSBuild

Stejně jako u standardního prostředí nástroje Visual Studio MSBuild máte k sestavení projektu dvě možnosti. Můžete kliknout pravým tlačítkem myši na projekt a pak zvolit Sestavit. Nástroj MSBuild můžete také použít v balíčku NuGet z příkazového řádku.

./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"

Když se projekt Stream Analytics sady Visual Studio úspěšně sestaví, vygeneruje následující dva soubory šablony Azure Resource Manageru ve složce bin/[Debug/Retail]/Deploy :

  • Soubor šablony Resource Manageru

    [ProjectName].JobTemplate.json

  • Soubor parametrů Resource Manageru

    [ProjectName].JobTemplate.parameters.json

Výchozí parametry v souboru parameters.json pocházejí z nastavení v projektu sady Visual Studio. Pokud chcete nasadit do jiného prostředí, nahraďte parametry odpovídajícím způsobem.

Poznámka:

Pro všechny přihlašovací údaje jsou výchozí hodnoty nastaveny na hodnotu null. Před nasazením do cloudu musíte nastavit hodnoty.

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

Přečtěte si další informace o nasazení pomocí souboru šablony Resource Manageru a Azure PowerShellu. Přečtěte si další informace o použití objektu jako parametru v šabloně Resource Manageru.

Pokud chcete jako výstupní jímku použít spravovanou identitu pro Azure Data Lake Store Gen2, musíte před nasazením do Azure poskytnout přístup k instančnímu objektu pomocí PowerShellu. Přečtěte si další informace o nasazení ADLS Gen2 se spravovanou identitou pomocí šablony Resource Manageru.

Nástroj příkazového řádku

Sestavení projektu

Balíček NuGet má nástroj příkazového řádku s názvem SA.exe. Podporuje sestavení projektu a místní testování na libovolném počítači, který můžete použít v procesu kontinuální integrace a průběžného doručování.

Soubory nasazení se ve výchozím nastavení umístí do aktuálního adresáře. Výstupní cestu můžete zadat pomocí následujícího parametru -OutputPath:

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

Místní testování skriptu

Pokud váš projekt zadal místní vstupní soubory v sadě Visual Studio, můžete spustit automatizovaný test skriptu pomocí příkazu localrun . Výsledek výstupu se umístí do aktuálního adresáře.

localrun -Project [ProjectFullPath]

Vygenerování definičního souboru úlohy pro použití s rozhraním API PowerShellu Stream Analytics

Příkaz arm vezme šablonu úlohy a soubory parametrů šablony úlohy vygenerované prostřednictvím sestavení jako vstupu. Pak je zkombinuje do souboru JSON definice úlohy, který lze použít s rozhraním API PowerShellu Stream Analytics.

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

Příklad:

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

Další kroky