You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/build-server-support/build-server/tfs-build-vnext.md
+9-2Lines changed: 9 additions & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
# Team Foundation Build (vNext) Setup
2
2
## Basic Usage
3
-
In Team Foundation Build (the web based build system) you can call GitVersion either using the Command Line build step or install a custom build step. The custom build step requires a one-time setup to import the GitVersion task into your TFS or VSO instance.
3
+
In Team Foundation Build (the web based build system) you can call GitVersion either using the Command Line build step or install an extension / custom build step. The custom build step requires a one-time setup to import the GitVersion task into your TFS or VSO instance.
4
4
5
5
## Executing GitVersion
6
6
### Using GitVersion with the MSBuild Task NuGet Package
@@ -17,7 +17,13 @@ See [MSBuild Task](/usage/msbuild-task) for further instructions how to use the
17
17
6. If you want to update the build number you need to send a [logging command](https://github.com/Microsoft/vso-agent-tasks/blob/master/docs/authoring/commands.md) to TFS.
18
18
19
19
### Using the custom GitVersion build step
20
-
#### Installing/updating the custom build step
20
+
#### Installing
21
+
##### Installing the extension
22
+
For Visual Studio Team Service or TFS 2015 Update 2 or higher it is recommonded to install the GitVersion extension:
23
+
1. Install the [GitVersion Extension](https://marketplace.visualstudio.com/items?itemName=gittools.gitversion).
24
+
25
+
##### Manually installing/updating the custom build step
26
+
If you run TFS 2015 RTM or Update 1 or don't want to install the GitVersion extension you can install the build task manually:
21
27
1. Install the `tfx` command line tool as shown [here](https://github.com/Microsoft/tfs-cli/blob/master/README.md#install).
22
28
2. For TFS 2015 On-Prem configure Basic Authentication in TFS as shown [here](https://github.com/Microsoft/tfs-cli/blob/master/docs/configureBasicAuth.md).
23
29
3. Download the GitVersion TFS build task from the latest release on the [GitVersion releases page](https://github.com/GitTools/GitVersion/releases) and unzip.
@@ -56,6 +62,7 @@ See [Variables](/more-info/variables/) for more info on the variables.
56
62
57
63
#### Known limitations
58
64
* If you are using on premises TFS, make sure you are using at least **TFS 2015 Update 1**, otherwise a few things will not work.
65
+
* Installing the extension on an on premise TFS requires at least TFS 2015 Update 2.
59
66
* You need to make sure that all tags are fetched for the Git repository, otherwise you may end with wrong versions (e.g. `FullSemVer` like `1.2.0+5` instead of `1.2.0` for tagged releases)
60
67
Just checking the `Clean Repository` check box in the build definition settings might not be enough since this will run a `git clean -fdx/reset --hard` without fetching all tags later.
61
68
You can force deletion of the whole folder and a re-clone containing all tags by settings the variable `Build.Clean` to `all`.
0 commit comments