Team Services | TFS 2015 & TFS 2017
This guide covers the basics so you can get up and running using Git with code already in Team Services or Team Foundation Server. Explore our full tutorial for more information on how to use Git from Visual Studio or the command line.
If you don't have your code in a Team Services or TFS Git repo, visit our Visual Studio or command line getting started articles to learn how to create a local repo for your code and push it to Team Services.
Get your code
To get a copy of the source code, you will clone a Team Services Git repository. Cloning creates both a copy of the source code for you to work with and all the version control information so Git can manage the source code.
If you don't have a Git repository yet, you can create one using your own code and continue with the steps to commit and share your work.
- In Team Explorer, open up the Connect page by choosing Projects and My Teams then Manage Connections
- Select Manage Connections, then select Connect to Project.
- The Connect to a Project dialog will appear. Select the repo you want to clone from the list and select Clone. If you don't see your repo listed, you can filter the list
to find it or add a Team Foundation Server where the repo is hosted by selecting the Add Server link.
- Verify the location of the cloned repo on your PC and select Clone.
- Download and install Git and the Git Credential Manager for your platform.
- Open the Team Services web portal in your browser and find your Git repository.
Copy the command line instructions from the Clone pop-up.
- Navigate to the folder where you want the code stored on your local computer using the command line.
- From the command line, paste the command you copied from the command line instructions. It will look like this on the command prompt:
Commit your work
Git branches isolate your changes from other work being done in the project. The recommended Git workflow uses a new branch for every feature or fix you work on. You make commits in your local Git repository to save your changes on that branch.
- In Team Explorer, click the drop down and choose Branches. Right click the master branch and choose New Local Branch From...
Choose a descriptive branch name for your work to remind you and others what kind of work is in the branch.
- Make changes to your files in the cloned repo. From the Team Explorer Home view, you can open up Visual Studio solutions in the repo or browse the repo contents using the Show Folder View link. Git keeps track of changes made to your code both inside and outside of Visual Studio.
- When you are satisfied with the changes, save them in Git using a commit. Open up the
Changes view from Team Explorer. Stage the changes to add to your next commit by right-clicking the files and selecting Stage, add a message describing the commit, then select Commit Staged.
- Create a branch where you will work with the code and make your changes.
> git checkout -b my-featureChoose a descriptive branch name for your work to remind you and others what kind of work is in the branch. You can also use this command to start working on a branch that other team members are already working in.
- Make changes using your favorite tools on the code.
- When you're satisfied with the changes-even if you aren't ready to share the work-save them in Git using a commit.
> git commit -A -m "descriptive message"This will save your changes locally to a new commit in Git. Make sure to give the commit a short message describing your changes after the -m flag.
Share your changes
When you are ready to share your changes with the team, you push those changes so that others can reach them. You can only push changes after you add commits to a branch.
Once you push the changes, you can create a pull request to let others know you'd like to have the changes reviewed and added to the master branch of the code.
- Open up the Synchronization view in Team Explorer. You can see the outgoing commits and share them by clicking Push if you are working
with a branch that is already shared, or Publish if you are working with a newly created local branch.
- Create a pull request so that others can review your changes. Open Pull Requests in Team Explorer, and click
New Pull Request. Verify the remote branch to merge the changes into, such as
- You can review comments made in your pull request in a web browser on the Visual Studio Team Services project page. Once all changes are approved by the team, you complete the pull request through the web browser.
- Push your branch so that others can see the changes you've saved.
> git push -u origin dev
- Open up the Team Services project in the web portal and browse to your repository under the "Code" tab. Click the Create Pull Request button to
create a pull request for the branch that you pushed.
- Create the pull request, adding in team members to review and approve the code changes.
- Once the changes are approved, complete the pull request in Visual Studio Team Services. This will pull your changes from the branch into the master branch of the code.
Sync with others
To get changes from others and keep your code up to date, you pull commits made by others and merge them into your branch. Git is very good about merging multiple changes even in the same file, but sometimes you might have to resolve a merge conflict. It's a good idea to pull your branches regularly to keep them up to date with the changes from others. This makes sure that your feature branches from your main branch are using the latest version of the code.
- Open up the Sync view in Team Explorer. You can download the latest changes to the branch you are on using the "Pull" link.
- Switch to the branch where you want to download the changes others have made
> git checkout dev
- Pull in the changes made by others to your local branch.
> git pull