Skip to main content

Server - Azure DevOps Setup

Follow the steps below to configure your IguanaX Git settings to leverage your local Azure DevOps server.

First, you need to add your local Azure DevOps server to your Settings > Git Servers list.

STEP 1: To configure a local server, add your Azure DevOps Server Address to the Git Servers list

See Git Servers to add your local Azure DevOps Server.

Go to Settings > Git. For each step, click to set your configurations.

STEP 2: Author Info - Enter a name and email to be used to label your commits

Git requires a name and email to label your commits. We recommend you use an email address recognized by Azure DevOps so you can trace your commits in it.

We also use this Author Info to help Identify your Iguana so if you have problems we can help you!

STEP 3: Git Server - Choose your local Azure DevOps server address

Select your local Azure DevOps server address from the list of Git Servers. Click Save.

STEP 4: Git Username - Enter your Azure DevOps Username

Enter your Azure DevOps Username. If you don't know what that is, you can follow the link in the Set Git Username window to navigate to your user profile.

STEP 5: Server Token - In Azure DevOps, generate a personal access token and add it as a Server Token in IguanaX

IguanaX needs to have the ability to create Git repositories on Azure DevOps. This means we need to create a personal access token with the correct permissions. Iguana will use the token to authenticate with Azure DevOps.

  1. In IguanaX, click on the link in the Set Cloud Token screen to go to your Azure DevOps User settings to create a new personal access token.

  2. In Azure DevOps, click + New Token.

  3. Provide a token name, organization access, expiration and grant the full access. When finished, click Create.

  4. Copy the generated Azure DevOps access token, paste it in your IguanaX Server Token setting and click Save. Azure DevOps will only show you this once - if you forget it you will need to generate a fresh one.

STEP 6: Key Pair SSH - Generate a public-private key pair for SSH authentication with Azure DevOps

In Key Pair SSH window, use the Generate button to have Iguana generate a private key pair for you. For more information on SSH see: How does IguanaX use SSH?

STEP 7: Server SSH - Register your public key with your Azure DevOps

Now register your public key in Azure DevOps.

  1. In IguanaX, first copy your Public Key Data generated by Iguana ,

  2. Then follow the link to navigate to your Azure DevOps User Settings to register this public key.

  3. In Azure DevOps, click + New Key.

  4. Provide a name and paste your public key. Click Add.

You can see your registered public key in your Azure DevOps User Settings > SSH public Keys (under Security).