Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

...

Preparing for Azure Boards Integration

You need to create an OAuth Token for

...

use in FlexDeploy. This token will be entered for Azure DevOps Personal Access Token on Issue Tracking Instance.

  1. Go to Azure Boards and log in as the user you want to comment on use for FlexDeploy to Azure Boards Issues withIntegration.

  2. Generate a Personal Access Token in Azure Boards following this guide. ​

  3. Choose an expiration date based on your security policies. Shorter expiration dates will require updating the ITS more frequently.

  4. Choose the following OAuth scopes to comment on and change status of issues:

...

Create Issue Tracking Instances

An Azure Boards instance looks like this:

...

Supported Azure DevOps API Versions

...

  • 5.1-preview, 5.2-preview, 5.3-preview, 5.4-preview, 5.5-preview, 5.6-preview, 5.7-preview, 5.8-preview, 5.9-preview,

  • 6.0-preview, 6.1-preview, 6.2-preview, 6.3-preview, 6.4-preview, 6.5-preview, 6.6-preview, 6.7-preview, 6.8-preview, 6.9-preview,

  • 7.0-preview, 7.1-preview.

...

Setting Up Folders and Projects to Use the Azure Boards ITS Instance

Then back in FlexDeploy, set up the Issue Tracking settings on your folders and projects.

...

Configure Folder or Project for Issue Tracking

Configure Azure Boards Issue Tracking Instance on your project or parent folder. Issue Tracking configurations are inherited by sub-folder and projects. This configuration will allow you to integrate Azure Work Items with your builds. See Configure Project for Issue Tracking for more details.

Optionally configure for Comment and/or Status update after build or deploy execution.

...

Linking Azure Work Items with FlexDeploy Builds

Now you are ready to link tickets by commit message or by manually entering them on project builds or project packagesAzure Work Items with project builds.

Linking with Commit Messages

Set up your FlexDeploy Project with a ticket pattern. The pattern must be Azure Boards Project name + “-” + issue number.

...

When you create a build, the issue numbers are pulled from your commits.

Linking by Manual Entry at Project Build Time

Issue numbers can also be entered on the build request form to link the issue at build time.

...