liveBook · Manning

Pipeline instance

As explained in Platform Engineering on Kubernetes

A pipeline instance is one execution of a pipeline definition with a particular set of parameters and resulting state.

A pipeline instance is one execution of a pipeline definition. A pipeline engine creates it, applies its parameters, runs the defined tasks in sequence, and tracks resulting state and outputs. section 3.1

A pipeline instance typically:

  • Runs tasks such as tests, code copying, deployment, virtual-machine provisioning, or user creation. section 3.1
  • Shares data generated by one task with subsequent tasks. section 3.1
  • Stops and becomes failed when a task errors; otherwise, it can become successful after execution completes. section 3.1
  • May remain running for an extended period, depending on its tasks. section 3.1
Figure 3.2 A pipeline definition can be instantiated by a pipeline engine multiple times, and it describes what needs to be done. The pipeline engine creates pipeline Instances, which run the tasks included in the pipeline definition. These pipeline instances can fail or run for longer periods of time depending on the tasks that they are performing. As a user, you can always ask the pipeline engine the status of a particular pipeline instance and its tasks.

Use the figure to distinguish the reusable pipeline definition from multiple parameterized instances and inspect instance and task status. section 3.1

How Platform Engineering on Kubernetes covers it

How deep it goes
Explains creation, sequencing, shared task data, parameters, outputs, duration, and success or failure states.
Examples
Uses three instances: one successful, one failed, and one still running.
What it assumes
Assumes a pipeline definition containing ordered tasks and explains the pipeline engine's role in creating executions.
What you can do after
Operate pipeline runs by checking their status, task progress, errors, and expected outputs.
How it connects
Connects pipeline definitions, pipeline engines, tasks, parameters, outputs, and pipeline state.

Related concepts

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