git_tag plugin

git-tag - extension of BuildStream git plugin to track latest tag

Host dependencies

  • git

Usage:

# Specify the git_tag source kind
kind: git_tag

# Optionally specify a relative staging directory
# directory: path/to/stage

# Specify the repository url, using an alias defined
# in your project configuration is recommended
url: upstream:foo.git

# Optionally specify a symbolic tracking branch or tag, this
# will be used to update the 'ref' when refreshing the pipeline.
track: master

# Optionally specify an additional list of symbolic tracking branches,
# this will be used to update the 'ref' when refreshing the pipeline
# n.b. Tracks to the latest overall commit on any of the branches
track-extra:
- foo
- bar

# Optionally specify to track the latest tag of a branch,
# rather than the latest commit when updating 'ref'.
# If not set, this will default to 'False'
track-tags: False

# Optionally match the tracked tag to a list of glob patterns
# NOTE: This does nothing if the 'track-tags' attribute is
# not set to True
match:

# Optionally exclude a list of glob patterns from tracked tags
# NOTE: This does nothing if the 'track-tags' attribute is
# not set to True
exclude:

# Specify the commit ref, this must be specified in order to
# checkout sources and build, but can be automatically updated
# if the 'track' attribute was specified.
ref: d63cbb6fdc0bbdadc4a1b92284826a6d63a7ebcd

# Optionally specify whether submodules should be checked-out.
# If not set, this will default to 'True'
checkout-submodules: True

# If your repository has submodules, explicitly specifying the
# url from which they are to be fetched allows you to easily
# rebuild the same sources from a different location. This is
# especially handy when used with project defined aliases which
# can be redefined at a later time.
# You may also explicitly specify whether to check out this
# submodule. If checkout is set, it will override
# 'checkout-submodules' with the value set below.
submodules:
  plugins/bar:
    url: upstream:bar.git
    checkout: True
  plugins/baz:
    url: upstream:baz.git
    checkout: False

# Fetch a full clone instead of a shallow clone.
full-clone: False