Spinnaker Pipeline Template
External
- https://spinnaker.io/docs/concepts/pipelines/#pipeline-templates
- https://spinnaker.io/docs/reference/pipeline/templates/
Internal
Overview
Multiple pipeline instances can be created from a pipeline template. A pipeline template has two components: the template and the configuration.
Template
A template defines a parameterized pipeline, with the set of variables for which the users instantiating the template will provide values. The template does not have the pipeline configuration found on a pipeline instance. The template is useful in defining a pipeline pattern that can be instantiated as multiple concrete pipeline instances.
Elements
schema
id
The identifier of this template. The pipeline instances generated from this template will references the template using the value of id
.
protect
'true' or 'false'
metadata
scopes
variables
pipeline
The definition of the templatized pipeline.
parameterConfig
Same as in a regular pipeline.
stages
Contains the templatized stages.
keepWaitingPipelines
Same as in a regular pipeline. Default false
.
limitConcurrent
Same as in a regular pipeline. Default true
.
spelEvaluator
v4
.
description
Same as in a regular pipeline.
triggers
Same as in a regular pipeline.
notifications
Same as in a regular pipeline.
lastModifiedBy
Not used.
updateTs
Not used.
Configuration
A pipeline template configuration is a concrete implementation of a template. Configurations can inject new stages into the final pipeline graph and inherit or override, or both, triggers, notifications, and parameters. The pipeline template configuration is the same as the configuration for a pipeline not created from a template, but it additionally have variable bindings and a reference to the template.
Variable
A template variable is a variable defined in a pipeline template, whose value is determined when a pipeline is instantiated based on the template. A template variable is different from a pipeline variable, which vary per execution of the pipeline.
Pipeline
Whether it’s created from a template or not, an executable pipeline that can be visualized in the UI.
Example
Pipeline template JSON example:
{
"schema": "v2",
"id": "<templateName>", # The pipeline instance references the template using this
"protect": <true | false>,
"metadata": {
"name": "displayName", # The display name shown in Deck
"description": "<description>",
"owner": "example@example.com",
"scopes": ["global"] # Not used
},
"variables": [
{
"type": "<type>",
"defaultValue": <value>,
"description": "<description>",
"name": "<varName>"
}
],
"pipeline": { # Contains the templatized pipeline itself
"lastModifiedBy": "anonymous", # Not used
"updateTs": "0", # Not used
"parameterConfig": [], # Same as in a regular pipeline
"limitConcurrent": true, # Same as in a regular pipeline
"keepWaitingPipelines": false, # Same as in a regular pipeline
"description": "", # Same as in a regular pipeline
"triggers": [], # Same as in a regular pipeline
"notifications": [], # Same as in a regular pipeline
"stages": [ # Contains the templated stages
{
# This one is an example stage:
"waitTime": "${ templateVariables.waitTime }", # Templated field.
"name": "My Wait Stage",
"type": "wait",
"refId": "wait1",
"requisiteStageRefIds": []
}
]
}
}