On our team TeamCity server we build repositories by default using build.cmd in the repository root. This has a few advantages.

One advantage is being able to run what TeamCity runs locally. It isn’t perfect – your machine can still be different from the TeamCity build agent. But, it allows running the same commands consistently. This can greatly improve the experience of debugging works on my machine issues.

Another advantage is keeping any complex build setup in the repository. Files in repositories are versioned and follow the familiar pattern of submitting changes via pull requests.

Here’s a simple build.cmd to get started (this one is useful for Node.js, but can be adapted for your needs!):

In this case, the build will run call npm install and call npm test in order. You can modify these steps as necessary.

TeamCity

When creating a new build configuration for a project, a template can have build.cmd usage baked in. This consistency makes it faster and easier to setup a build configuration for new projects.

Summary

Team members can assume build.cmd will be ran for each TeamCity build. Having a consistent build script makes setting up new projects in TeamCity faster and easier, since executing build.cmd is included as part of a template. And, if a pull request fails to build unexpectedly a quick git clean -xdf and ./build.cmd can run what the build agent ran!

build.cmd enhances our team development experience by providing consistency.

Note: If build.cmd works locally and fails on a TeamCity build agent, this post won’t help you! :-)