Making TFS Suck Less with git-tfs

As a heavy user of the git source control  system, I find it particularly painful when having to work with TFS and its centralised model of source control. I find that the lack of local commits and decent branching significantly impacts my ability to work efficiently.

To try and alleviate some of this pain, I recently started using the git-tfs which allows you to work against a local git repository, but then push your changes up to TFS (in a similar way to how git-svn works).

To get started, I first downloaded git-tfs and placed the binaries in C:git-tfs, which I then added to my PATH.

Next, I cloned the TFS repository in to a local git repository using the quick-clone command:

git tfs quick-clone http://my-tfs-server:8080 "$/MyProject/Trunk" MyProject

This clones the latest changeset from the server and places it into a local git repository in the directory “MyProject” (note there’s also a “git tfs clone” command that will bring down the entire repository’s history, but this will take a very long time to complete on a large repository.)

Once cloned, I set up my usual set of gitignore rules (to exclude builds artefacts, test results etc) and placed them in to the .git/info/exclude file (rather than a .gitignore file) to ensure that they aren’t checked in to the TFS repository.

At this point, I can now work on the repository in the same way I’d work with any other git repository – creating branches, merging rebasing etc. One thing to note is that Visual Studio will complain that it can’t connect to the TFS server each time you open the solution and forces you to work in offline mode.

Once I’ve made any changes to the git repository and I’m ready to share them with other team members, I can collapse the commits into a single TFS changeset by using either the “git tfs checkin” command, or by using the graphical “checkintool” in order to select which files I want to commit into TFS:

git tfs checkintool

Once complete, a new TFS changeset will have been published. When other team members check in their code, I can bring it down by issuing the fetch command,  followed by performing a normal git merge or rebase to fast-forward my local branch:

git tfs fetch
git rebase tfs/default

I added an alias for performing these commands to my .gitconfig file called “tpull”. This lives inside the [alias] section:

[alias]
 tpull = !git tfs fetch && git rebase tfs/default

You can read more about git-tfs at the project homepage on github and on Matt’s blog.

Written on February 21, 2011