Argutec Azure Repos installs statistics

Azure Repos Extension for Visual Studio Code

This extension allows you to connect to Azure DevOps Services and Team Foundation Server and provides support for Team Foundation Version Control (TFVC). It allows you to monitor your builds and manage your pull requests and work items for your TFVC or Git source repositories. The extension uses your local repository information to connect to either Azure DevOps Services or Team Foundation Server 2015 Update 2 (and later).

Here is the Walkthrough of the Azure Repos extension for Visual Studio Code video that shows many of the features of the extension.

Prerequisites

Azure DevOps Services

If you are using the extension with Azure DevOps Services, ensure you have an Azure DevOps Services organization. If you do not have one, sign up for Azure DevOps Services.

Team Foundation Server

If you are planning on using the extension with Team Foundation Server, you must be running Team Foundation Server 2015 Update 2 or later. Earlier versions of Team Foundation Server are not supported.

Clone your Git repository

With Git, the extension uses the remote origin of your repository to determine how to connect to Azure DevOps Services (or your Team Foundation Server), in most cases you will need to have a Git repository already cloned locally. If you intend on cloning an existing repository, do so before proceeding. If you do not have a Git repository cloned locally but already have an Azure DevOps Services organization (or a Team Foundation Server instance), you may create a local repository (via git init) and once you set the "origin" remote for that local repository, the extension will detect the change to the remote and attempt to contact Azure DevOps Services (or Team Foundation Server).

Create your TFVC workspace

With TFVC, the extension uses information about the current workspace to determine how to connect to Azure DevOps Services (or your Team Foundation Server). Workspaces can be created using the Visual Studio IDE, Eclipse or with the JetBrains IDEs (e.g, Android Studio, IntelliJ).

Note: At this time, you will need to have a *local* TFVC workspace already available on your local machine. More information about the difference between the two types (and how to determine which one you're using) can be found here. The issue tracking support for Server workspaces is here.

Installation

First, you will need to install Visual Studio Code 1.12.0 or later.

To install the extension with the latest version of Visual Studio Code (version 1.13.1 is the latest as of this writing), bring up the Visual Studio Code Command Palette (F1), type install and choose Extensions: Install Extensions. In the Search Extensions in Marketplace text box, type team. Find the Azure Repos extension published by *Microsoft* and click the Install button. Restart Visual Studio Code.

Authentication

Azure DevOps Services

If you are connecting to Azure DevOps Services, you will need a personal access token (PAT). With the release of v1.121.0 of the extension, you have a choice of whether you would like to create a token yourself manually and provide it when prompted, or use a new experience in which you are authenticated to Azure DevOps Services using your web browser. In the new experience, a personal access token is still created on your behalf but only after you are authenticated. The created token has *All Scopes* permissions but can be updated in your profile settings. Both tokens (manual or the new experience) are stored securely on your machine.

Manual Token Creation

Should you wish to create a personal access token yourself, go here to read how. You can also view our video on how to do the same. • Git repositories require that you create your token with the Build (read), Code (read) and Work items (read) scopes to ensure full functionality. You can also use *All Scopes*, but the minimum required scopes are those listed above. • TFVC repositories require tokens with *All Scopes*. Anything less will cause the extension to fail.

Browser-based Authentication

When using the new authentication experience, you will be prompted to copy a *device code* used to identify yourself to the authentication system. Once you accept the prompt to begin authentication, your default web browser will be opened to a login page. After supplying that device code and having it verified, you will then be prompted to authenticate with Azure DevOps Services normally (e.g., username and password, multi-factor authentication, etc.). Once you are authenticated to Azure DevOps Services, a personal access token will be created for you and the extension will be initialized normally. To see what this experience is like, view this video.

Team Foundation Server

If you are connecting to Team Foundation Server, you will only need your NTLM credentials (domain name, server name and password). It is assumed that you have the proper permissions on the TFS Server.

Details on how to connect to either Azure DevOps Services or Team Foundation Server are found in the next section.

TFVC Support

Once you have a local TFVC workspace available, you must configure the TFVC support in Visual Studio Code. You can find that information (including demo videos) in our TFVC documentation.

Open a local Repository folder

Once you have installed the extension, open either the root folder or a sub-folder of the repository. Once an Azure DevOps Services or Team Foundation Server 2015 Update 2 (or later) repository is detected by the extension, you will need to provide your credentials (if credentials weren't already found). If you are required to provide your credentials, there will be an indicator in the status bar whose message will indicate that you need to sign in.

The indicator looks like this:…

Description from the VS Code Marketplace listing.