Pipeline Connections

Pipeline Connections

Connections define the execution order between jobs in a pipeline. They determine which jobs run in sequence, in parallel, or wait for multiple dependencies.

Connection Basics

A connection links a job’s output port to another job’s input port:

┌─────────────┐         ┌─────────────┐
│   Job A     │●───────▶│   Job B     │
└─────────────┘         └─────────────┘
           output       input

Job B will only start after Job A completes successfully.

Connection Patterns

Sequential

Jobs run one after another:

┌───────┐     ┌───────┐     ┌───────┐
│ Test  │────▶│ Build │────▶│Deploy │
└───────┘     └───────┘     └───────┘

Parallel (Fan-out)

Multiple jobs start from the same source:

              ┌───────────┐
         ┌───▶│ Build iOS │
         │    └───────────┘
┌───────┐│
│ Test  │├───▶┌───────────┐
└───────┘│    │Build Droid│
         │    └───────────┘
         │    ┌───────────┐
         └───▶│ Build Web │
              └───────────┘

All three builds start simultaneously after tests pass.

Fan-in

One job waits for multiple upstream jobs:

┌───────────┐
│ Build iOS │────┐
└───────────┘    │
                 ▼
┌───────────┐ ┌───────┐
│Build Droid│─▶│Notify │
└───────────┘ └───────┘
                 ▲
┌───────────┐    │
│ Build Web │────┘
└───────────┘

Notify only runs after all three builds complete.

Complex Workflows

Combine patterns for sophisticated pipelines:

          ┌───────────┐     ┌────────────┐
     ┌───▶│ Build iOS │────▶│ Deploy iOS │───┐
     │    └───────────┘     └────────────┘   │
┌────┴───┐                                   ▼
│  Test  │                              ┌─────────┐
└────┬───┘                              │ Notify  │
     │    ┌───────────┐     ┌────────────┐   ▲
     └───▶│Build Droid│────▶│Deploy Droid│───┘
          └───────────┘     └────────────┘

Creating Connections

1. Hover over a job’s right edge (output port)
2. Click and drag toward another job
3. Release on the target job’s left edge (input port)

Removing Connections

1. Click on the connection line
2. Press Delete or Backspace

Or right-click the line and select “Remove”.

Rules

No Circular Dependencies

You cannot create loops:

❌ Invalid:

┌───────┐     ┌───────┐
│ Job A │────▶│ Job B │
└───────┘     └───────┘
     ▲            │
     └────────────┘

Triggers Start the Flow

Every pipeline needs at least one trigger connected to the first job(s):

┌──────────┐     ┌───────┐
│ Trigger  │────▶│ Job   │
└──────────┘     └───────┘

Orphan Jobs Don’t Run

Jobs without incoming connections (except triggers) won’t execute:

┌──────────┐     ┌───────┐
│ Trigger  │────▶│ Job A │  ← Runs
└──────────┘     └───────┘

┌───────┐
│ Job B │  ← Never runs (no connection)
└───────┘

Execution Order

1. Pipeline triggered
2. All jobs connected directly to trigger start
3. As each job completes, downstream jobs check if all their dependencies are done
4. If all dependencies succeeded, job starts
5. If any dependency failed, downstream jobs are skipped

Failure Handling

By default, if a job fails:

• Downstream jobs are skipped
• Pipeline run is marked as failed

Notification jobs can be configured to run on failure for alerts.