Step 4: Create release definition

Like build definitions, release definitions are Azure DevOps tasks, and should probably be done by an Azure DevOps admin. As called out in the Step 3, the build definition builds your project within your git repository, and the release definitions deploys it to your BizTalk Server environment.

Before you begin

Complete Step 3 - Create the build definition.

Add the release tasks

When the build succeeds, the release definition deploys your application to your BizTalk Server.

  1. Select the Releases tab > New pipeline.

    Create a new pipeline as a release task for Azure DevOps in the Visual Studio BizTalk Server project.

  2. Select the Empty template > Apply:

    Add an empty pipeline template as a release task for Azure DevOps in the Visual Studio BizTalk Server project.

  3. Change the Environment name to Dev, or whatever you want to call it.

  4. Select Add artifact, select your project, your build definition, and select Add:

    Add an artifact to the pipeline, and choose your project and build definition for Azure DevOps in the Visual Studio BizTalk Server project.

  5. Go to the Tasks tab, add a new task:

    Add a task to the pipeline release for Azure DevOps in the Visual Studio BizTalk Server project.

  6. From the list, filter the results, select the BizTalk Server Application Deployment task > Add:

    Add a BizTalk Server application eeployment task to the pipeline release for Azure DevOps.

    If BizTalk Server Application Deployment isn't listed, then install it at Deploy BizTalk Application.

  7. Select the Deploy task.

  8. Select the Operation Name from the list. Your options:

    List of operations for BizTalk deployment task for Azure DevOps in Visual Studio.

    • Create new BizTalk Application

    • Update an existing BizTalk Application

    • Install BizTalk Server Application

  9. Configure the relevant operation parameters. See: List of deployment operations.

  10. Select the Agent phase task. Select the Default Agent queue. Save your changes.

  11. Select Release > Create release:

    Create the release for Azure DevOps in the BizTalk Server project in Visual Studio.

  12. Select Queue. Check the status by clicking the release link. If it fails, the error displays. If it succeeds, the application is added to the BizTalk Administration console.

What you did

In Azure DevOps, you created a release definition that deploys the application to BizTalk Server, which you can see in BizTalk Server Administration.

Next steps

At this step, you're done. If you prefer, you can create environmental tokens within your BizTalk XML binding file, and create variables within Azure DevOps that match the environmental tokens. See Configure environmental tokens and variables for details.