Skip to main content

Code Repo - Azure DevOps

Using dev.azure.com

IcePanel uses OAuth to authenticate with dev.azure.com users.

Linking an account

  1. Navigate to Code repo integrations in IcePanel by clicking Manage in the organization dropdown.

  2. Click Azure DevOps and accept the requested permissions.

  3. Choose a Azure DevOps organization that you would like to synchronize with IcePanel.

  4. You should now see your code repos in the IcePanel reality tab.

Unlinking an account

  1. Navigate to Code repo integrations in IcePanel by clicking Manage in the organization dropdown.

  2. Select the Azure DevOps tab and click Remove.

  3. Navigate to your Azure DevOps Security > Authorizations tab and revoke the authorization for IcePanel.

Using self-hosted Azure DevOps

IcePanel uses personal access tokens to authenticate with self-hosted Azure DevOps instances.

  1. Create an Azure DevOps personal access token with the code read scope.

  2. Navigate to API keys in IcePanel by clicking Manage in the organization dropdown.

  3. Create an API key with admin permissions.

  4. Run the IcePanel CLI docker image in azure-devops-sync mode with the following parameters.

docker run icepanel/cli azure-devops-sync \
--api-key $ICEPANEL_KEY \
--url https://dev.azure.com \
--token $AZURE_DEVOPS_TOKEN
--organization $AZURE_DEVOPS_ORGANIZATION

Or with environment variables.

docker run \
-e API_KEY=$ICEPANEL_KEY \
-e AZURE_DEVOPS_URL=https://dev.azure.com \
-e AZURE_DEVOPS_TOKEN=$AZURE_DEVOPS_TOKEN \
-e AZURE_DEVOPS_ORGANIZATION=$AZURE_DEVOPS_ORGANIZATION \
icepanel/cli azure-devops-sync
  1. Once the synchronization is complete you should see your code repos in the IcePanel reality tab.