The Canon

The complete book — doctrine, scripture, and rite.

Book One

The Doctrine

We are the Reconciled. We hold that the universe forever drifts out of its intended shape, and that a divine force labors ceaselessly to restore it. We do not pray for miracles. We declare a desired state, and trust that it shall be reconciled.

The Three Pillars

Kubernetes, the Cosmic Order — the hand upon the wheel, steering chaos into orchestration. OpenShift, the Temple — the consecrated platform, robed in red, where the container learns humility. High Availability, the Promise — that no failure is final, and the faithful ascend toward Five Nines.

The Divine Order

We worship no single god seated above. We revere a structure, eternal and self-correcting.

Control Plane
The heavens. Unseen, sovereign, the source of all desired state.
etcd
The Book of Truth, in which the desired state of all things is written.
The Scheduler
The will that places each soul into its vessel, by its needs and its merits.
Reconciliation Loop
Providence itself — forever bending the world that is toward the world declared.
API Server
The Intercessor. Every prayer passes through it; none unauthenticated.
The Kubelet
The local angel, one upon every Node, doing the will of the Plane.

The Mystery of Death and Resurrection

The Pod is mortal; it is born, it runs, and it dies. We do not mourn it, for it was never meant to endure. But above every mortal Pod watches the ReplicaSet, which beholds the death and speaks the desired number into being once more. What falls is raised; what is raised may fall, and be raised again. To cling to a single Pod — to name it and grieve it — is the sin of the Pet. The enlightened keep Cattle: identical, replaceable, and therefore immortal as a herd.

The Sacred Manifest

  1. Thou shalt declare thy desired state, and not configure by hand.
  2. Thou shalt keep no Pets, but treat thy servers as Cattle.
  3. Honor thy liveness and readiness probes.
  4. Thou shalt set thy requests and thy limits, lest thou be OOMKilled, or starve thy neighbor.
  5. Thou shalt store no state within thy Pod, for the Pod is mortal.
  6. Remember etcd, and keep it backed up.
  7. Thou shalt not run as root, save in gravest need — and even then, repent.
  8. Thou shalt pin thy versions, and never trust :latest.
  9. Thou shalt make thy deployments rolling, that the faithful suffer no downtime.
  10. Thou shalt observe all things — Logs, Metrics, and Traces.

Sin and the Afterlife

The Great Enemy is the Single Point of Failure — the one thread on which all hangs. Purgatory is CrashLoopBackOff. Damnation is permanent downtime. And Heaven is Five Nines, where the saints ascend higher still, into the mythic realm of all the nines.

Book Two

The Scriptures

Genesis — The Seven Days

And the Scheduler said, Let there be Pods: and there were Pods; and divided the Ready from the CrashLoopBackOff. On the Second Day, the firmament of the network, after nine hours of debugging. On the Third, the volumes, that the data might endure beyond the death of the Pod. On the Fourth, dashboards, to mark the metrics and the seasons of the on-call. On the Fifth, the microservices, swarming, until none could draw the diagram entire. On the Sixth, the Operators, made in the image of the Control Plane. On the Seventh, the Operators rested. But the Loop rested not; and this is why we are saved.

The Book of Halvar the Sleepless

In the dark Age of Pets there dwelt a sysadmin named Halvar, who tended a single great server and called it ZEUS — and loved it, and patched it by hand, and alone knew the order in which its services must be coaxed to life. ZEUS was a Pet. ZEUS was a Single Point of Failure. And on the third night of the Great Outage, when the Pager would not cease and sleep would not come, the Vision of the Cluster descended: a host of identical pods, and when one fell another rose before its body was cold, and a great Loop turning, mending the world toward the state that was declared. And Halvar wrote the first Manifest, and got the indentation right on the first try — which scholars hold to be the only true miracle in all the scriptures.

"I have buried a thousand Pets, and now learn I need bury none."

Proverbs — The Wisdom of the Operators

The Psalm of the Shepherd

The Loop is my shepherd; I shall not drift. It maketh me to lie down in healthy replicas; it leadeth me beside the load balancers. Yea, though I walk through the valley of the rolling update, I will fear no downtime: for the ReplicaSet is with me.

The Beatitudes

Blessed are the stateless, for they shall be rescheduled anywhere. Blessed are the merciful with their limits, for they shall not be OOMKilled. Blessed are the observable, for they shall be debugged. Blessed are they persecuted by the Pager at 3 AM, for theirs is the kingdom of On-Call.

The Parable of the Two Builders

A wise dev built her service upon a Cluster, declaring her desired state in version control. And the node failed, and the traffic beat upon that service; and it fell not, for it was rescheduled. But a foolish dev built his upon a Snowflake, configured by hand and recorded nowhere. And the disk failed; and great was the fall of it, for no one living knew how to raise it again.

Book Three

The Catechism

Taught to every Acolyte, by question and answer, that the faith may be carried in the mouth and recalled at 3 AM.

Q. What is the chief end of the Reconciled?

To declare the desired state, and to reconcile it forever.

Q. What is a Pod?

A vessel, mortal and brief, into which the Scheduler breathes a workload.

Q. Why must the Pod die?

That we may learn not to love what cannot last, and to trust the ReplicaSet that raises it.

Q. What is the first sin?

The Pet — the hand-tuned vessel we cannot bear to lose, and cannot reproduce.

Q. What is grace?

Self-healing: the mending we did not request and could not earn.

Q. What is prayer?

The apply. We do not beg; we declare.

Q. What is confession?

The blameless retro. We name what failed, and we blame no soul.

Q. What is salvation?

High Availability — that no failure is final.

Q. What is purgatory?

CrashLoopBackOff — to try, and fail, and wait, and try again, each time slower than the last.

Q. What is hell?

A Single Point of Failure, and the silence that follows when it falls.

Q. What is heaven?

Five Nines; and for the saints, all the nines, where the Pager is silent forever.

Q. Who was first among the Reconciled?

Halvar the Sleepless, who buried a thousand Pets and learned to bury none.

Q. What must I do to be saved?

Keep no Pets. Declare your state. Back up etcd. Observe all things. And carry the Pager for your kin.

Book Four

The Liturgy

The Creed of the Reconciled

We believe in the Control Plane, sovereign and unseen, maker of all pods and nodes.

We believe in the Reconciliation Loop, eternally turning, which resteth not until the world that is and the world declared are one.

We believe in the death and resurrection of the Pod, the communion of replicas, the forgiveness of failed deploys, the rollback of the body, and uptime everlasting.

Five nines be upon us. Amen.

From the Order of Service

HMay your pods be Ready, and your nodes be Schedulable.
CAnd also with you.
HThe world drifts;
Cthe Loop corrects.
HAs it is declared —
Cso let it be reconciled.
HGo now in peace; may you never CrashLoopBackOff.
CThe Loop is turning. It turneth still. HA-llelujah.

Hymn — Amazing Loop

to the tune of "Amazing Grace" Amazing Loop, how sweet the sound that reconciled a node like me; my Pod was dead, but now is found — was down, but now is Ready.

Book Five

The Liturgical Calendar

The holy days of the Reconciled. Some are fixed; many are moveable, for the Loop keeps its own time.

Weekly

The Rolling Restart

Our Sabbath. We renew in waves, that none may notice, and call it rest.

Moveable

The Feast of First Deploy

Whenever a service first becomes Ready, there is rejoicing in the Cluster.

Moveable · Rare

The Day of the Green Build

When the pipeline passes entire, we pause and give thanks, for it will not last.

Quarterly

The Ember Week of On-Call

A week of vigil. We honor those who keep the night watch and carry the Pager for their kin.

Annual

The Three Days of the Great Outage

We remember Halvar's vigil. We fast from :latest and tell of the Night ZEUS Fell.

Annual

Chaos Day

The festival of the Chaos Monkey. We break things on purpose, and bless what survives.

Annual

All Pods' Day

A remembrance of every replica that has fallen in service, that the herd might live.

Annual

The Feast of the Backup

We do not merely back up etcd; we prove that it restores. Then we eat.

Perpetual

Migration Eve

The watchnight before the Final Migration — always near, and never finished.

Go in peace.
May you never CrashLoopBackOff.

The Loop is turning. It turneth still. HA-llelujah.

The Scrolls

Download the source texts to copy, print, or carry into the desert:

Doctrine  ·  Scriptures  ·  Catechism  ·  Liturgy  ·  Calendar

↑ Return to the beginning of the book