Build the Pipeline

In this section we will be discussing about the various pipeline components in detail, their usage in the catalyst-pipelines.yaml file, how to incorporate these components directly from the Catalyst console and build a Catalyst pipeline. Let us get started!

Runners

Introduction

A runner is an agent or computing resource that executes the jobs defined in a pipeline. Catalyst runners offer a robust and flexible infrastructure for efficiently and reliably building, testing, and deploying software applications. You can define the required runners for the pipeline as key-value pairs using the runners keyword.

The runner configurations supported by Catalyst Pipelines are listed below:

Runner config RAM Storage CPU Capacity Disk Space
Low 1 GB 0.8 vCPU 2 GB
Medium 2 GB 1.2 vCPU 4 GB
High 4 GB 2.0 vCPU 8 GB
Note:
  1. Defining a runner is not mandatory. If a runner is not specified, the medium config runner is taken by default to execute the jobs.
  2. You can define runners at the pipeline level, stage level, or job level. In case of multiple definitions, the one specified at the lowest level (i.e., job) takes precedence.

Properties of a Runner

Key Value is Mandatory
Runner name (The runner variable name used to access the runner) Yes
config-id The ID of the required runner configuration. Low = config-id : 1
Medium = config-id :2
High = config-id : 3
Yes

YAML Code Snippet for Runner

    
copy
runners: runner1: config-id: 2 runner2: config-id: 3

Global Configuration

You can also define the runners at the pipeline level, if required. This runner configuration will be accessible to all the stages and jobs. You can configure a runner at the pipeline level as follows:

    
copy
pipeline-runner:runner1

Last Updated 2025-05-30 16:54:59 +0530 +0530