Använda Azure Stream Analytics CI/CD NuGet-paketet för integrering och utveckling

  • Artikel

Den här artikeln beskriver hur du använder Azure Stream Analytics CI/CD NuGet-paketet för att konfigurera en kontinuerlig integrerings- och distributionsprocess.

Använd version 2.3.0000.0 eller senare av Stream Analytics-verktyg för Visual Studio för att få stöd för MSBuild.

Ett NuGet-paket är tillgängligt: Microsoft.Azure.Stream Analytics.CICD. Den innehåller verktygen MSBuild, lokal körning och distribution som stöder kontinuerlig integrering och distribution av Stream Analytics Visual Studio-projekt.

Kommentar

NuGet-paketet kan endast användas med versionen 2.3.000.0 eller senare av Stream Analytics Tools för Visual Studio. Om du har skapat projekt i tidigare versioner av Visual Studio-verktyg öppnar du dem med versionen 2.3.0000.0 eller senare och sparar dem. Sedan aktiveras de nya funktionerna.

Mer information finns i Stream Analytics-verktyg för Visual Studio.

MSBuild

Precis som standardupplevelsen i Visual Studio MSBuild har du två alternativ för att skapa ett projekt. Du kan högerklicka på projektet och sedan välja Skapa. Du kan också använda MSBuild i NuGet-paketet från kommandoraden.

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

När ett Stream Analytics Visual Studio-projekt skapas genererar det följande två Azure Resource Manager-mallfiler under mappen bin/[Debug/Retail]/Deploy :

  • Resource Manager-mallfil

    [ProjectName].JobTemplate.json

  • Resource Manager-parameterfil

    [ProjectName].JobTemplate.parameters.json

Standardparametrarna i parameters.json-filen kommer från inställningarna i Visual Studio-projektet. Om du vill distribuera till en annan miljö ersätter du parametrarna i enlighet med detta.

Kommentar

För alla autentiseringsuppgifter är standardvärdena inställda på null. Du måste ange värdena innan du distribuerar till molnet.

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

Läs mer om hur du distribuerar med en Resource Manager-mallfil och Azure PowerShell. Läs mer om hur du använder ett objekt som en parameter i en Resource Manager-mall.

Om du vill använda Hanterad identitet för Azure Data Lake Store Gen2 som utdatamottagare måste du ge åtkomst till tjänstens huvudnamn med hjälp av PowerShell innan du distribuerar till Azure. Läs mer om hur du distribuerar ADLS Gen2 med hanterad identitet med Resource Manager-mall.

Kommandoradsverktyget

Bygga projektet

NuGet-paketet har ett kommandoradsverktyg som heter SA.exe. Den stöder projektversion och lokal testning på en godtycklig dator, som du kan använda i din kontinuerliga integrering och kontinuerliga leveransprocess.

Distributionsfilerna placeras som standard under den aktuella katalogen. Du kan ange utdatasökvägen med hjälp av följande -OutputPath-parameter:

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

Testa skriptet lokalt

Om projektet har angett lokala indatafiler i Visual Studio kan du köra ett automatiserat skripttest med hjälp av kommandot localrun . Utdataresultatet placeras under den aktuella katalogen.

localrun -Project [ProjectFullPath]

Generera en jobbdefinitionsfil som ska användas med Stream Analytics PowerShell API

Arm-kommandot tar jobbmallen och jobbmallparameterfilerna som genereras via build som indata. Sedan kombineras de till en JSON-fil för jobbdefinition som kan användas med Stream Analytics PowerShell-API:et.

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

Exempel:

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

Nästa steg