Azure DevOps#

ℹ️ Requires a Professional or Team plan

Microsoft Azure DevOps is an alternative to GitHub, allowing you to store files in a Git repository in the cloud. This integration allows you to create new repositories and add members directly from Anchorpoint, so you don’t need to use the Azure web interface. Make sure that every member you add to an Azure project in Anchorpoint also has an active Azure DevOps account. Check your Azure DevOps plan that it has enough seats.

Configuration#

  1. Open the Workspace Settings / Integrations and search for the Azure DevOps integration. Then click on Connect. Anchorpoint will open the web browser so you can log into Azure DevOps. You need to have an active Azure DevOps account first. If you belong to multiple organizations, Anchorpoint will ask you which organization you want to connect to the Anchorpoint workspace. Only one organization can be selected in which Anchorpoint will create projects and add members.

  2. In the next step, add your Azure DevOps credentials to Anchorpoint. With that, Anchorpoint will be able to push and pull files from a repository.

  3. Enable “Third-party application access via OAuth” in Azure DevOps under Organization Settings / Policies. This is required so that external applications like Anchorpoint can perform actions in an Azure DevOps organization.

Usage#

If the integration is active, you can create Git repositories directly from Anchorpoint. To do this, create a project in Anchorpoint and select the Git Repository option. Under Remote Settings, then select New Azure DevOps Repository. In the next step, add the members. These members will also be added to the project on Azure DevOps. All members need an active Azure DevOps account first. If you add members to your project later, they will also be added to the repositories.

Project deletion#

If you remove a project on Anchorpoint, it is not automatically removed from Azure DevOps. You have to remove it manually there.

Troubleshooting#

I am getting an access denied error#

Make sure that you have enabled “Third-party application access via OAuth”. To do that go to your Organization, click on “Organization Settings” / “Policies” and enable “Third-party application access via OAuth”.

Member does not receive an Azure DevOps invite#

If a member reports that they haven’t received an invitation to join your Azure DevOps workspace, the first step is to verify the email address you used for the invitation. Make sure it matches the one the member provided. Next, navigate to https://dev.azure.com/YOUR-ORGANIZATION/_settings/members to check if the member is listed under the “Basic” Access Level. If the member is not visible, you can invite them by clicking on “Add Members.” Make sure to set their Access Level to “Basic” to ensure they have the appropriate permissions.

Member cannot create Azure DevOps projects from Anchorpoint#

If a member is unable to create Azure DevOps projects through Anchorpoint, you’ll need to check their group permissions. Navigate to https://dev.azure.com/YOUR-ORGANIZATION/_settings/groups and click on “Project Collection Administrators,” followed by the “Members” tab. If the member is not listed here, they won’t have the necessary permissions to create DevOps projects either in Anchorpoint or directly in Azure DevOps. To resolve this, add the member to the “Project Collection Administrators” group.

Azure DevOps free member limit reached#

When attempting to invite a new member to your Anchorpoint workspace or a specific project, you may encounter an error message stating, “Cannot add member to Azure DevOps. You need to set up billing to invite more members.” This indicates that you’ve reached the free member limit for your Azure DevOps organization. To resolve this, navigate to https://dev.azure.com/YOUR-ORGANIZATION/_settings/billing and click on “Set up billing” to extend your member limit.

By following these troubleshooting steps, you can resolve common issues related to Azure DevOps integration and ensure a smoother collaboration experience within your Anchorpoint workspace.