Tutorial: Deploy an Azure Stream Analytics job with CI/CD using Azure Pipelines
This tutorial describes how to set up continuous integration and deployment for an Azure Stream Analytics job using Azure Pipelines.
In this tutorial, you learn how to:
- Add source control to your project
- Create a build pipeline in Azure Pipelines
- Create a release pipeline in Azure Pipelines
- Automatically deploy and upgrade an application
Before you start, make sure you have the following:
- If you don't have an Azure subscription, create a free account.
- Install Visual Studio and the Azure development or Data Storage and Processing workloads.
- Create a Stream Analytics project in Visual Studio.
- Create an Azure DevOps organization.
Configure NuGet package dependency
In order to do auto build and auto deployment on an arbitrary machine, you need to use the NuGet package
Microsoft.Azure.StreamAnalytics.CICD. It provides the MSBuild, local run, and deployment tools that support the continuous integration and deployment process of Stream Analytics Visual Studio projects. For more information, see Stream Analytics CI/CD tools.
Add packages.config to your project directory.
<?xml version="1.0" encoding="utf-8"?> <packages> <package id="Microsoft.Azure.StreamAnalytics.CICD" version="1.0.0" targetFramework="net452" /> </packages>
Share your Visual Studio solution to a new Azure Repos Git repo
Share your application source files to a project in Azure DevOps so you can generate builds.
Create a new local Git repo for your project by selecting Add to Source Control, then Git on the status bar in the lower right-hand corner of Visual Studio.
In the Synchronization view in Team Explorer, select the Publish Git Repo button under Push to Azure DevOps Services.
Verify your email and select your organization in the Azure DevOps Services Domain drop-down. Enter your repository name and select Publish repository.
Publishing the repo creates a new project in your organization with the same name as the local repo. To create the repo in an existing project, click Advanced next to Repository name, and select a project. You can view your code in the browser by selecting See it on the web.
Configure continuous delivery with Azure DevOps
An Azure Pipelines build pipeline describes a workflow comprised of build steps that are executed sequentially. Learn more about Azure Pipelines build pipelines.
An Azure Pipelines release pipeline describes a workflow that deploys an application package to a cluster. When used together, the build pipeline and release pipeline execute the entire workflow starting with source files and ending with a running application in your cluster. Learn more about Azure Pipelines release pipelines.
Create a build pipeline
Open a web browser and navigate to the project you just created in Azure DevOps.
Under the Build & Release tab, select Builds, and then +New. Select Azure DevOps Services Git and Continue.
In Select a template, click Empty Process to start with an empty pipeline.
Under Triggers, enable continuous integration by checking Enable continuous integration trigger status. Select Save and queue to manually start a build.
Builds are also triggered upon push or check-in. To check your build progress, switch to the Builds tab. Once you verify that the build executes successfully, you must define a release pipeline that deploys your application to a cluster. Right click on the ellipses next to your build pipeline and select Edit.
In Tasks, enter "Hosted" as the Agent queue.
In Phase 1, click + and add a NuGet task.
Expand Advanced and add
$(Build.SourcesDirectory)\packagesto Destination directory. Keep the remaining default NuGet configuration values.
In Phase 1, click + and add a MSBuild task.
Change the MSBuild Arguments to the following:
In Phase 1, click + and add an Azure Resource Group Deployment task.
Expand Azure Details and fill out the configuration with the following:
Setting Suggested value Subscription Choose your subscription. Action Create or update resource group Resource Group Enter a resource group name. Template [Your solution path]\bin\Debug\Deploy\[Your project name].JobTemplate.json Template parameters [Your solution path]\bin\Debug\Deploy\[Your project name].JobTemplate.parameters.json Override template parameters Type the template parameters to override in the textbox. Example, –storageName fabrikam –adminUsername $(vmusername) -adminPassword $(password) –azureKeyVaultName $(fabrikamFibre). This property is optional, but your build will result in errors if key parameters are not overridden.
Click Save & Queue to test the build pipeline.
Failed build process
You may receive errors for null deployment parameters if you did not override template parameters in the Azure Resource Group Deployment task of your build pipeline. Return to the build pipeline and override the null parameters to resolve the error.
Commit and push changes to trigger a release
Verify that the continuous integration pipeline is functioning by checking in some code changes to Azure DevOps.
As you write your code, your changes are automatically tracked by Visual Studio. Commit changes to your local Git repository by selecting the pending changes icon from the status bar in the bottom right.
On the Changes view in Team Explorer, add a message describing your update and commit your changes.
Select the unpublished changes status bar icon or the Sync view in Team Explorer. Select Push to update your code in Azure DevOps.
Pushing the changes to Azure DevOps Services automatically triggers a build. When the build pipeline successfully completes, a release is automatically created and starts updating the job on the cluster.
Clean up resources
When no longer needed, delete the resource group, the streaming job, and all related resources. Deleting the job avoids billing the streaming units consumed by the job. If you're planning to use the job in future, you can stop it and re-start it later when you need. If you are not going to continue to use this job, delete all resources created by this tutorial by using the following steps:
- From the left-hand menu in the Azure portal, click Resource groups and then click the name of the resource you created.
- On your resource group page, click Delete, type the name of the resource to delete in the text box, and then click Delete.
To learn more about using Azure Stream Analytics tools for Visual Studio to set up a continuous integration and deployment process, continue to the set up CI/CD pipeline article: