Validate

Learn how to validate a Vela pipeline.

Command

$ vela validate pipeline <parameters...> <arguments...>

Parameters

The following parameters are used to configure the command:

NameDescriptionEnvironment Variables
filename of the file for the pipelineVELA_FILE, PIPELINE_FILE
pathpath to the file for the pipelineVELA_PATH, PIPELINE_PATH
refrepository reference for the pipelineVELA_REF, PIPELINE_REF
templateenables templates to be included in pipeline validationVELA_TEMPLATE, PIPELINE_TEMPLATE
template-fileenables using a local template file for expansionVELA_TEMPLATE_FILE, PIPELINE_TEMPLATE_FILE
remoteenables validating a pipeline on a remote serverVELA_REMOTE, PIPELINE_REMOTE
compiler.github.tokengithub compiler tokenVELA_COMPILER_GITHUB_TOKEN, COMPILER_GITHUB_TOKEN
compiler.github.urlgithub url, used by compiler, for pulling registry templatesVELA_COMPILER_GITHUB_URL, COMPILER_GITHUB_URL

Permissions

COMING SOON!

Sample

Simple Request

vela validate pipeline

Expanded Template Request (GitHub)

vela validate pipeline --template --compiler.github.token <token> --compiler.github.url https://git.example.com

Expanded Template Request (Local)

vela validate pipeline --template --template-file name:/path/to/file

Response

".vela.yml" is valid

Using a template in your pipeline? You can validate templates also.