The PreMatrix generic step may be used to prepare a build environment for execution of a Matrix step.
The PreMatrix step is optional for use with Matrix builds. For more information, see Using the Matrix Step.
Usage
FanOut
pipelines: - name: <string> steps: - name: <string> type: PreMatrix configuration: # inherits Bash config, except affinityGroup and outputResources execution: onStart: - echo "Preparing for work..." onExecute: # required - echo "this is a PreMatrix step" onSuccess: - echo "Job well done!" onFailure: - echo "uh oh, something went wrong" onComplete: #always - echo "Cleaning up some stuff"
Tags
name
An alphanumeric string (underscores are permitted) that identifies the step.
type
Must be PreMatrix
for this step type.
configuration
Specifies all configuration selections for the step's execution environment. This step inherits the Bash/ PowerShell step configuration tags, except for thesetags, which are disallowed:
affinityGroup
outputResources
execution
Declares collections of shell command sequences to perform for pre- and post-execution phases:
Tag | Description of usage | Required/Optional |
---|---|---|
| Commands to execute in advance of | Optional |
| Main commands to execute for the step | Optional |
| Commands to execute on successful completion | Optional |
| Commands to execute on failed completion | Optional |
| Commands to execute on any completion | Optional |