Vytvoření kanálu CI/CD pro úlohu Stream Analytics pomocí Azure DevOps

V tomto článku se dozvíte, jak vytvořit kanály buildu a verze Azure DevOps pomocí nástrojů CI/CD azure Stream Analytics.

Potvrzení projektu Stream Analytics

Než začnete, potvrďte dokončené projekty Stream Analytics jako zdrojové soubory do úložiště Azure DevOps . Na toto ukázkové úložiště a zdrojový kód projektu Stream Analytics můžete odkazovat ve službě Azure Pipelines.

Kroky v tomto článku používají projekt Stream Analytics Visual Studio Code. Pokud používáte projekt sady Visual Studio, postupujte podle kroků v tématu Automatizace sestavení, testů a nasazení úlohy Azure Stream Analytics pomocí nástrojů CI/CD.

Vytvoření kanálu buildu

V této části se dozvíte, jak vytvořit kanál buildu.

1. Otevřete webový prohlížeč a přejděte do projektu v Azure DevOps.

2. V části Kanály v levé navigační nabídce vyberte Builds (Builds). Pak vyberte Nový kanál.

   

3. Vyberte Použít klasický editor k vytvoření kanálu bez YAML.

4. Vyberte typ zdroje, týmový projekt a úložiště. Pak vyberte Pokračovat.

   

5. Na stránce Zvolit šablonu vyberte Prázdnou úlohu.

Instalace balíčku npm

1. Na stránce Úkoly vyberte znaménko plus vedle úlohy agenta 1. Do hledání úkolů zadejte npm a vyberte npm.

   

2. Dejte úkolu zobrazovaný název. Změňte možnost Příkaz na vlastní a do argumentů zadejte následující příkaz. Ponechte zbývající výchozí možnosti.

   install -g azure-streamanalytics-cicd
   

   

Pokud potřebujete použít agenta hostovaného Linuxu, postupujte následovně:

1. Vyberte specifikaci agenta .

   

2. Na stránce Úkoly vyberte znaménko plus vedle úlohy agenta 1. Do hledání úkolů zadejte příkazový řádek a vyberte Příkazový řádek.

   

3. Dejte úkolu zobrazovaný název. Do skriptu zadejte následující příkaz. Ponechte zbývající výchozí možnosti.

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

   

Přidání úlohy sestavení

1. Na stránce Proměnné vyberte + Přidat v proměnných kanálu. Přidejte následující proměnné. Nastavte následující hodnoty podle vašich preferencí:

   Název proměnné	Hodnota
   projectRootPath	[Název_projektu]
   outputPath	Výstup
   deployPath	Nasadit

2. Na stránce Úkoly vyberte znaménko plus vedle úlohy agenta 1. Vyhledejte příkazový řádek.

3. Zadejte zobrazovaný název úkolu a zadejte následující skript. Upravte skript názvem úložiště a názvem projektu.

   Poznámka:

   Důrazně doporučujeme použít build --v2 k vygenerování šablony ARM pro nasazení. Nová šablona ARM má méně parametrů a přitom zachovává stejné funkce jako předchozí verze.

   Upozorňujeme, že starší šablona ARM bude brzy zastaralá. Aktualizace a opravy chyb obdrží pouze šablony vytvořené pomocí build --v2 .

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

   Obrázek používá jako příklad projekt Stream Analytics Visual Studio Code.

   

Přidání testovací úlohy

1. Na stránce Proměnné vyberte + Přidat v proměnných kanálu. Přidejte následující proměnné. Upravte hodnoty pomocí výstupní cesty a názvu úložiště.

   Název proměnné	Hodnota
   testPath	Test

   

2. Na stránce Úkoly vyberte znaménko plus vedle úlohy agenta 1. Vyhledejte příkazový řádek.

3. Zadejte zobrazovaný název úkolu a zadejte následující skript. Upravte skript s názvem souboru projektu a cestou k testovacímu konfiguračnímu souboru.

   Podrobnosti o tom, jak přidat a nakonfigurovat testovací případy, najdete v pokynech k automatizovanému testování.

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

   

Přidání úlohy Kopírování souborů

Potřebujete přidat úlohu kopírování souboru pro zkopírování souboru souhrnu testu a souborů šablon Azure Resource Manageru do složky artefaktů.

1. Na stránce Úkoly vyberte + vedle úlohy agenta 1. Vyhledejte kopírovat soubory. Pak zadejte následující konfigurace. ** Přiřazením k obsahu se zkopírují všechny soubory výsledků testu.

   Parametr	Vstup
   Zobrazované jméno	Kopírovat soubory do: $(build.artifactstagingdirectory)
   Zdrojová složka	$(system.defaultworkingdirectory)/$(outputPath)/
   Obsah	**
   Cílová složka	$(build.artifactstagingdirectory)

2. Rozbalit možnosti ovládacího prvku Vyberte Možnost I v případě, že předchozí úloha selhala, pokud se sestavení nezrušilo při spuštění této úlohy.

   

Přidání úlohy publikování artefaktů sestavení

1. Na stránce Úkoly vyberte znaménko plus vedle úlohy agenta 1. Vyhledejte artefakty sestavení Publikovat a vyberte možnost s ikonou černé šipky.

2. Rozbalit možnosti ovládacího prvku Vyberte Možnost I v případě, že předchozí úloha selhala, pokud se sestavení nezrušilo při spuštění této úlohy.

   

Uložte a spusťte přístupový bod služby.

Jakmile dokončíte přidání balíčku npm, příkazového řádku, kopírování souborů a publikování úloh artefaktů sestavení, vyberte Uložit a frontu. Po zobrazení výzvy zadejte uložit komentář a vyberte Uložit a spustit. Výsledky testování si můžete stáhnout ze stránky Souhrn kanálu.

Kontrola výsledků sestavení a testů

Soubor souhrnu testů a soubory šablon Azure Resource Manageru najdete ve složce Publikované .

Vydání se službou Azure Pipelines

V této části se dozvíte, jak vytvořit kanál verze.

Otevřete webový prohlížeč a přejděte do projektu Azure Stream Analytics Visual Studio Code.

1. V části Kanály v levé navigační nabídce vyberte Vydané verze. Pak vyberte Nový kanál.

2. Vyberte začít s prázdnou úlohou.

3. V poli Artefakty vyberte + Přidat artefakt. V části Zdroj vyberte kanál buildu, který jste vytvořili, a vyberte Přidat.

   

4. Změňte název fáze 1 a nasaďte úlohu do testovacího prostředí.

5. Přidejte novou fázi a pojmenujte ji Nasazení úlohy do produkčního prostředí.

Přidání úloh nasazení

Poznámka:

Neplatí Override template parameters pro sestavení ARM v2, protože parametry se předávají jako objekty. Pokud chcete tento postup vyřešit, doporučujeme do kanálu zahrnout skript PowerShellu pro čtení souboru parametrů jako JSON a provedení nezbytných úprav parametrů.

Další pokyny k přidání skriptu PowerShellu najdete v tématu ConvertFrom-Json a Aktualizace objektu v souboru JSON.

1. V rozevíracím seznamu úkolů vyberte Nasadit úlohu do testovacího prostředí.

2. + Vyberte vedle úlohy agenta a vyhledejte nasazení šablony ARM. Zadejte následující parametry:

   Parametr	Hodnota
   Zobrazované jméno	Nasazení projektu myASAProject
   Předplatné Azure	Zvolte vaše předplatné.
   Akce	Vytvoření nebo aktualizace skupiny prostředků
   Skupina prostředků	Zvolte název testovací skupiny prostředků, která bude obsahovat vaši úlohu Stream Analytics.
   Umístění	Zvolte umístění testovací skupiny prostředků.
   Umístění šablony	Propojený artefakt
   Šablona	$(System.DefaultWorkingDirectory)/_azure-streamanalytics-cicd-demo-CI-Deploy/drop/myASAProject.JobTemplate.json
   Parametry šablony	$(System.DefaultWorkingDirectory)/_azure-streamanalytics-cicd-demo-CI-Deploy/drop/myASAProject.JobTemplate.parameters.json
   Přepsání parametrů šablony	-<arm_template_parameter> "your value". Parametry můžete definovat pomocí proměnných.
   Režim nasazení	Přírůstkový

3. V rozevíracím seznamu úkolů vyberte Nasadit úlohu do produkčního prostředí.

4. + Vyberte vedle úlohy agenta a vyhledejte nasazení šablony ARM. Zadejte následující parametry:

   Parametr	Hodnota
   Zobrazované jméno	Nasazení projektu myASAProject
   Předplatné Azure	Zvolte vaše předplatné.
   Akce	Vytvoření nebo aktualizace skupiny prostředků
   Skupina prostředků	Zvolte název produkční skupiny prostředků, která bude obsahovat vaši úlohu Stream Analytics.
   Umístění	Zvolte umístění produkční skupiny prostředků.
   Umístění šablony	Propojený artefakt
   Šablona	$(System.DefaultWorkingDirectory)/_azure-streamanalytics-cicd-demo-CI-Deploy/drop/myASAProject.JobTemplate.json
   Parametry šablony	$(System.DefaultWorkingDirectory)/_azure-streamanalytics-cicd-demo-CI-Deploy/drop/myASAProject.JobTemplate.parameters.json
   Přepsání parametrů šablony	-<arm_template_parameter> "your value"
   Režim nasazení	Přírůstkový

Vytvoření verze

Pokud chcete vytvořit verzi, vyberte v pravém horním rohu možnost Vytvořit verzi .

Související obsah

• Průběžná integrace a průběžné nasazování pro Azure Stream Analytics
• Automatizace sestavení, testování a nasazení úlohy Azure Stream Analytics pomocí nástrojů CI/CD