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
# Optionally specify whether or not to clone Git LFS objects
use-lfs: False
# 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
Configurable Warnings:
This plugin provides the following configurable warnings <https://docs.buildstream.build/master/format_project.html#configurable-warnings>:
git:unused-lfs
- There are files with Git LFS attributes but ‘use-lfs’ is not explicitly set.