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

  • Článek
  • 2 min ke čtení

Tento článek popisuje, jak použít balíček NuGet Azure Stream Analytics CI/CD, abyste nastavili proces průběžné integrace a nasazování.

K získání podpory pro MSBuild použijte verzi 2.3.0000.0 nebo novější z Stream Analytics nástrojů pro Visual Studio .

K dispozici je balíček NuGet: Microsoft. Azure. Stream Analytics. CICD. Poskytuje nástroje pro MSBuild, místní běh a nasazení, které podporují proces průběžné integrace a nasazování Stream Analytics projektů sady Visual Studio.

Poznámka

Balíček NuGet se dá použít jenom s 2.3.0000.0 nebo novější verzí Stream Analytics nástrojů pro Visual Studio. Pokud máte projekty vytvořené v předchozích verzích nástrojů sady Visual Studio, stačí je otevřít pomocí 2.3.0000.0 nebo novější verze a uložit. Nové funkce jsou pak povoleny.

Další informace naleznete v tématu Stream Analytics Tools for Visual Studio.

MSBuild

Podobně jako standardní prostředí Visual Studio MSBuild pro sestavení projektu máte dvě možnosti. Můžete kliknout pravým tlačítkem 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"

Po úspěšném sestavení Stream Analytics projektu sady Visual Studio vygeneruje následující dva soubory šablon Azure Resource Manager ve složce bin/[Debug/Retail]/Deploy :

  • Soubor šablony Správce prostředků

    [ProjectName].JobTemplate.json

  • Soubor parametrů Správce prostředků

    [ProjectName].JobTemplate.parameters.json

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

Poznámka

U všech přihlašovacích údajů jsou výchozí hodnoty nastavené na hodnotu null. Před nasazením do cloudu je nutné nastavit hodnoty.

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

Přečtěte si další informace o tom, jak nasadit pomocí souboru šablony Správce prostředků a Azure PowerShell. Přečtěte si další informace o použití objektu jako parametru v šabloně správce prostředků.

Pokud chcete použít spravovanou identitu pro Azure Data Lake Store Gen1 jako výstupní jímku, 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 Gen1 se správou identity pomocí šablony Správce prostředků.

Nástroj pro příkazový řádek

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

Ve výchozím nastavení jsou soubory nasazení umístěny 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í otestování skriptu

Pokud váš projekt má v aplikaci Visual Studio určené místní vstupní soubory, můžete spustit automatický test skriptu pomocí příkazu localrun . Výsledek výstupu je umístěn v rámci aktuálního adresáře.

localrun -Project [ProjectFullPath]

Generování souboru definice úlohy pro použití s rozhraním API Stream Analytics PowerShell

Příkaz ARM vezme šablonu úlohy a soubory parametrů šablony úlohy vygenerované pomocí Build jako Input. Pak je zkombinuje do souboru JSON definice úlohy, který se dá použít s rozhraním API Stream Analytics PowerShellu.

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