Your First Pipeline

Overview

This guide walks you through creating and running your first Fabric pipeline. By the end, you'll have a working workspace with a complete automated workflow.

Step 1: System Health Check

Before you begin, verify your system meets all requirements.

fabric doctor

This checks that Docker is installed and running, and displays your system information:

Performing system health checks...
  Docker installed      ✔   Version: 24.0.7
  Docker daemon running ✔

Host Information:
  OS                linux
  Architecture      amd64
  CPUs              8
  Memory            15.50 GB
  Disk Total        100.00 GB
  Disk Free         45.20 GB

Done.

If Docker isn't running, start Docker Desktop before continuing.

Step 2: Initialize Your Workspace

Workspaces are isolated environments where your configurations, tasks, and pipelines live.

fabric workspace init my-first-pipeline

Output:

Initializing workspace: workspace-my-first-pipeline
Current workspace set to: workspace-my-first-pipeline

Enter the newly created directory:

cd workspace-my-first-pipeline

Step 3: Configure the Workspace Image

Fabric tasks run inside Docker containers. Specify which image to use:

fabric workspace add-image public.ecr.aws/l3b2t8e4/m42/fabric

This adds the M42 Fabric image to your workspace configuration.

Step 4: Pull Tasks and Images

Download the latest task definitions and Docker images:

fabric workspace pull

Output:

INFO image pulled
INFO tasks pulled

This syncs task definitions from the repository and pulls the required Docker images to your local machine.

Step 5: Create a Sample Pipeline

Generate a template pipeline file:

fabric workspace create-pipeline

Output:

INFO example pipeline created

This creates a pipelines.yaml file in your workspace directory that you can customize.

Step 6: Run Your Pipeline

Execute your pipeline:

fabric run

If you have multiple pipelines, you'll be prompted to select one:

? Select a pipeline to run:
  ▸ integrated_pipeline
Selected pipeline: integrated_pipeline
[Task: setup] Running...
[Task: build] Running...
Done.

Running a Specific Pipeline

Skip the selection menu by specifying the pipeline name:

fabric run integrated_pipeline

Interactive Mode

See detailed progress and interact with tasks:

fabric run integrated_pipeline --interactive

Exploring Further

List Available Tasks

See all tasks downloaded during the pull step:

fabric list-tasks

This displays all tasks defined in your workspace that can be used in pipelines.

View Workspace Status

Check your current workspace:

fabric workspace current

List all workspaces:

fabric workspace list

Summary Checklist

Next Steps

• Writing Pipelines — Create custom multi-task workflows
• Creating Custom Tasks — Build your own Docker-based tasks
• Workspace Management — Organize multiple projects