[{"data":1,"prerenderedAt":485},["ShallowReactive",2],{"navigation":3,"\u002Fdelivery\u002Fruntime-clusters":250,"\u002Fdelivery\u002Fruntime-clusters-surround":480},[4,28,56,91,117,135,169,224],{"title":5,"path":6,"stem":7,"children":8,"icon":27},"Start here","\u002Fgetting-started","1.getting-started\u002F1.index",[9,11,15,19,23],{"title":10,"path":6,"stem":7},"Introduction",{"title":12,"path":13,"stem":14},"Decisions and open gates","\u002Fgetting-started\u002Fdecisions","1.getting-started\u002F2.decisions",{"title":16,"path":17,"stem":18},"Scope and non-goals","\u002Fgetting-started\u002Fscope","1.getting-started\u002F3.scope",{"title":20,"path":21,"stem":22},"Organization pilot","\u002Fgetting-started\u002Fpilot","1.getting-started\u002F4.pilot",{"title":24,"path":25,"stem":26},"Economics and quotas","\u002Fgetting-started\u002Feconomics","1.getting-started\u002F5.economics","i-lucide-compass",{"title":29,"path":30,"stem":31,"children":32,"icon":55},"Architecture","\u002Farchitecture","2.architecture\u002F1.index",[33,35,39,43,47,51],{"title":34,"path":30,"stem":31},"System architecture",{"title":36,"path":37,"stem":38},"Trust zones","\u002Farchitecture\u002Ftrust-zones","2.architecture\u002F2.trust-zones",{"title":40,"path":41,"stem":42},"Control plane","\u002Farchitecture\u002Fcontrol-plane","2.architecture\u002F3.control-plane",{"title":44,"path":45,"stem":46},"Organization tenancy","\u002Farchitecture\u002Ftenancy","2.architecture\u002F4.tenancy",{"title":48,"path":49,"stem":50},"Core data model","\u002Farchitecture\u002Fdata-model","2.architecture\u002F5.data-model",{"title":52,"path":53,"stem":54},"Codebase organization","\u002Farchitecture\u002Fcodebase","2.architecture\u002F6.codebase","i-lucide-layers",{"title":57,"icon":58,"path":59,"stem":60,"children":61,"page":90},"Identity and security","i-lucide-shield-check","\u002Fsecurity","3.security",[62,66,70,74,78,82,86],{"title":63,"path":64,"stem":65},"Identity and sessions","\u002Fsecurity\u002Fidentity","3.security\u002F1.identity",{"title":67,"path":68,"stem":69},"Domains and TLS","\u002Fsecurity\u002Fdomains","3.security\u002F2.domains",{"title":71,"path":72,"stem":73},"Ingress and egress","\u002Fsecurity\u002Fnetworking","3.security\u002F3.networking",{"title":75,"path":76,"stem":77},"Access policies and WAF-lite","\u002Fsecurity\u002Faccess-policies","3.security\u002F4.access-policies",{"title":79,"path":80,"stem":81},"Secrets and integrations","\u002Fsecurity\u002Fsecrets-integrations","3.security\u002F5.secrets-integrations",{"title":83,"path":84,"stem":85},"Governance and ownership","\u002Fsecurity\u002Fgovernance","3.security\u002F6.governance",{"title":87,"path":88,"stem":89},"Threat model","\u002Fsecurity\u002Fthreat-model","3.security\u002F7.threat-model",false,{"title":92,"icon":93,"path":94,"stem":95,"children":96,"page":90},"Building applications","i-lucide-code","\u002Fdevelopment","4.development",[97,101,105,109,113],{"title":98,"path":99,"stem":100},"AI and MCP","\u002Fdevelopment\u002Fai-mcp","4.development\u002F1.ai-mcp",{"title":102,"path":103,"stem":104},"Source control","\u002Fdevelopment\u002Fsource-control","4.development\u002F2.source-control",{"title":106,"path":107,"stem":108},"Sandboxed builds","\u002Fdevelopment\u002Fbuilds","4.development\u002F3.builds",{"title":110,"path":111,"stem":112},"Runtime contract and SDK","\u002Fdevelopment\u002Fruntime-contract","4.development\u002F4.runtime-contract",{"title":114,"path":115,"stem":116},"APIs and protocols","\u002Fdevelopment\u002Fapi","4.development\u002F5.api",{"title":118,"icon":119,"path":120,"stem":121,"children":122,"page":90},"Runtime and delivery","i-lucide-rocket","\u002Fdelivery","5.delivery",[123,127,131],{"title":124,"path":125,"stem":126},"Runtime clusters and previews","\u002Fdelivery\u002Fruntime-clusters","5.delivery\u002F1.runtime-clusters",{"title":128,"path":129,"stem":130},"Deployments and approvals","\u002Fdelivery\u002Fdeployments","5.delivery\u002F2.deployments",{"title":132,"path":133,"stem":134},"Databases and recovery","\u002Fdelivery\u002Fdata-recovery","5.delivery\u002F3.data-recovery",{"title":136,"icon":137,"path":138,"stem":139,"children":140,"page":90},"Operations","i-lucide-activity","\u002Foperations","6.operations",[141,145,149,153,157,161,165],{"title":142,"path":143,"stem":144},"Observability and audit","\u002Foperations\u002Fobservability","6.operations\u002F1.observability",{"title":146,"path":147,"stem":148},"Operating model","\u002Foperations\u002Foperating-model","6.operations\u002F2.operating-model",{"title":150,"path":151,"stem":152},"Deploy and roll back","\u002Foperations\u002Fdeploy-rollback","6.operations\u002F3.deploy-rollback",{"title":154,"path":155,"stem":156},"Back up and restore","\u002Foperations\u002Fbackup-restore","6.operations\u002F4.backup-restore",{"title":158,"path":159,"stem":160},"Upgrade and patch","\u002Foperations\u002Fupgrades","6.operations\u002F5.upgrades",{"title":162,"path":163,"stem":164},"Rotate keys and credentials","\u002Foperations\u002Fkey-rotation","6.operations\u002F6.key-rotation",{"title":166,"path":167,"stem":168},"Incidents and access revocation","\u002Foperations\u002Fincidents","6.operations\u002F7.incidents",{"title":170,"path":171,"stem":172,"children":173,"icon":223},"Implementation plan","\u002Froadmap","7.roadmap\u002F01.index",[174,175,179,183,187,191,195,199,203,207,211,215,219],{"title":170,"path":171,"stem":172},{"title":176,"path":177,"stem":178},"Phase 0: architecture spikes and ADRs","\u002Froadmap\u002Fphase-0","7.roadmap\u002F02.phase-0",{"title":180,"path":181,"stem":182},"Phase 1: control-plane foundation","\u002Froadmap\u002Fphase-1","7.roadmap\u002F03.phase-1",{"title":184,"path":185,"stem":186},"Phase 2: managed source and change sets","\u002Froadmap\u002Fphase-2","7.roadmap\u002F04.phase-2",{"title":188,"path":189,"stem":190},"Phase 3: sandboxed build system","\u002Froadmap\u002Fphase-3","7.roadmap\u002F05.phase-3",{"title":192,"path":193,"stem":194},"Phase 4: runtime and data plane","\u002Froadmap\u002Fphase-4","7.roadmap\u002F06.phase-4",{"title":196,"path":197,"stem":198},"Phase 5: deployment, preview, migration, and recovery","\u002Froadmap\u002Fphase-5","7.roadmap\u002F07.phase-5",{"title":200,"path":201,"stem":202},"Phase 6: Entra identity and security policy","\u002Froadmap\u002Fphase-6","7.roadmap\u002F08.phase-6",{"title":204,"path":205,"stem":206},"Phase 7: MCP and AI-native workflow","\u002Froadmap\u002Fphase-7","7.roadmap\u002F09.phase-7",{"title":208,"path":209,"stem":210},"Phase 8: Pilot hardening","\u002Froadmap\u002Fphase-8","7.roadmap\u002F10.phase-8",{"title":212,"path":213,"stem":214},"Phase 9: developer hybrid and v1 GA","\u002Froadmap\u002Fphase-9","7.roadmap\u002F11.phase-9",{"title":216,"path":217,"stem":218},"Test strategy","\u002Froadmap\u002Ftesting","7.roadmap\u002F12.testing",{"title":220,"path":221,"stem":222},"Definition of done","\u002Froadmap\u002Fdefinition-of-done","7.roadmap\u002F13.definition-of-done","i-lucide-list-checks",{"title":225,"icon":226,"path":227,"stem":228,"children":229,"page":90},"Reference","i-lucide-book-open","\u002Freference","8.reference",[230,234,238,242,246],{"title":231,"path":232,"stem":233},"Plan coverage","\u002Freference\u002Fplan-coverage","8.reference\u002F1.plan-coverage",{"title":235,"path":236,"stem":237},"Decision register","\u002Freference\u002Fdecisions","8.reference\u002F2.decisions",{"title":239,"path":240,"stem":241},"Glossary","\u002Freference\u002Fglossary","8.reference\u002F3.glossary",{"title":243,"path":244,"stem":245},"Sources","\u002Freference\u002Fsources","8.reference\u002F4.sources",{"title":247,"path":248,"stem":249},"Contributing and docs access","\u002Freference\u002Fcontributing","8.reference\u002F5.contributing",{"id":251,"title":124,"body":252,"description":473,"extension":474,"links":475,"meta":476,"navigation":477,"path":125,"seo":478,"stem":126,"__hash__":479},"docs\u002F5.delivery\u002F1.runtime-clusters.md",{"type":253,"value":254,"toc":461},"minimark",[255,271,276,279,282,285,296,300,303,334,337,341,344,350,353,356,360,363,369,372,376,379,405,408,414,417,421,424,427,431,434,440,443,446,450],[256,257,258],"note",{},[259,260,261,265,266,270],"p",{},[262,263,264],"strong",{},"v1 design baseline."," This page specifies intended behavior. Delivery and validation are tracked in the ",[267,268,269],"a",{"href":171},"implementation plan","; it is not a claim that the platform is already implemented.",[272,273,275],"h2",{"id":274},"reference-substrate","Reference substrate",[259,277,278],{},"The v1 reference runtime cluster uses Kubernetes or a compatible lightweight distribution as an internal implementation detail.",[259,280,281],{},"Do not expose Kubernetes concepts to customers.",[259,283,284],{},"Node pools:",[286,287,293],"pre",{"className":288,"code":290,"language":291,"meta":292},[289],"language-text","gateway nodes\nruntime sandbox nodes\nbuild sandbox nodes\ndata-service nodes\nobservability\u002Fmanagement nodes\n","text","",[294,295,290],"code",{"__ignoreMap":292},[272,297,299],{"id":298},"runtime-agent","Runtime agent",[259,301,302],{},"Each cluster runs an intrnl runtime agent that:",[304,305,306,310,313,316,319,322,325,328,331],"ul",{},[307,308,309],"li",{},"Establishes outbound mTLS to the control plane",[307,311,312],{},"Registers cluster identity and capabilities",[307,314,315],{},"Receives desired state",[307,317,318],{},"Acknowledges commands",[307,320,321],{},"Reconciles workloads",[307,323,324],{},"Reports health and capacity",[307,326,327],{},"Streams deployment\u002Fbuild state",[307,329,330],{},"Rotates workload certificates",[307,332,333],{},"Never exposes a public cluster-admin API",[259,335,336],{},"No inbound SSH or Kubernetes API access is needed from the central control plane.",[272,338,340],{"id":339},"per-app-sandbox","Per-app sandbox",[259,342,343],{},"V1 uses one sandbox boundary per app environment.",[286,345,348],{"className":346,"code":347,"language":291,"meta":292},[289],"app production\n└── OS\u002FVM sandbox\n    └── workerd process\n\napp preview A\n└── OS\u002FVM sandbox\n    └── workerd process\n",[294,349,347],{"__ignoreMap":292},[259,351,352],{},"A production environment may have multiple stateless replicas behind the gateway.",[259,354,355],{},"Do not co-locate trusted intrnl services and untrusted application code inside the same sandbox.",[272,357,359],{"id":358},"activation-model","Activation model",[259,361,362],{},"Use blue\u002Fgreen revision activation:",[286,364,367],{"className":365,"code":366,"language":291,"meta":292},[289],"Current revision A is serving\n        ↓\nFetch revision B and verify signature\n        ↓\nStart verified revision B workload\n        ↓\nRun health check\n        ↓\nAtomically change route pointer A → B\n        ↓\nDrain A\n        ↓\nRetain A for rollback window\n",[294,368,366],{"__ignoreMap":292},[259,370,371],{},"A failed health check leaves revision A active.",[272,373,375],{"id":374},"preview-environments","Preview environments",[259,377,378],{},"A preview consists of:",[304,380,381,384,387,390,393,396,399,402],{},[307,382,383],{},"Immutable source\u002Fbuild revision",[307,385,386],{},"Temporary app route",[307,388,389],{},"Separate runtime sandbox",[307,391,392],{},"Separate SQLite database",[307,394,395],{},"Separate KV namespace",[307,397,398],{},"Synthetic seed data",[307,400,401],{},"Restricted access policy",[307,403,404],{},"Expiration time",[259,406,407],{},"Preview access defaults to:",[286,409,412],{"className":410,"code":411,"language":291,"meta":292},[289],"creator\nexplicit reviewers\norganization administrators\n",[294,413,411],{"__ignoreMap":292},[259,415,416],{},"No production app user receives preview access implicitly.",[272,418,420],{"id":419},"scale-to-zero","Scale-to-zero",[259,422,423],{},"Preview environments may scale to zero after inactivity.",[259,425,426],{},"Production apps may eventually scale to zero, but the organization pilot should favor predictable availability over aggressive cost optimization.",[272,428,430],{"id":429},"static-routing","Static routing",[259,432,433],{},"The gateway keeps a locally cached route table:",[286,435,438],{"className":436,"code":437,"language":291,"meta":292},[289],"hostname\n→ organization\n→ application\n→ environment\n→ active artifact revision\n→ access policy version\n→ runtime workload\n",[294,439,437],{"__ignoreMap":292},[259,441,442],{},"The cache is signed\u002Fversioned and reconciled with the control plane.",[259,444,445],{},"An unknown or stale host never falls through to an arbitrary application.",[272,447,449],{"id":448},"related-documentation","Related documentation",[304,451,452,456],{},[307,453,454],{},[267,455,67],{"href":68},[307,457,458],{},[267,459,460],{"href":129},"Deployments",{"title":292,"searchDepth":462,"depth":463,"links":464},1,2,[465,466,467,468,469,470,471,472],{"id":274,"depth":463,"text":275},{"id":298,"depth":463,"text":299},{"id":339,"depth":463,"text":340},{"id":358,"depth":463,"text":359},{"id":374,"depth":463,"text":375},{"id":419,"depth":463,"text":420},{"id":429,"depth":463,"text":430},{"id":448,"depth":463,"text":449},"Cluster registration, app sandboxes, blue\u002Fgreen activation, isolated previews, and routing.","md",null,{},true,{"title":124,"description":473},"ovgfNeoNDcuNttpDSXjkNtN2kdBqA21XJN2B88BJ2CQ",[481,483],{"title":114,"path":115,"stem":116,"description":482,"children":-1},"Shared application services, REST requirements, MCP schemas, runtime commands, and webhooks.",{"title":128,"path":129,"stem":130,"description":484,"children":-1},"The immutable deployment chain, approval invalidation, readiness checks, and code rollback.",1790019415367]