Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 16 additions & 1 deletion doc/cloudbuild.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ in MSBuild, gulp and other build scripts.
## Optional features

By specifying certain `cloudBuild` options in your `version.json` file,
you can activate features for some cloud build systems, as follows
you can activate features for some cloud build systems, as follows:

### Automatically match cloud build numbers to to your git version

Expand Down Expand Up @@ -89,6 +89,21 @@ There are many more MSBuild variables that the build will set within the build.
}
```

### Set cloud build variables from just one project

While each individual MSBuild project has its own version computed, the versions across projects are usually the same so long as you have one `version.json` file at the root of your repo. If you choose to enable setting of cloud build variables in that root version.json file, each project that builds will take a turn setting those cloud build variables. This is perhaps more work than is necessary, and when some projects compute versions differently it can lead to inconsistently defined cloud build variables, based on non-deterministic build ordering of your projects.

You can reduce log message noise and control for non-deterministic cloud build variables by *not* setting the `cloudBuild` options in your root version.json file, and instead defining one inside just *one* project directory that inherits from the base one, like this:

```json
{
"inherit": true,
"cloudBuild": {
"setVersionVariables": true
}
}
```

## CI Server specific configurations

### TeamCity
Expand Down