Integrating Azure Team Foundation (TFS)

Azure Team Foundation Server (TFS), newly known as Azure DevOps Server is a source code management system by Microsoft. TFS provides source code management either with Team Foundation Version Control (TFVC) or Git. Azure TFS is available on both cloud as well as on-premise platforms.

Cloud based TFS: 

Using cloud TFS, you can add four types of repositories to Embold: Private Git repositories, Open source Git repositories, Private TFVC (Team Foundation Version Control) repositories, and Open source TFVC repositories.

On-premise TFS:

Using on-premise TFS, you can add two types of repositories to Embold: TFVC based repositories and Git based repositories. The Git based repositories can be added to Embold using personal access tokens or SSH keys.

Notes:

• We support Azure TFS repository integration on Windows installer only.
• We do not support Azure TFS integration on Docker.
• Azure DevOps no longer supports alternate credentials since 2020. It is recommended to use Personal Access Tokens instead.

On Azure TFS we can add projects (or repositories) mainly of two types – Git based and TFS based. In Embold, you can add both the types (support for Embold Windows installer only).

Private Git-based repositories

1. Log in to your Azure TFS Server (newly known as AzureDevOps Server)

2. Select the required private Git based project.

3. On the left navigation pane of the welcome page, click Repos.

4. From the Repos page, click copy icon to copy the clone URL.

5. Now, go back to your Embold self-managed account and login

6. On Dashboard, go to your Projects and click Link repositories

7. On the Link Repositories popup, click Repository type as Git.

8. In the URL field, paste the URL ( Refer step 4 )

9. Enter your Azure account Username and Personal Access Token (this can be created from your Azure account > Profile > Personal Access Tokens section).

10. In the Repository Name field, enter the repository name.

11. Select the Language from the drop-down list.

12. Click Link Repository.

You have successfully added a private Git repository to Embold.

Open source Git-based repositories

Follow same steps as mentioned above for cloud based private Git repositories.

Private TFS-based repositories

1. Log in to your Azure TFS Server (newly known as AzureDevOps Server)

2. Select the required private TFVC based project.

3. On the left navigation pane of the welcome page, click Repos.

4. Now, go back to your Embold self-managed account and login

5. On Dashboard, go to your Projects and click Link repositories

6. On the Link Repositories popup, click Repository type as tfs from the drop-down list.

Note: When you select Repository type as tfs you should see inputs fields as shown in the next step below.

7. Enter URL field as shown in the below screenshot. Note that, you replace “myorg” with your actual “organization_name” under which your TFS project is created.

8. To capture Project path go to your AzureDevOps organisation and click on your project (or refer below screenshot). Move the cursor to the horizontal bar of the right pane and click to view the project path and copy it.

Note: Do not copy the dollar ($) and forward slash (/) sign that appears at the beginning of the project path.

9. Enter your Azure TFS account username (this usually should not be your email). Copy it from your profile section or find it in your personal organisation browsers URL.

10. Enter Personal Access Token – for this your need to go to your Azure TFS account > Profile icon (top-right corner) > Personal Access Tokens page to generate one. Note that, while creating your choose right organisation and provide all access.

11. Then, enter your Repository Name field, choose the language and click Link Repository.

12. You have successfully added a private TFS-based repository to Embold.

Open source TFS-based repositories

Follow same steps as mentioned above for cloud TFS-based private Git repositories.

---

On Azure TFS on-premise, we can add projects (or repositories) mainly of two types – Git based and TFS based. In Embold, you can add both the types (support for Embold Windows installer only).

Git-based repositories

There are two ways for adding Git-based repositories to Embold:
– Using Password (instead of Personal Access Token unlike Azure TFS cloud)
– Using SSH public keys

Using Passwords

1. Log in to your Azure TFS Server (newly known as AzureDevOps Server)

2. Select the required private Git based project.

8. Choose Project > GitBased > Code.

9. On the top right corner of the dashboard, click Clone.

10. Click to copy the clone URL.

11. Log in to your Embold account.

12. Choose Project > Link Repositories.

The Link Repositories popup is displayed.

13. Select Repository Type as git.

14. In the URL field, paste the clone URL.

15. In the Password field, enter your Azure TFS account password.

16. In the Repository Name field, enter the repository name.

17. Select the Language from the drop-down menu.

18. Click Link Repository.

You have successfully added a Git-based repository to Embold using username and account password.

Using SSH public keys

Following steps will help you in creating the SSH public key and adding the repositories in Embold using this key.

1. Log in to your Azure TFS Server (newly known as AzureDevOps Server)

2. On the top right corner of the dashboard, choose Account > Security to view the Security page.

3. On the left pane of the Security page, select SSH public keys.

4. The SSH public keys page is displayed, click Add.

5. On the SSH public key page, add a name for the key in the description field.

6. In the Key Data field, paste your public key.

7. Click Save.

8. Choose Project > GitBased > Code.

9. On the top right corner of the dashboard, click Clone.

10. Click on the SSH tab.

11. Click to copy the clone URL.

12. Log in to your Embold account.

13. Choose Project > Link Repositories.

14. Select Repository type as Git.

15. In the URL field, paste the clone URL.

16. Check the SSH check box to enable the SSH key field.

17. In the SSH key field, paste your private key and enter passphrase (if applicable).

18. In the Repository Name field, enter the repository name.

19. Select the Language from the drop-down menu.

20. Click Link Repository.

You have successfully added a Git repository to Embold using SSH.

Adding TFS-based on-premise repositories

1. Log in to your Azure TFS Server (newly known as AzureDevOps Server)

2. Choose Project >TFVCBased > Code.

3. Copy the URL from the Azure TFS Server Administrator Console (as shown in the screenshot below)

Note: Copy the entire URL with trailing slash and use it at step 7.

4. Log in to your Embold account.

5. Choose Project > Link Repositories.

6. On the Link Repositories popup, click Repository type as tfs from the drop-down list.

7. In the URL field, paste the URL (copied at step 3).

8. Go to your Azure TFS on-premise server and click below the menu bar to view the Project path, copy it. Note that, Do not copy the dollar ($) and forward slash (/) sign that appears at the beginning of the project path. (refer screenshot below)

9. In the Project path field, enter the Project path (copied at step 8 above).

10. In the Username and Password field, enter your Azure TFS account username and password. Note that, for Azure TFS on-premise server instead of Personal Access Token use Password.

Note: You can add machine based and domain-based credentials in the user name and password field.

11. In the Repository Name field, enter the repository name.

12. Select the Language from the drop-down menu.

13. Click Link Repository.

You have successfully added TFS-based on-premise repository to Embold using on-premise TFS.