GitVersion has a few requirements that needs to be met in order to be able to produce a version number. These requirements are enumerated below.
Repository
The local (checked out) repository, either on a developer computer or on the build server, needs to adhere to the below requirements.
Unshallow
The repository should be an
unshallow
clone. This means that the fetch-depth in GitHub
Actions should set to 0, unless the
allowshallow flag is used. Check with your
build server to see how
it can be configured appropriately.
Main branch
The repository needs to have an existing local
master or main branch.
Develop branch
For some branch strategies (such as
Git Flow), a
local develop branch needs to exist.
Configuration
If using a GitVersion.yml
configuration file, that
file should be checked out otherwise it won't be found by GitVersion
and default config will apply.
Environment
Git Branch
If it is ambigous which reference (branch or tag) is being built,
which is often the case on build servers, the
Git_Branch environment variable needs to be defined and
set to the reference being built.