Skip to content

Commit 1644a5d

Browse files
committed
Add alert box for Azure DevOps in documentation that specifies the need to disable shallow fetching
1 parent 47a9f8c commit 1644a5d

File tree

1 file changed

+8
-0
lines changed

1 file changed

+8
-0
lines changed

docs/input/docs/reference/build-servers/azure-devops.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,14 @@ either using the Command Line build step or install an extension / custom build
1414
step. The custom build step requires a one-time setup to import the GitVersion
1515
task into your TFS or Azure DevOps Pipeline instance.
1616

17+
:::{.alert .alert-danger}
18+
**Important**
19+
20+
You must disable shallow fetch, either in the pipeline settings UI or by setting `fetchDepth: 0` in your `checkout` step;
21+
without it, Azure DevOps Pipelines will perform a shallow clone, which will cause GitVersion will display an error message.
22+
See [the Azure DevOps documentation](https://learn.microsoft.com/en-us/azure/devops/pipelines/yaml-schema/steps-checkout?view=azure-pipelines#shallow-fetch) for more information.
23+
:::
24+
1725
## Executing GitVersion
1826

1927
### Using GitVersion with the MSBuild Task NuGet Package

0 commit comments

Comments
 (0)