Azure DevOps

Install the Percy Azure DevOps Integration
Navigate to your Organization Settings > Integrations. Click the Install button in the Azure DevOps row.

When you click Install App, you’ll be directed to Microsoft Visual Studio for authorization.

By default, Percy will be installed with:

• read access to code, commits, and version control artifacts
• read and write access to commit status and pull request status
  Once installed, the next step is to link a Percy project to an Azure DevOps repository.

Link Percy Projects with Azure DevOps Repositories
You can manage your linked repositories by selecting Edit settings under Organization Settings > Integrations.

You can also manage an individual project’s linked repository. Head to your Project Settings and scroll to the Link a repository section.

Your repositories will automatically populate and be searchable from the drop-down when you Select a repository.

Run and review builds in Azure DevOps
Once you’ve installed the app, linked projects with repositories, and created a PR, enure to trigger visual tests in your CI server to run alongside your integration tests. This ensures that subsequent Percy builds display metadata from Azure DevOps. Percy automatically updates the pull request summary if there are visual differences waiting for review.

Clicking the status header will take you directly to the Percy build UI showing all visual differences to be reviewed. Approving a build in Percy sets the Percy status in Azure DevOps to green/successful, so that your team can see that any visual changes were reviewed and approved.