liveBook · Manning

Dumb pipeline

As explained in Effective Platform Engineering

A dumb pipeline is an automation pipeline whose logic is limited primarily to ordering and invoking reusable implementation code.

A dumb pipeline limits workflow logic to ordering and invocation. Git-triggered steps call reusable, versioned pipeline code—such as CircleCI orbs, shell-script libraries, or local scripts—for implementation details. section 6.3.3

This separation keeps standardized pipelines DRY across teams and helps developers pass shared compliance checks. It also preserves the ability to replace the pipeline tool without rewriting implementation logic. section 6.3.3

Namespace-level infrastructure pipeline

A platform team can trigger a pipeline from a Git event, retain only its secret-access credential in a CircleCI context, and delegate infrastructure behavior to shared versioned code or pipeline-specific local scripts. section 6.3.3

Figure 6.10 Well-architected Infrastructure-as-code pipelines are no different from well-architected regular software pipelines. This is why we prefer the term “software-defined infrastructure” to differentiate between simply using an infrastructure-as-code (IaC) framework like Terraform and the software engineering practices that are a part of sustainable, high-quality software developer lifecycle management of an engineering platform product.
A screenshot of a diagram

AI-generated content may be incorrect.

Relates dumb pipeline design to well-architected software and infrastructure-as-code pipelines, emphasizing software-engineering practices over framework choice. section 6.3.3

How Effective Platform Engineering covers it

How deep it goes
Defines the architecture and benefits, but stops short of prescribing a complete pipeline implementation.
Examples
Uses CircleCI orbs, shell-script libraries, local scripts, and namespace-level infrastructure pipelines.
What it assumes
Assumes software-development familiarity and applies established software-pipeline practices to infrastructure code.
What you can do after
Apply it by placing ordering logic in workflows and implementation logic in versioned shared or local code.
How it connects
Connects standardized pipelines, reusable versioned code, infrastructure as code, and software-defined infrastructure.

Related concepts

This explainer was generated by Manning's knowledge graph from the text of Effective Platform Engineering. The section links point to the parts of the book it draws on.