Explanation: Pipelines
1. Library
When you arrive to the pipelines within your project, you’ll land in the project’s pipeline library.

-
Access project-level environment variables in the secondary navigation panel.
-
Also in the secondary navigation panel you’ll find all Docker credentials for this project.
-
The breadcrumbs in the top bar display your current location.
-
The top bar title is the title of the current page. In this case, you’re on
Pipelines
. -
Also in the top bar are buttons to:
-
Update (refresh) your page
-
Access project settings
-
Create a new pipeline
-
-
Use the search bar to search for pipelines by name.
-
Finally, you’ll see a list of all of the pipelines in this project. Continue reading for more details.
1.1. List of pipelines
The list of pipelines includes several details, with each line describing one pipeline.
A pipeline line includes the following information and options:

-
Button to run the pipeline
-
Pipeline name
-
Badge indicating the pipeline’s most recent status
-
Most recent instance of the pipeline
-
Button to delete the pipeline
Additionally, there is a small clock icon next to scheduled pipelines. When you hover over the icon, you’ll see when the pipeline is next scheduled to run.

2. Overview
The overview page is the first page you’ll reach when you navigate to your pipeline details. It displays essential information about the pipeline and links to other important pipeline details.

-
The second-level navigation column has links to the pages for a pipeline’s overview, instances, and versions.
-
The second-level navigation column displays the pipeline’s current status and when the pipeline last ran. There are also buttons to run or delete your pipeline.
-
The breadcrumbs in the top bar show which project and pipeline you’re viewing. You can also use the breadcrumbs as navigation.
-
The top bar title is the title of the current page.
-
Also in the top bar are buttons to update your pipeline, access pipeline settings, and upgrade your pipeline.
-
In the body of the page layout, there is a section featuring all pipeline settings.
-
Also in the body of the page layout is a section featuring the pipeline’s configuration, including the pipeline’s version information as well as the version’s release note (if one was added), creation date, and who created the version.
-
The final section in the body displays information about the pipeline’s orchestration, notably conditions and branches in which jobs in the pipeline will run.
3. Settings
Pipeline settings include the following non-versioned features:
-
Name
-
Description
-
Alerts
-
Run type
You can also access pipeline settings while editing your pipeline. |
3.1. Name
Names are always required.
There are minimal restrictions when naming pipelines:
-
Names cannot exceed 255 characters.
-
You cannot repeat pipeline names within a project.
3.2. Description
Descriptions are optional.
There are no restrictions on descriptions, though it’s good practice to keep them short and informative.
3.3. Alerts
By setting up alerts, you’ll receive an email each time your pipeline’s status changes to a status you selected when creating or modifying the pipeline.
Alerts are sent to an email address. You can either choose an email address from the drop-down menu, or, if the email address you need doesn’t appear, you can enter it. You can have alerts sent to one or several email addresses.
You can receive alerts for one or several of the follow statuses:
-
requested
: you’ve asked for the pipeline to run; it is waiting for the resources it needs to be able to launch -
queued
: the pipeline is in line to run -
running
: the pipeline is actively running -
failed
: the pipeline’s run failed -
killing
: Saagie is in the process of stopping the pipeline’s run -
killed
: the pipeline’s run has stopped -
succeeded
: the pipeline ran successfully -
unknown
: the pipeline’s run details are missing
3.4. Run types
There are two run types:
-
Manual run requires you to launch the pipeline manually by selecting the Run button in the Saagie user interface.
-
Scheduled run launches the pipeline according to the schedule you determine.
You can also launch scheduled runs manually. |
3.4.1. Timezone
Whatever the schedule run mode selected, you can choose which timezone to use to apply on your pipelines.
Choosing your time and day
|

Scheduled run modes
If you choose a scheduled run, there are three ways to determine the schedule: simple
, shortcut
, and expert
.
3.4.2. Simple
In simple mode, you control each variable through a user interface. Here are the possible configurations.
-
minute: every [xx] minutes
-
hour: every [xx] hours at [xx] past the hour
-
day: every [xx] days at [xx]:[xx] time
-
week: every [xx] week on [day of week] at [xx]:[xx] time
-
month: every [xx] month on the [date of month] at [xx]:[xx] time
-
year: every [xx] year on the [date of month] of [month] at [xx]:[xx] time

3.4.3. Shortcut
In shortcut mode, you choose how often you want to run the pipeline. All other settings are automatic.
-
hourly: every hour, on the hour
-
daily: every day at midnight UTC
-
weekly: every Sunday at midnight UTC
-
monthly: the first day of each month at midnight UTC
-
annually: January 1 at midnight

3.4.4. Expert
In expert mode, you control each variable (like in simple mode), but you do so using Cron format: [minute] [hour] [day of the month] [month] [day of the week]
.
For example, by entering 30 9 * * 2
in the cron field, you’ve scheduled your pipeline to run at 9:30 AM UTC +01:00 Europe/Paris time Tuesday.
-
[minute] 0-59
-
[hour] 0-23
-
[day of the month] 1-31
-
[month] 1-12
-
[day of the week] 0-6 (Sunday to Saturday)

4. Upgrade
You can upgrade the pipeline’s configuration using the Upgrade pipeline button. Upgrading your pipeline creates a new version of that pipeline.
The pipeline’s configuration includes the following versioned features:
-
Design your pipeline
-
Add jobs to a pipeline
-
Remove jobs from a pipeline
-
Add a link
-
Remove a link
-
Add condition to a pipeline
-
Remove condition from a pipeline
-
Release notes
4.1. Design your pipeline
-
You will first land in the full screen pipeline design grid.
-
You can move jobs/conditions anywhere on the design grid.

-
The header allows you to manage settings while upgrading your pipeline.

-
You can update the pipeline’s name.
-
You can update the pipeline’s description.
-
You can manage alerts.
-
You can manage scheduling.
-
You can manage release notes.
-
You can save the pipeline modifications.
-
You can access to other features:
Save & Run
-
You can quit without saving.
Modifications strictly related to metadata as |
4.2. Add jobs to a pipeline
You can add jobs anywhere in a pipeline. |
-
Click on the
add job
button to add another job on the grid then drag it where you want. -
Search and select your job from the list.
-
Drag your job where you want.
Pipelines only run the job version tagged as the current version. If you’d like to confirm the job’s current version:
Refer to job version tags for more information about job versions. |
4.3. Remove jobs from a pipeline
You can remove jobs from a pipeline’s current orchestration by selecting the job you’d like to remove in the pipeline orchestration window, then selecting Remove button.

You can also use Backspace or Delete keys.
|
However, once a job is a part of a pipeline, the job will always be a part of that pipeline’s history. Removing a job from a pipeline does not delete the pipeline’s instances that include the removed job.
Once a job is a part of any pipeline, it can no longer be moved from one project to another—even after being removed from the pipeline. |
4.4. Add a link
You can add links between jobs and conditions in a pipeline.
-
Click and hold on the output of a job/condition to start a link.
-
Drag the link to the input of another job/condition.

You can link as many input or output jobs you want to a job. |
4.4.1. Job links behaviours
|
-
When linking one or more source job(s), to a target job, the target job will be triggered
only if all source job(s) status isSUCCEEDED
.-
Example with all source jobs status are
SUCCEEDED
. -
Example with one source job status is
FAILED
.
-
4.5. Remove a link
You can remove links between jobs and conditions in a pipeline.
-
Click on the cross in the middle of the link.

4.6. Add a condition
You can add conditions between jobs in a pipeline. It allows you to choose what following jobs will be executed depending on the status of previous input jobs.
-
Click on
Add condition
button. -
Drag the condition where you want.
-
Link jobs outputs to the condition input.
-
Link condition
OK output
to the next job to execute if all previous jobs status are succeeded or skipped. -
Link condition
KO output
to the next job to execute if all previous jobs status are neither succeeded nor skipped.

You can link as many input or output jobs you want to a condition. |
4.6.1. Link condition behaviours
-
When linking one or more source job(s), to a condition, the
1st OK branch job
will be triggered only if all source job(s) status isSUCCEEDED
orSKIPPED
else the1st KO branch job
will be triggered.-
Example with all source jobs status are
SUCCEEDED
. -
Example with one source job status is
FAILED
.
-
You cannot link conditions. |
4.7. Remove a condition
You can remove conditions from a pipeline’s current orchestration by selecting the condition you’d like to remove in the pipeline orchestration window, then selecting Remove.

You can also use Backspace or Delete keys.
|
5. Instances
An instance of your pipeline is a single run of that pipeline.
When you first arrive on your pipeline’s instances page, you’ll see the information for the most recent pipeline instance:

5.1. Instance information
-
Current pipeline instance number
-
Status of the most recent pipeline instance
-
Current pipeline version
-
Start time, end time, and duration of the instance
5.2. Orchestration progress
A pipeline’s instance page is where you can see how that pipeline’s orchestration progressed for that specific instance.
Additionally, when a pipeline is running, you can see its progress in real time on this page.
There are several buttons in this section so that you can optimize your view. Use them to zoom in and out as well as view this section full-screen.
When a pipeline execution is finished, you can select a job and click:
![]() |
6. Versions
Whenever your pipeline is upgraded, a new version of that pipeline is created. You can access and run any version of your pipeline from the pipeline versions interface.
When you first arrive on your pipeline’s versions page, you’ll see the following information for the current version:

6.1. Tags
6.1.1. Current version
By default, the current version of the pipeline is the most recent version.
However, you can tag any version of your pipeline as the current version. You can rollback to an older version of the pipeline to make it the current version.
When you create a new version of the pipeline, it is tagged automatically as the current version.
6.2. Version information
Each version page contains all information for that version, including:
-
Release note (if one was included)
-
Date created
-
Creator