Skip to content

Latest commit

 

History

History
89 lines (68 loc) · 1.84 KB

usage-examples.md

File metadata and controls

89 lines (68 loc) · 1.84 KB
Raw

Setup GitVersion Action (gitversion/setup) Usage Examples

Find out how to use the gitversion/setup action using the examples below.

The examples use version 1.1.1 of the GitVersion Execute action. It is recommended to use the latest released version in your own workflows.

Inputs

The Setup GitVersion action accepts the following inputs:

versionSpec:
  description: Required version in the form of 5.x or exact version like 5.12.0.
  required: true
  default: ''
includePrerelease:
  description: Include pre-release versions when matching a version.
  required: false
  default: false
ignoreFailedSources:
  description: Treat package source failures as warnings.
  required: false
  default: false

Usage examples

In order for the gitversion to properly work you need to clone the repository with the entire history:

steps:
  -
    name: Checkout
    uses: actions/checkout@v4
    with:
      fetch-depth: 0

Example 1

Install the latest GitVersion 5 version.

steps:
  - name: Install GitVersion
    uses: gittools/actions/gitversion/setup@v1.1.1
    with:
      versionSpec: '5.x'

Example 2

Install GitVersion 5.12.0.

steps:
  - name: Install GitVersion
    uses: gittools/actions/gitversion/setup@v1.1.1
    with:
      versionSpec: '5.12.0'

Example 3

Install the latest GitVersion 6 pre-release version. For example 6.0.0-beta.6.

steps:
  - name: Install GitVersion
    uses: gittools/actions/gitversion/setup@v1.1.1
    with:
      versionSpec: '6.x'
      includePrerelease: true

Example 4

Install the latest GitVersion 5 version even it there is a cached version matching the versionSpec.

steps:
  - name: Install GitVersion
    uses: gittools/actions/gitversion/setup@v1.1.1
    with:
      versionSpec: '5.x'
      preferLatestVersion: true