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.
Curriculum
LearnLearning Path
A staged progression through fundamentals, practice, and deeper doctrine.
Navigation
MapsTopic maps
Curated shelves that connect doctrine to chapters, labs, and atlas entries.
Troubleshoot
AtlasTroubleshooting Atlas
Symptom-first entries with commands, causes, and safe resolutions.
Practice
LabsLabs
Hands-on exercises designed to build operator muscle memory.
Reference
TermsLexicon
Concise term definitions with operational meaning and related reading.
Topic maps
A richer index that stays readable.
Showing 12 of 12.
Topic map
MapFoundations
The objects are simple. The discipline is not. Build correct mental models: desired state, control loops, and the testimony of the API.
Topic map
MapWorkloads
Workload APIs are where intent becomes containers. Study the controllers, their guarantees, and the failure modes they hide until the pager rings.
Topic map
MapNetworking
Networking is rarely one thing. It is a chain: edge → controller → service → endpoints → pods → policy. Break the chain into proofs.
Topic map
MapConfiguration & Secrets
Configuration is the most common root cause of outages. Treat naming, keys, and wiring as first-class operational contracts.
Topic map
MapScheduling & Placement
Scheduling is economics and ethics: who runs where, at what cost, under what constraints, and what happens when scarcity arrives.
Topic map
MapStorage
Storage is slow to change and expensive to get wrong. Learn binding, provisioning controllers, and the constraints that govern state.
Topic map
MapOperations
Operations is not a bag of commands. It is a protocol: observe → narrow → act → confirm → memorialize.
Topic map
MapTroubleshooting
This shelf is built to be used mid-incident: symptom → what it means → proof commands → smallest safe fix → related doctrine.
Topic map
MapSecurity
Security is governance under constraints. The goal is stable trust boundaries, not performative controls that operators bypass under pressure.
Topic map
MapObservability
Observe to decide. Decide to change. If you change without evidence, you lose the only chance to learn.
Topic map
MapReference
A reference is only useful if it can be used mid-incident without ambiguity. This shelf is built for clarity and speed.
Topic map
MapLabs (Index)
Labs are doctrine made physical. Repeat the sequence until it becomes reflex.
Featured writings
A short shelf of texts to begin with.
Foundational doctrine
FeaturedWhat the Order Teaches About Kubernetes Control Planes
Truth, latency, admission, and the control loop that governs every other system.
Signal discipline
FeaturedThe Dark Order’s Guide to Observability in Kubernetes
Evidence-first telemetry: logs, metrics, traces, events, audit—and the failure modes that distort them.
Operational canon
FeaturedCluster Discipline and Operational Safety
How the Order treats change, rollback, governance, and incident procedure.
Archive index
74 writings · grouped by shelf
Section
Doctrine / Theology
7 texts
Doctrine / Theology
Codex GigasThe Doctrine of Reconciliation
Reconciliation is not a feature; it is the constitutional law of Kubernetes. The cluster stays honest by continuously closing the gap between intent and reality.
Doctrine / Theology
Codex GigasThe Control Loop as Sacred Law
Kubernetes is not orchestration by command; it is governance by feedback. The control loop is the unit of truth.
Doctrine / Theology
Codex GigasDesired State and the Theology of Convergence
Desired state is the platform’s highest-level claim. Convergence is the proof that the claim can survive reality.
Doctrine / Theology
Codex GigasOn Drift, Entropy, and the Burden of Configuration
Drift is not merely difference; it is accumulated uncertainty. Entropy grows wherever intent is not recorded and enforced.
Doctrine / Theology
Codex GigasWhat the Order Teaches About Kubernetes Control Planes
The control plane is the archive of truth: desired state, admission, reconciliation, and the constraints that govern everything else. Study it like doctrine—operate it like a finite system.
Doctrine / Theology
Codex GigasThe Heresies of Platform Engineering
A platform is an institution. Its failure modes look like ideology: hidden mutation, unowned guardrails, and bureaucracy disguised as safety.
Doctrine / Theology
Codex GigasHow Reconciliation Loops Fail in Practice
Controllers fail by thrashing, stalling, or lying. Mature operators read the shape of convergence: queue depth, reconcile duration, and conflict rates.
Section
Sacred Systems
10 texts
Sacred Systems
Codex GigasThe Hidden Burdens of etcd
etcd is where intent is stored. It is also where unbounded ambition becomes latency, instability, and collapse.
Sacred Systems
Codex GigasThe 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 GigasCNI 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 GigasCSI 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 GigasKubelet 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 GigasThe 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 GigasLabels, 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 GigasPod 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 GigasServices, 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 GigasDNS 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
Governance & Power
Codex GigasAdmission Control and the Rite of Judgment
Admission is where governance becomes enforceable. It is also a place where outages are born.
Governance & Power
Codex GigasPolicy as Doctrine, Not Suggestion
Policy is what makes a platform institutional. Without it, every incident is negotiated from scratch.
Governance & Power
Codex GigasNamespaces, 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 GigasSecrets, 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 GigasService 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 GigasRBAC and the Governance of Power
RBAC is the cluster’s constitution. Poorly written, it becomes silent catastrophe during incident response.
Governance & Power
Codex GigasPod 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 GigasThe 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 GigasThe Covenant of Cluster Stewards
Stewardship is a commitment to make systems legible and survivable. The covenant is the operator’s constitution.
Governance & Power
Codex GigasMulti-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 GigasSecrets, 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 GigasThe 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 GigasPlatform 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
Advanced Disciplines
Codex GigasThe 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 GigasTaints, 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 GigasCRDs as New Scripture
CRDs extend the cluster’s language. They also extend its liabilities: storage, watch load, and governance surface area.
Advanced Disciplines
Codex GigasControllers 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 GigasNetwork 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 GigasIngress, 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 GigasStatefulSets and the Burden of Memory
StatefulSets are not Deployments with disks. They encode identity and order—and therefore encode risk.
Advanced Disciplines
Codex GigasDaemonSets and the Ministry of Every Node
DaemonSets are the cluster’s distributed nervous tissue. When they fail, every node feels it.
Advanced Disciplines
Codex GigasProbes, 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 GigasHPA, 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 GigasCluster 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 GigasMulti-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 GigasGitOps 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 GigasObservability as Revelation
Observability is the discipline of evidence. Without it, incident response becomes storytelling.
Advanced Disciplines
Codex GigasTraces, 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 GigasUpgrade Strategy and the Ritual of Continuity
Upgrades are inevitable. The ritual is continuity: the platform changes while service remains intact.
Advanced Disciplines
Codex GigasRuntime 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 GigasSupply 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 GigasThe 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 GigasThe 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 GigasDebugging 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 GigasGitOps 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 GigasCapacity, 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 GigasAI 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 GigasThe 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 GigasUpgrade 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 GigasThe 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 GigasPractical 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 GigasLatency 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 GigasDeployments, ReplicaSets, and Rollout Semantics
Rollouts are control loops with gates. Learn the gates, then design rollouts that preserve availability and attribution.
Advanced Disciplines
Codex GigasJobs, 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 GigasResource 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
Rites & Trials
Codex GigasOn Call in the Dark Order: Kubernetes Failure Triage
When the pager rings, the rite is restraint: preserve evidence, choose reversible actions, and stabilize the control plane before you chase symptoms.
Rites & Trials
Codex GigasIncident Doctrine for Platform Teams
Platform incidents are governance incidents. The doctrine must define authority, evidence, safe mitigations, and how memory becomes guardrail.
Section
Canonical Texts
7 texts
Canonical Texts
Codex GigasIncident 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 GigasThe 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 GigasKubblai 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 GigasObservability 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 GigasPrincipal 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 GigasCRD 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 Gigaskubectl 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
Section
Join & Initiation
2 texts
Join & Initiation
Codex GigasThe Initiation Path to Kubblai
Entry is earned through competence and restraint. Initiation is a structured program of proofs, not a performance.
Join & Initiation
Codex GigasJoining the Order: Kubernetes, Platform Engineering, and Systems Doctrine
Joining is not a purchase and not a pitch. It is a commitment to disciplined study: governance, observability, safe change, and the humility to treat failure as a design input.
Paths for followers
A crawlable path through doctrine, fundamentals, and initiation.
Joining
PathJoining the Order
A structured path of study and discipline—clear standards, no performance.
Initiation
InitiationRequirements
What is expected: competence, restraint, and the ability to read systems under pressure.
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.