What is the difference between a job and a workflow in CircleCI?

A job is a collection of steps (commands) that run in a single executor. A workflow orchestrates multiple jobs, defining their order, parallelism, and dependencies. Most real pipelines have 3-5 jobs in a workflow.

What are CircleCI orbs?

Orbs are reusable YAML packages published to CircleCI's orb registry. They bundle commands, jobs, and executors for common tools. Using the aws/cli orb, for example, eliminates 20+ lines of repeated AWS authentication setup.

Is CircleCI free for open-source projects?

CircleCI offers 400,000 free credit-minutes per month for open-source projects with public repositories. Private repositories have a more limited free tier. Credit consumption depends on resource class and job duration.

DevTools Surf

CircleCI Config Builder

This tool is not yet implemented.

Example: CircleCI Config Builder

A worked example, rendered from real sample data. Sign in to run the tool on your own input.

Input

2.1
build
test
integration

Output

{
  "version": "2.1",
  "jobs": {
    "build": {
      "docker": [
        {
          "image": "cimg/node:20.0"
        }
      ],
      "steps": [
        "checkout",
        {
          "run": "npm install"
        },
        {
          "run": "npm run build"
        }
      ]
    },
    "test": {
      "docker": [
        {
          "image": "cimg/node:20.0"
        }
      ],
      "steps": [
        "checkout",
        {
          "run": "npm install"
        },
        {
          "run": "npm run test"
        }
      ]
    },
    "integration": {
      "docker": [
        {
          "image": "cimg/node:20.0"
        }
      ],
      "steps": [
        "checkout",
        {
          "run": "npm install"
        },
        {
          "run": "npm run build"
        }
      ]
    }
  },
  "workflows": {
    "build_and_test": {
      "jobs": [
        {
          "build": {}
        },
        {
          "test": {
            "requires": [
              "build"
            ]
          }
        },
        {
          "integration": {
            "requires": [
              "test"
            ]
          }
        }
      ]
    }
  }
}

About CircleCI Config Builder

CircleCI Config Builder preview - DevOps / CI-CD tool

Build CircleCI configuration files with workflows and jobs. Part of the DevTools Surf developer suite. Browse more tools in the DevOps / CI-CD collection.

Use Cases

Generate a CircleCI config.yml for a containerized application
Create parallel test execution jobs to reduce pipeline duration
Set up workflow with manual approval gate before production deployment
Configure Docker layer caching to speed up repeat builds

Tips

Define orbs at the top of your config for reusable shared configuration — CircleCI's orb registry has pre-built orbs for Node, Docker, AWS, and 250+ other tools
Use the 'matrix' key under jobs to run the same job with multiple parameter values (e.g., different Node versions) without duplicating job definitions
Set resource_class on each job to right-size compute — machine.large for intensive jobs, small for linting/formatting checks reduces CI costs significantly

Fun Facts

CircleCI was founded in 2011 and was one of the first cloud-native CI services — predating GitHub Actions by 8 years. It pioneered the 'runs on containers by default' model that became industry standard.
CircleCI's orb registry hosts over 3,000 reusable configuration packages. Orbs were introduced in 2018 and reduced repetitive YAML in CI configs by enabling shared, versioned configuration snippets.
CircleCI experienced a security incident in January 2023 where an engineer's machine was compromised, leading to the exposure of encrypted customer secrets. The incident prompted a major industry discussion about CI/CD supply chain security.

FAQ

What is the difference between a job and a workflow in CircleCI?: A job is a collection of steps (commands) that run in a single executor. A workflow orchestrates multiple jobs, defining their order, parallelism, and dependencies. Most real pipelines have 3-5 jobs in a workflow.
What are CircleCI orbs?: Orbs are reusable YAML packages published to CircleCI's orb registry. They bundle commands, jobs, and executors for common tools. Using the aws/cli orb, for example, eliminates 20+ lines of repeated AWS authentication setup.
Is CircleCI free for open-source projects?: CircleCI offers 400,000 free credit-minutes per month for open-source projects with public repositories. Private repositories have a more limited free tier. Credit consumption depends on resource class and job duration.

Related DevOps / CI-CD Tools

CI/CD Pipeline Builder GitHub Actions Generator GitLab CI Generator Jenkins Pipeline Simulator Travis CI Simulator Coverage Report Analyzer Dependency Checker License Compliance Checker

DevTools Surf