liveBook · Manning

Software-defined pipeline

As explained in Effective Platform Engineering

A software-defined pipeline is an automation pipeline whose behavior is declared and versioned as code in a source repository.

A software-defined pipeline declares automation behavior as versioned code owned by the team, with source-triggered CI pipelines stored beside the code they test. section 6.2.2

Build the pattern around explicit ownership and controlled change:

  • Keep CI and deployment pipeline code in the team’s repository rather than relying on GUI configuration. section 6.2.2
  • Extract common build and test steps into shared code, and manage internal pipeline libraries with integration tests and versioned releases. section 6.2.2
  • Introduce shared-pipeline changes through intentional version updates; fork shared code when necessary changes are delayed. section 6.2.2

A team-owned delivery pipeline

A team stores its CI definition beside application code, references a versioned internal library for common build and test steps, and deliberately upgrades when that library changes. The team can fork the library instead of waiting for another group, avoiding blocked developers and unexpected breaking changes. section 6.2.2

How Effective Platform Engineering covers it

How deep it goes
Details repository placement, shared code, integration tests, versioned releases, forks, and avoidance of GUI-based creation.
Examples
Uses orbs, actions, shared build and test steps, versioned pipeline libraries, repository definitions, and forks as examples.
What you can do after
Build it from scratch by storing pipeline code with application code and evolving shared automation through deliberate versions.
How it connects
Connects CI, deployment pipelines, source repositories, shared libraries, integration testing, versioning, and developer self-service.

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.