Skip to content

The Shrine Archive

The forbidden library of Kubblai.

Codex Gigas: disciplined manuscripts on control planes, reconciliation, scheduling, trust boundaries, observability, resilience, and machine order—written for people who have seen clusters fail.

Orientation

Ceremonial in voice. Rigorous in content.

These texts are written as manuscripts: technically specific, shaped by production tradeoffs, and grounded in how clusters fail under load, latency, and policy.

If you are new here, begin with fundamentals. If you are fluent, follow cross-links like corridors through a sealed library.

Browse by purpose

Choose the surface that matches your intent.

Topic maps

A richer index that stays readable.

Area

Showing 12 of 12.

Topic map

Map

Foundations

The objects are simple. The discipline is not. Build correct mental models: desired state, control loops, and the testimony of the API.

Topic map

Map

Workloads

Workload APIs are where intent becomes containers. Study the controllers, their guarantees, and the failure modes they hide until the pager rings.

Topic map

Map

Networking

Networking is rarely one thing. It is a chain: edge → controller → service → endpoints → pods → policy. Break the chain into proofs.

Topic map

Map

Configuration & Secrets

Configuration is the most common root cause of outages. Treat naming, keys, and wiring as first-class operational contracts.

Topic map

Map

Scheduling & Placement

Scheduling is economics and ethics: who runs where, at what cost, under what constraints, and what happens when scarcity arrives.

Topic map

Map

Storage

Storage is slow to change and expensive to get wrong. Learn binding, provisioning controllers, and the constraints that govern state.

Topic map

Map

Operations

Operations is not a bag of commands. It is a protocol: observe → narrow → act → confirm → memorialize.

Topic map

Map

Troubleshooting

This shelf is built to be used mid-incident: symptom → what it means → proof commands → smallest safe fix → related doctrine.

Topic map

Map

Security

Security is governance under constraints. The goal is stable trust boundaries, not performative controls that operators bypass under pressure.

Topic map

Map

Observability

Observe to decide. Decide to change. If you change without evidence, you lose the only chance to learn.

Topic map

Map

Reference

A reference is only useful if it can be used mid-incident without ambiguity. This shelf is built for clarity and speed.

Topic map

Map

Labs (Index)

Labs are doctrine made physical. Repeat the sequence until it becomes reflex.

Featured writings

A short shelf of texts to begin with.

Archive index

74 writings · grouped by shelf

Section

Doctrine / Theology

7 texts

Marker

Section

Sacred Systems

10 texts

Marker

Sacred Systems

Codex Gigas

The Hidden Burdens of etcd

etcd is where intent is stored. It is also where unbounded ambition becomes latency, instability, and collapse.

Sacred Systems

Codex Gigas

The API Server as the Gate of Truth

The API is the only public reality in Kubernetes. Everything else is implementation detail and transient effect.

Sacred Systems

Codex Gigas

CNI as the Nervous System of the Cluster

Your CNI is not plumbing. It is a distributed system with its own control plane, performance ceiling, and failure modes.

Sacred Systems

Codex Gigas

CSI and the Persistence of State

Storage is where orchestration meets physics. CSI is the treaty between the cluster and the reality of disks.

Sacred Systems

Codex Gigas

Kubelet and the Discipline of Obedience

The kubelet is where the platform’s abstract intent becomes real processes. It obeys—but it also refuses when the node is dying.

Sacred Systems

Codex Gigas

The Shrine Archive: Kubernetes Fundamentals for New Followers

Fundamentals are not beginner trivia. They are the vocabulary you need to read incidents, reason about tradeoffs, and govern change safely.

Sacred Systems

Codex Gigas

Labels, Selectors, and the Geometry of Ownership

Labels are not tags. They are the geometry that determines ownership and routing. A single mismatch can silence traffic or orphan workloads.

Sacred Systems

Codex Gigas

Pod Lifecycle and Failure States

Pods are the symptom surface. If you can’t interpret their phases, reasons, and events, you cannot diagnose the cluster with discipline.

Sacred Systems

Codex Gigas

Services, Service Discovery, and Traffic Flow

A Service is stable naming plus an endpoint set. When the endpoint set is wrong—or withheld by readiness—traffic becomes myth. Prove endpoints first.

Sacred Systems

Codex Gigas

DNS in Kubernetes: What Fails and Why

DNS is not a single system. It is a chain with distinct failure classes. Learn to classify by symptom and prove from inside the namespace.

Section

Governance & Power

13 texts

Marker

Governance & Power

Codex Gigas

Admission Control and the Rite of Judgment

Admission is where governance becomes enforceable. It is also a place where outages are born.

Governance & Power

Codex Gigas

Policy as Doctrine, Not Suggestion

Policy is what makes a platform institutional. Without it, every incident is negotiated from scratch.

Governance & Power

Codex Gigas

Namespaces, Boundaries, and the Shape of Order

Namespaces are not security by themselves. They are the primary unit of operational containment and governance.

Governance & Power

Codex Gigas

Secrets, Sealing, and the Cost of Exposure

Secrets are not ‘data.’ They are risk with a lifecycle. Treat them as such or they will own your platform.

Governance & Power

Codex Gigas

Service Accounts and Delegated Identity

Identity is how the cluster knows who is acting. Delegation is how it limits what they can do.

Governance & Power

Codex Gigas

RBAC and the Governance of Power

RBAC is the cluster’s constitution. Poorly written, it becomes silent catastrophe during incident response.

Governance & Power

Codex Gigas

Pod Security Admission and the Hierarchy of Trust

Pod security is a boundary between ‘works’ and ‘safe to run.’ The hierarchy of trust must be explicit and enforced.

Governance & Power

Codex Gigas

The Orders of the Faithful Platform Engineer

Rank is a promise of behavior under pressure. In Kubblai, advancement is measured by governance and restraint.

Governance & Power

Codex Gigas

The Covenant of Cluster Stewards

Stewardship is a commitment to make systems legible and survivable. The covenant is the operator’s constitution.

Governance & Power

Codex Gigas

Multi-Cluster Governance and the Problem of Sovereignty

Multiple clusters create political boundaries: ownership, identity, policy, and observability become governance problems, not tooling problems.

Governance & Power

Codex Gigas

Secrets, Sealing, and the False Promise of Safety

Secrets are never a single object. They are a pipeline: creation, storage, distribution, use, and rotation—each step with its own exposure costs.

Governance & Power

Codex Gigas

The Cost of Tenant Illusions in Shared Clusters

Shared clusters promise efficiency. Without real isolation, they deliver shared outages: quota fights, RBAC mistakes, policy coupling, and security ambiguity.

Governance & Power

Codex Gigas

Platform Cost Doctrine: Waste, Density, and the Economics of the Cluster

Cost is a signal. When ignored, it reappears as fragility: overloaded nodes, under-provisioned control planes, and rushed change driven by budget panic.

Section

Advanced Disciplines

32 texts

Marker

Advanced Disciplines

Codex Gigas

The Scheduler and the Ethics of Placement

Placement is policy made physical. When you schedule, you are allocating failure domains, cost, and contention.

Advanced Disciplines

Codex Gigas

Taints, Tolerations, and the Law of Affinity

Affinity is desire; taints are refusal. Together they define where work may live and where it must never settle.

Advanced Disciplines

Codex Gigas

CRDs as New Scripture

CRDs extend the cluster’s language. They also extend its liabilities: storage, watch load, and governance surface area.

Advanced Disciplines

Codex Gigas

Controllers as Living Interpreters of Intent

A controller is the interpreter that turns declarations into durable outcomes—if it is designed to survive conflict and load.

Advanced Disciplines

Codex Gigas

Network Policy and the Discipline of Isolation

Isolation is not paranoia; it is how you keep a single compromised workload from becoming a platform incident.

Advanced Disciplines

Codex Gigas

Ingress, Egress, and the Borders of the Mesh

Ingress is not a convenience; it is the public boundary of your system. Egress is the boundary you forget until it becomes the breach.

Advanced Disciplines

Codex Gigas

StatefulSets and the Burden of Memory

StatefulSets are not Deployments with disks. They encode identity and order—and therefore encode risk.

Advanced Disciplines

Codex Gigas

DaemonSets and the Ministry of Every Node

DaemonSets are the cluster’s distributed nervous tissue. When they fail, every node feels it.

Advanced Disciplines

Codex Gigas

Probes, Liveness, Readiness, and the Test of Worthiness

A probe is a contract between the workload and the cluster. Poor probes turn minor latency into systemic failure.

Advanced Disciplines

Codex Gigas

HPA, VPA, and the Limits of Elasticity

Elasticity is not free. It is a control system built on noisy signals and hard limits.

Advanced Disciplines

Codex Gigas

Cluster Autoscaling and the Economics of Expansion

Adding nodes is not ‘scale.’ It is a controlled expansion of failure domains, cost, and operational surface area.

Advanced Disciplines

Codex Gigas

Multi-Cluster Federation and the Politics of Sovereignty

Multi-cluster is not an architecture trophy. It is an institutional choice to pay governance costs for reduced blast radius and improved locality.

Advanced Disciplines

Codex Gigas

GitOps as Liturgical Deployment

GitOps is the practice of writing intent where it can be audited, reconciled, and recovered. It is deployment as ceremony: repeatable, reviewed, and recorded.

Advanced Disciplines

Codex Gigas

Observability as Revelation

Observability is the discipline of evidence. Without it, incident response becomes storytelling.

Advanced Disciplines

Codex Gigas

Traces, Metrics, and the Reading of Omens

Telemetry is a system. If you do not govern cardinality and cost, observability becomes its own outage.

Advanced Disciplines

Codex Gigas

Upgrade Strategy and the Ritual of Continuity

Upgrades are inevitable. The ritual is continuity: the platform changes while service remains intact.

Advanced Disciplines

Codex Gigas

Runtime Security and the Defense of the Sacred Plane

Security is not a feature; it is an operational discipline. Controls must be enforceable and survivable under load.

Advanced Disciplines

Codex Gigas

Supply Chain Integrity and the Lineage of Artifacts

Your cluster runs what your pipeline produces. If lineage is unclear, you cannot prove what you deployed.

Advanced Disciplines

Codex Gigas

The Dark Order’s Guide to Observability in Kubernetes

Observability is not dashboards. It is the discipline of evidence: the ability to prove what happened, what changed, and why the system behaved as it did.

Advanced Disciplines

Codex Gigas

The Ritual of Safe Cluster Upgrades

Upgrades are not events. They are a governance loop: preflight, stage, validate, and preserve reversibility under pressure.

Advanced Disciplines

Codex Gigas

Debugging the Control Plane Under Pressure

The control plane fails quietly, then all at once. Debugging it requires you to reduce churn, read saturation signals, and avoid write amplification.

Advanced Disciplines

Codex Gigas

GitOps Beyond Ceremony: Where Declarative Systems Break

GitOps is powerful because it makes intent legible. It fails when intent is ambiguous, ownership is unclear, and emergency changes are not governed.

Advanced Disciplines

Codex Gigas

Capacity, Bin Packing, and the Lies We Tell the Scheduler

The scheduler is not a magician. It places pods based on the numbers you give it. When those numbers are lies, placement becomes a slow-motion incident.

Advanced Disciplines

Codex Gigas

AI Inference on Kubernetes: Latency, Cost, and Operational Reality

Inference is a production system with hard budgets: p99 latency, cost per request, and controlled degradation under load. Kubernetes can host it—if you respect scarcity and failure modes.

Advanced Disciplines

Codex Gigas

The Dark Arts of Rollout Safety

Safe rollouts are engineered: explicit health signals, bounded blast radius, and stop-loss thresholds tied to SLOs—not optimism tied to dashboards.

Advanced Disciplines

Codex Gigas

Upgrade Windows, Rollback Reality, and the Myth of Zero Risk

Zero risk is not a promise; it is an unpriced liability. Upgrade windows exist to concentrate attention where systems are most fragile: the boundary between versions.

Advanced Disciplines

Codex Gigas

The Scheduler Under Scarcity: Priority, Preemption, and Hard Choices

When capacity is insufficient, the scheduler becomes governance. Priority and preemption encode institutional values: who runs, who waits, and who is displaced.

Advanced Disciplines

Codex Gigas

Practical Heuristics for Multi-Cluster Fleet Management

Fleet management is about reducing cognitive load: consistent baselines, clear ownership, and operational tooling that preserves attribution across boundaries.

Advanced Disciplines

Codex Gigas

Latency Budgets for Inference Systems Running on Kubernetes

Inference fails at the tail. A latency budget is doctrine: a written allocation of time across the request path, enforced by scaling, shedding, and controlled degradation.

Advanced Disciplines

Codex Gigas

Deployments, ReplicaSets, and Rollout Semantics

Rollouts are control loops with gates. Learn the gates, then design rollouts that preserve availability and attribution.

Advanced Disciplines

Codex Gigas

Jobs, CronJobs, and Operational Workflows

Batch workloads are where retries become storms. Learn Job and CronJob semantics, then design workflows that don’t amplify failure.

Advanced Disciplines

Codex Gigas

Resource Requests, Limits, and Scheduling Tradeoffs

Requests are promises. Limits are constraints. Misusing either creates clusters that lie about capacity and workloads that fail when load arrives.

Section

Rites & Trials

2 texts

Marker

Section

Canonical Texts

7 texts

Marker

Canonical Texts

Codex Gigas

Incident Response as a Trial of Faith

Incidents reveal the true governance of your platform: who can act, what can be changed, and whether your system can recover with discipline.

Canonical Texts

Codex Gigas

The Final Sermon on Resilience and Failure

Resilience is not optimism. It is engineered humility: bounded blast radius, observable truth, and a platform that can return to intent.

Canonical Texts

Codex Gigas

Kubblai Doctrine: Cluster Discipline and Operational Safety

Operational safety is not a mood. It is a set of constraints and practices that keep change survivable and failure contained.

Canonical Texts

Codex Gigas

Observability for People Who Actually Carry the Pager

If observability does not change decisions during an incident, it is decoration. Signal must be tied to failure modes and owned by the people who respond.

Canonical Texts

Codex Gigas

Principal Lessons on Kubernetes API Design and CRD Discipline

A CRD is not a schema. It is a contract between humans, controllers, and the control plane. The strongest designs assume failure and make drift legible.

Canonical Texts

Codex Gigas

CRD Lifecycle Discipline for Teams That Intend to Survive

A CRD becomes a platform contract. Lifecycle discipline is how you keep that contract stable through upgrades, incidents, and team turnover.

Canonical Texts

Codex Gigas

kubectl Debugging Workflows That Actually Matter

kubectl is not a spellbook. It is an instrument. Learn a small number of workflows that reliably surface truth when the cluster is stressed.

Section

Dark Council

1 texts

Marker

Section

Join & Initiation

2 texts

Marker

Paths for followers

A crawlable path through doctrine, fundamentals, and initiation.

This shrine is selective in tone, not coercive in behavior. No demands. No dependency. The standard is simply high: disciplined study and honest operational practice.

Archive count: 74 writings.