Skip to main content

Deprecation warning component

Print a configurable warning when a component is deprecated and should no longer be used. The job exits with status 1 and is allowed to fail by default, so downstream projects see a visible warning without breaking existing pipelines.

Use it when a catalog component is renamed, replaced, or scheduled for removal.

Usage

include:
- component: $CI_SERVER_FQDN/xrow-public/ci-tools/deprecation-warning@stable
inputs:
message: "This template is deprecated. Please use the optimized $CI_SERVER_FQDN/xrow-public/ci-tools/workflow template instead."

By default, the job runs on the default branch and prints the message with the [error]: 🚨 prefix:

[error]: 🚨 This template is deprecated. Please use the optimized gitlab.com/xrow-public/ci-tools/workflow template instead.

Override prefix, rules, or stage when a component needs a different rollout policy.

Inputs

NameDescriptionDefaultType
------------
allow-failureAllow the deprecation warning job to fail without failing the pipeline.trueboolean
messageThe deprecation message to print.string
nameThe name of the deprecation warning job.warningstring
needsThe jobs that this job depends on.[]array
prefixThe prefix prepended to the deprecation message.[error]: 🚨string
rulesRules controlling when the deprecation warning job runs.[{"if":"$CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH","when":"always"}]array
stageThe stage where the deprecation warning job runs..prestring
tagsThe runners that this job depends on.[]array