Get started with Git in Azure Repos

Visual Studio 2022 provides a Git version control experience by using the Git menu, Git Changes, and through context menus in Solution Explorer. Visual Studio 2019 version 16.8 also offers the Team Explorer Git user interface. For more information, see the Visual Studio 2019 - Team Explorer tab.

1. From the Git menu on the menu bar, choose Clone Repository...

   

2. In the Clone a repository window, enter the remote repo location and the folder path for the cloned repo. If you don't know the remote repo location, select Azure DevOps from Browse a repository options.

   

3. Select Clone. After you’ve cloned a Git repository, Visual Studio detects the repository and adds it to your list of Local Repositories in the Git menu.

   

Visual Studio 2019 provides a Git version control experience by using the Git menu, Git Changes, and through context menus in Solution Explorer.

1. From the Git menu on the menu bar, choose Clone Repository...

   

2. In the Clone a repository window, enter the remote repo location and the folder path for the cloned repo. If you don't know the remote repo location, select Azure DevOps from Browse a repository options.

   

3. Select Clone. After you’ve cloned a Git repository, Visual Studio detects the repository and adds it to your list of Local Repositories in the Git menu.

   

Visual Studio 2019 version 16.8 and later versions provides a Git version control experience while maintaining the Team Explorer Git user interface. You can exercise Git features from either interface interchangeably.

1. In Team Explorer, select Connect to open the Connect page, and then choose Manage Connections > Connect to Project.

   

2. In the Connect to a Project window, choose the repo you want to clone and select Clone. If you don't see your repo, select Add Azure DevOps Server to add a server that hosts a repo. You can filter the list to find your repo.

   

3. Verify the location for the cloned repo on your computer, and then select Clone.

1. Download and install Git and the Git Credential Manager for your platform.

2. Open the Azure DevOps Services web portal in your browser by going to https://<your account name>.visualstudio.com.

3. Open the Azure DevOps Services web portal in your browser by navigating to https://<your account name>.visualstudio.com and find your Git repository. Copy the clone URL from the Clone pop-up.

   

4. At the command prompt, go to the folder where you want the code stored on your local computer.

5. From the command prompt, run git clone followed by the clone URL, as shown in the following example.

    > git clone https://dev.azure.com/fabrikam-fiber/_git/FabrikamFiber
   

   Git downloads and creates your own copy of the code in a new folder for you.

1. From the Git menu on the menu bar, choose New Branch... to open the Create a new branch window.

   

2. In the Create a new branch window, enter a descriptive branch name to let others know what work the branch contains. By default, Visual Studio creates your new branch from the current branch. The Checkout branch checkbox automatically switches you to the newly created branch. Select Create.

   

3. Add a README.md file to your cloned repo. In Solution Explorer, you can browse the repo contents using Folder View or open Visual Studio solutions in the repo. Git tracks changes made both inside and outside of Visual Studio.

4. When you're satisfied with your changes, save them in Git using a commit. In the Git Changes window, enter a message that describes the changes, and then select Commit All. Commit All commits unstaged changes and skips the staging area. You can choose to stage all files before committing by selecting the stage all + (plus) button at the top of the Changes section in the Git Changes window.

   

   Select the commit information link to get further details about the commit.

   

1. From the Git menu on the menu bar, choose New Branch... to open the Create a new branch window.

   

2. In the Create a new branch window, enter a descriptive branch name to let others know what work the branch contains. By default, Visual Studio creates your new branch from the current branch. The Checkout branch checkbox automatically switches you to the newly created branch. Select Create.

   

3. Add a README.md file to your cloned repo. In Solution Explorer, you can browse the repo contents using Folder View or open Visual Studio solutions in the repo. Git tracks changes made both inside and outside of Visual Studio.

4. When you're satisfied with your changes, save them in Git using a commit. In the Git Changes window, enter a message that describes the changes, and then select Commit All. Commit All commits unstaged changes and skips the staging area. You can choose to stage all files before committing by selecting the stage all + (plus) button at the top of the Changes section in the Git Changes window.

   

   Select the commit information link to get further details about the commit.

   

1. In Team Explorer, select the Home button and choose Branches.

   

2. Right-click the default branch, often named main, and then choose New Local Branch From...

   

3. Enter a descriptive branch name to let others know what work the branch contains. Select Create Branch.

   

4. Add an README.md file to your cloned repo. From the Home view of Team Explorer, you can browse the repo contents using Show Folder View or open Visual Studio solutions in the repo. Git tracks changes made both inside and outside of Visual Studio.

5. When you're satisfied with your changes, save them in Git using a commit. Open the Changes view of Team Explorer by selecting the Home button and choosing Changes.

   

6. Enter a message that describes the commit, and then select Commit All.

   

1. Create a branch where you make your changes to the code. If you're collaborating with someone using a branch they've created, you can skip to the following git checkout step.

    > git branch ReadMeFix
   

   Choose a descriptive branch name for your work to remind you and others what kind of work is in the branch.

2. Check out your branch so you can start working in it.

    > git checkout ReadMeFix
   

   You can also use the checkout command to start working on a branch that other team members are already working in.

3. Make changes by using your favorite tools on the code.

4. When you're satisfied with the changes, even if you aren't ready to share the work, save them in Git using a commit. Your changes won't be shared until you push them, as described in the following section.

    > git commit -a -m "Descriptive message"
   

   This command saves your changes locally to a new commit in Git. Make sure to give the commit a short message that describes your changes after -m.

1. In the Git Changes window, select the up-arrow push button to push your commit.

   

   Or, you can push your changes from the Git Repository window. To open the Git Repository window, select the outgoing / incoming link in the Git Changes window.

   

   Or, you can push your changes from the Git menu on the menu bar.

   

2. Create a pull request so that others can review your changes. If you've just pushed your changes from the Git Changes window, you can select the Create a Pull Request link to open a web browser where you can create a new pull request in the Azure Repos web portal.

   

   Or, if you've just pushed your changes from the Git Repository window, you can select the Create a Pull Request link at the top of that window.

   

   Or, you can right-click any branch in the Git Repository window and select Create Pull Request.

   

When the pull request opens in the Azure Repos web portal, verify your source and destination branches. In this example, we want to merge commits from the add-readme-file branch into the main branch. Enter a title and optional description, specify any reviewers, optionally associate any work items, and then select Create.

For more information on pull requests, see the Pull request tutorial.

1. In the Git Changes window, select the up-arrow push button to push your commit.

   

   Or, you can push your changes from the Git Repository window. To open the Git Repository window, select the outgoing / incoming link in the Git Changes window.

   

   Or, you can push your changes from the Git menu on the menu bar.

   

2. Create a pull request so that others can review your changes. If you've just pushed your changes from the Git Changes window, you can select the Create a Pull Request link to open a web browser where you can create a new pull request in the Azure Repos web portal.

   

   Or, if you've just pushed your changes from the Git Repository window, you can select the Create a Pull Request link at the top of that window.

   

   Or, you can right-click any branch in the Git Repository window and select Create Pull Request.

   

When the pull request opens in the Azure Repos web portal, verify your source and destination branches. In this example, we want to merge commits from the add-readme-file branch into the main branch. Enter a title and optional description, specify any reviewers, optionally associate any work items, and then select Create.

For more information on pull requests, see the Pull request tutorial.

1. In Team Explorer, select Home and then choose Sync to open Synchronization.

   

   You can also go to the Synchronization view from Changes by choosing Sync immediately after making a commit.

   

2. In the Synchronization view, choose Push to upload your commit to the remote repo. If this is your first push to the repo, you'll see the message: The current branch does not track a remote branch..., which lets you know that your commit was pushed to a new branch on the remote repo and that future commits pushed from the current branch will be uploaded to that remote branch.

   

3. Create a pull request so that others can review your changes. Open Pull Requests in Team Explorer by selecting Home and choosing Pull Requests.

   

4. In Pull Requests, you can view pull requests opened by you, assigned to you, and you can create new pull requests. Select New Pull Request to open a web browser where you can create a new pull request in the Azure Repos web portal.

   

When the pull request opens in the Azure Repos web portal, verify your source and destination branches. In this example, we want to merge commits from the add-readme-file branch into the main branch. Enter a title and optional description, specify any reviewers, optionally associate any work items, and then select Create.

For more information on pull requests, see the Pull request tutorial.

1. Push your branch so that others can see the changes you've saved.

    > git push -u origin ReadMeFix
   

2. Open the project in the web portal and browse to your repository under the Code tab. Select Create a pull request to create a pull request for the branch that you pushed.

   

3. Verify your branches. In this example, we want to merge the commits from the ReadMeFix branch into the main branch. Enter a title and optional description, specify any reviewers, optionally associate any work items, and select Create.

   

4. Once the changes are approved, complete the pull request. A complete pull request adds your changes from the branch into the main branch of the code.

   For more information on pull requests, see the pull request tutorial.

In the Git Changes window, you can keep your local branch current with its remote counterpart by using the Fetch, Pull, Push, and Sync buttons.

From left to right in the previous screenshot, the button controls are:

• Fetch downloads remote commits that aren't in your local branch, but doesn't merge them.
• Pull performs a fetch and then merges the downloaded commits into your local branch.
• Push uploads your unpushed commits to the remote repository, which adds them to the corresponding remote branch.
• Sync performs a Pull then a Push.

You can also select Fetch, Pull, Push, and Sync from the Git menu.

In the Git Changes window, you can keep your local branch current with its remote counterpart by using the Fetch, Pull, Push, and Sync buttons.

From left to right in the previous screenshot, the button controls are:

• Fetch downloads remote commits that aren't in your local branch, but doesn't merge them.
• Pull performs a fetch and then merges the downloaded commits into your local branch.
• Push uploads your unpushed commits to the remote repository, which adds them to the corresponding remote branch.
• Sync performs a Pull then a Push.

You can also select Fetch, Pull, Push, and Sync from the Git menu.

1. In Team Explorer, select Home and choose Sync to open Synchronization.

   

2. You can download the latest changes to your branch using the Pull link. There are two Pull links, one near the top and one in the Incoming Commits section. You can use either because they both do the same thing.

   

1. Switch to the branch where you want to download the changes others have made.

    > git checkout ReadMeFix
   

   In this example, you pull changes made by others on your team to the ReadMeFix branch to your local copy of the branch.

2. Pull the changes made by others to your local branch.

    > git pull
   

   Git downloads the changes and merges them with your own changes into your local branch.