[{"data":1,"prerenderedAt":394},["ShallowReactive",2],{"navigation_docs_en":3,"-en-reference-v1-vs-v2":225,"-en-reference-v1-vs-v2-surround":389},[4,25,41,66,85,140,167,181,195],{"title":5,"path":6,"stem":7,"children":8,"icon":10},"Quickstart","\u002Fen\u002Fquickstart","en\u002F1.quickstart\u002F1.index",[9,11,16,20],{"title":5,"path":6,"stem":7,"icon":10},"i-lucide-rocket",{"title":12,"path":13,"stem":14,"icon":15},"Installation","\u002Fen\u002Fquickstart\u002Finstallation","en\u002F1.quickstart\u002F2.installation","i-lucide-download",{"title":17,"path":18,"stem":19,"icon":10},"First Bridge","\u002Fen\u002Fquickstart\u002Ffirst-bridge","en\u002F1.quickstart\u002F3.first-bridge",{"title":21,"path":22,"stem":23,"icon":24},"Docker Desktop Extension","\u002Fen\u002Fquickstart\u002Fdocker-desktop-extension","en\u002F1.quickstart\u002F4.docker-desktop-extension","i-simple-icons-docker",{"title":26,"path":27,"stem":28,"children":29,"page":40},"Ai Agents","\u002Fen\u002Fai-agents","en\u002F2.ai-agents",[30,35],{"title":31,"path":32,"stem":33,"icon":34},"Cluster Ground Truth","\u002Fen\u002Fai-agents\u002Fcluster-ground-truth","en\u002F2.ai-agents\u002F1.cluster-ground-truth","i-lucide-bot",{"title":36,"path":37,"stem":38,"icon":39},"Agent Workflows","\u002Fen\u002Fai-agents\u002Fagent-workflows","en\u002F2.ai-agents\u002F2.agent-workflows","i-lucide-workflow",false,{"title":42,"path":43,"stem":44,"children":45,"page":40},"Developer Workflows","\u002Fen\u002Fdeveloper-workflows","en\u002F3.developer-workflows",[46,51,56,61],{"title":47,"path":48,"stem":49,"icon":50},"Hot Reloading","\u002Fen\u002Fdeveloper-workflows\u002Fhot-reloading","en\u002F3.developer-workflows\u002F1.hot-reloading","i-lucide-zap",{"title":52,"path":53,"stem":54,"icon":55},"IDE Debugging","\u002Fen\u002Fdeveloper-workflows\u002Fide-debugging","en\u002F3.developer-workflows\u002F2.ide-debugging","i-lucide-bug",{"title":57,"path":58,"stem":59,"icon":60},"Run vs. Bridge","\u002Fen\u002Fdeveloper-workflows\u002Fbridge-vs-run","en\u002F3.developer-workflows\u002F3.bridge-vs-run","i-lucide-git-compare-arrows",{"title":62,"path":63,"stem":64,"icon":65},"Database and DNS","\u002Fen\u002Fdeveloper-workflows\u002Fdatabase-and-dns","en\u002F3.developer-workflows\u002F4.database-and-dns","i-lucide-database",{"title":67,"path":68,"stem":69,"children":70,"page":40},"Team And Enterprise","\u002Fen\u002Fteam-and-enterprise","en\u002F4.team-and-enterprise",[71,75,80],{"title":72,"path":73,"stem":74,"icon":10},"Getting Started","\u002Fen\u002Fteam-and-enterprise\u002Fshared-staging-clusters","en\u002F4.team-and-enterprise\u002F1.shared-staging-clusters",{"title":76,"path":77,"stem":78,"icon":79},"Managing Gefyra Clients","\u002Fen\u002Fteam-and-enterprise\u002Frbac-and-security","en\u002F4.team-and-enterprise\u002F2.rbac-and-security","i-lucide-computer",{"title":81,"path":82,"stem":83,"icon":84},"CI Cost Reduction","\u002Fen\u002Fteam-and-enterprise\u002Fci-cost-reduction","en\u002F4.team-and-enterprise\u002F3.ci-cost-reduction","i-lucide-trending-down",{"title":86,"path":87,"stem":88,"children":89,"page":40},"Cluster Guides","\u002Fen\u002Fcluster-guides","en\u002F5.cluster-guides",[90,116,121],{"title":91,"path":92,"stem":93,"children":94,"page":40},"Local Clusters","\u002Fen\u002Fcluster-guides\u002Flocal-clusters","en\u002F5.cluster-guides\u002F1.local-clusters",[95,100,104,108,112],{"title":96,"path":97,"stem":98,"icon":99},"Colima Kubernetes","\u002Fen\u002Fcluster-guides\u002Flocal-clusters\u002Fcolima","en\u002F5.cluster-guides\u002F1.local-clusters\u002F1.colima","i-simple-icons-kubernetes",{"title":101,"path":102,"stem":103,"icon":24},"Docker Desktop Kubernetes (OSX)","\u002Fen\u002Fcluster-guides\u002Flocal-clusters\u002Fdocker-desktop","en\u002F5.cluster-guides\u002F1.local-clusters\u002F2.docker-desktop",{"title":105,"path":106,"stem":107},"k3d","\u002Fen\u002Fcluster-guides\u002Flocal-clusters\u002Fk3d","en\u002F5.cluster-guides\u002F1.local-clusters\u002F3.k3d",{"title":109,"path":110,"stem":111},"kind","\u002Fen\u002Fcluster-guides\u002Flocal-clusters\u002Fkind","en\u002F5.cluster-guides\u002F1.local-clusters\u002F4.kind",{"title":113,"path":114,"stem":115,"icon":99},"minikube","\u002Fen\u002Fcluster-guides\u002Flocal-clusters\u002Fminikube","en\u002F5.cluster-guides\u002F1.local-clusters\u002F5.minikube",{"title":117,"path":118,"stem":119,"icon":120},"Overview","\u002Fen\u002Fcluster-guides\u002Foverview","en\u002F5.cluster-guides\u002F1.overview","i-lucide-network",{"title":122,"path":123,"stem":124,"children":125,"page":40},"Remote Clouds","\u002Fen\u002Fcluster-guides\u002Fremote-clouds","en\u002F5.cluster-guides\u002F2.remote-clouds",[126,131,136],{"title":127,"path":128,"stem":129,"icon":130},"Google Cloud Platform (GCP)","\u002Fen\u002Fcluster-guides\u002Fremote-clouds\u002Fgke","en\u002F5.cluster-guides\u002F2.remote-clouds\u002F1.gke","i-material-icon-theme:gcp",{"title":132,"path":133,"stem":134,"icon":135},"Elastic Kubernetes Service (EKS)","\u002Fen\u002Fcluster-guides\u002Fremote-clouds\u002Feks","en\u002F5.cluster-guides\u002F2.remote-clouds\u002F2.eks","i-simple-icons-amazoneks",{"title":137,"path":138,"stem":139,"icon":99},"SysEleven MetaKube","\u002Fen\u002Fcluster-guides\u002Fremote-clouds\u002Fsyseleven","en\u002F5.cluster-guides\u002F2.remote-clouds\u002F3.syseleven",{"title":141,"path":142,"stem":143,"children":144,"page":40},"Use Cases and Demos","\u002Fen\u002Fusecases-and-demos","en\u002F5.usecases-and-demos",[145,148,153,158,162],{"title":72,"path":146,"stem":147,"icon":10},"\u002Fen\u002Fusecases-and-demos\u002Fgetting-started","en\u002F5.usecases-and-demos\u002F1.getting-started",{"title":149,"path":150,"stem":151,"icon":152},"Developing Go Applications with Gefyra","\u002Fen\u002Fusecases-and-demos\u002Fgolang","en\u002F5.usecases-and-demos\u002F2.golang","i-simple-icons-go",{"title":154,"path":155,"stem":156,"icon":157},"OAuth2 Demo with a Sidecar","\u002Fen\u002Fusecases-and-demos\u002Foauth2-demo","en\u002F5.usecases-and-demos\u002F3.oauth2-demo","i-devicon-plain:oauth",{"title":159,"path":160,"stem":161,"icon":130},"Remote Development on Google Kubernetes Engine","\u002Fen\u002Fusecases-and-demos\u002Fremote-gke","en\u002F5.usecases-and-demos\u002F4.remote-gke",{"title":163,"path":164,"stem":165,"icon":166},"Run an Ubuntu Container instance","\u002Fen\u002Fusecases-and-demos\u002Fubuntu-in-namespace","en\u002F5.usecases-and-demos\u002F5.ubuntu-in-namespace","i-simple-icons-ubuntu",{"title":168,"path":169,"stem":170,"children":171,"page":40},"Architecture","\u002Fen\u002Farchitecture","en\u002F6.architecture",[172,176],{"title":168,"path":173,"stem":174,"icon":175},"\u002Fen\u002Farchitecture\u002Fhow-gefyra-works","en\u002F6.architecture\u002F1.how-gefyra-works","i-lucide-square-chevron-right",{"title":177,"path":178,"stem":179,"icon":180},"Gefyra Components","\u002Fen\u002Farchitecture\u002Fcomponents","en\u002F6.architecture\u002F2.components","i-lucide-circle-question-mark",{"title":182,"path":183,"stem":184,"children":185,"page":40},"Comparisons","\u002Fen\u002Fcomparisons","en\u002F7.comparisons",[186,191],{"title":187,"path":188,"stem":189,"icon":190},"Gefyra vs. Telepresence","\u002Fen\u002Fcomparisons\u002Fgefyra-vs-telepresence","en\u002F7.comparisons\u002F1.gefyra-vs-telepresence","i-lucide-git-compare",{"title":192,"path":193,"stem":194,"icon":190},"Gefyra vs. mirrord","\u002Fen\u002Fcomparisons\u002Fgefyra-vs-mirrord","en\u002F7.comparisons\u002F2.gefyra-vs-mirrord",{"title":196,"path":197,"stem":198,"children":199,"page":40},"Reference","\u002Fen\u002Freference","en\u002F8.reference",[200,205,210,215,220],{"title":201,"path":202,"stem":203,"icon":204},"CLI","\u002Fen\u002Freference\u002Fcli","en\u002F8.reference\u002F1.cli","i-lucide-square-terminal",{"title":206,"path":207,"stem":208,"icon":209},"CRD Reference","\u002Fen\u002Freference\u002Fcrd-reference","en\u002F8.reference\u002F2.crd-reference","i-lucide-file-code",{"title":211,"path":212,"stem":213,"icon":214},"What changed in Gefyra 2?","\u002Fen\u002Freference\u002Fv1-vs-v2","en\u002F8.reference\u002F3.v1-vs-v2","i-lucide-history",{"title":216,"path":217,"stem":218,"icon":219},"Media","\u002Fen\u002Freference\u002Fmedia","en\u002F8.reference\u002F4.media","i-lucide-play",{"title":221,"path":222,"stem":223,"icon":224},"About","\u002Fen\u002Freference\u002Fabout","en\u002F8.reference\u002F5.about","i-lucide-info",{"id":226,"title":227,"body":228,"description":382,"extension":383,"links":384,"meta":385,"navigation":386,"path":212,"seo":387,"stem":213,"__hash__":388},"docs_en\u002Fen\u002F8.reference\u002F3.v1-vs-v2.md","What Changed Between Gefyra v1 and Gefyra v2?",{"type":229,"value":230,"toc":369},"minimark",[231,235,238,243,257,274,278,281,314,317,321,327,331,338,358,362],[232,233,234],"p",{},"Gefyra 2 represents a complete architectural rewrite designed for enterprise stability, multi-developer scaling, and decoupled workload interception.",[236,237],"hr",{},[239,240,242],"h2",{"id":241},"key-architectural-enhancements","Key Architectural Enhancements",[244,245,247,248,252,253,256],"h3",{"id":246},"_1-state-machine-driven-operator-kopf-python-statemachine","1. State-Machine Driven Operator (",[249,250,251],"code",{},"kopf"," + ",[249,254,255],{},"python-statemachine",")",[232,258,259,260,263,264,263,267,263,270,273],{},"Gefyra 1 relied on simple reactive loops that could get stuck in race conditions during rapid pod rollouts. Gefyra 2 rebuilds the cluster operator around a formal asynchronous state engine. Every transition (",[249,261,262],{},"REQUESTED"," ➔ ",[249,265,266],{},"INSTALLING",[249,268,269],{},"ACTIVE",[249,271,272],{},"ROLLING_BACK",") is tracked deterministically with automated retry mechanisms and self-healing rollbacks.",[244,275,277],{"id":276},"_2-three-decoupled-custom-resources","2. Three Decoupled Custom Resources",[232,279,280],{},"In Gefyra 1, bridging was a monolithic operation. Gefyra 2 decouples operations into three distinct Custom Resources:",[282,283,284,294,306],"ul",{},[285,286,287,293],"li",{},[288,289,290],"strong",{},[249,291,292],{},"GefyraClient",": Manages developer authentication, dedicated ServiceAccounts, and WireGuard credentials.",[285,295,296,301,302,305],{},[288,297,298],{},[249,299,300],{},"GefyraBridgeMount",": Manages the injection of the ",[288,303,304],{},"Carrier2"," proxy sidecar into target Kubernetes workloads.",[285,307,308,313],{},[288,309,310],{},[249,311,312],{},"GefyraBridge",": Associates an active mount with a specific developer client.",[232,315,316],{},"This decoupling allows a workload mount to stay in place while multiple developers connect, disconnect, or swap routes with zero downtime for the underlying pod.",[244,318,320],{"id":319},"_3-carrier2-high-performance-proxying","3. Carrier2 High-Performance Proxying",[232,322,323,324,326],{},"Gefyra 2 replaces the legacy interception daemon with ",[288,325,304],{},", a high-performance proxy written in Rust. Carrier2 supports bidirectional stream proxying, TLS SNI routing, and low-latency packet forwarding between remote cluster pods and local developer containers.",[244,328,330],{"id":329},"_4-fine-grained-access-management-enterprise-rbac","4. Fine-Grained Access Management & Enterprise RBAC",[232,332,333,334,337],{},"In Gefyra 1, ",[249,335,336],{},"gefyra up"," assumed cluster-admin access. Gefyra 2 splits operations into:",[282,339,340,346,352],{},[285,341,342,345],{},[249,343,344],{},"gefyra install",": Admin action to deploy operator and Stowaway gateway.",[285,347,348,351],{},[249,349,350],{},"gefyra clients create",": Platform lead issues client credentials for a specific namespace.",[285,353,354,357],{},[249,355,356],{},"gefyra connections connect",": Developer connects using scoped ServiceAccount tokens without requiring cluster-admin permissions.",[244,359,361],{"id":360},"_5-click-powered-tui-rich-cli","5. Click-Powered TUI & Rich CLI",[232,363,364,365,368],{},"The Gefyra CLI was completely rewritten using Python's ",[288,366,367],{},"Click"," framework with Rich console outputs, interactive progress bars, and structured status reports.",{"title":370,"searchDepth":371,"depth":371,"links":372},"",2,[373],{"id":241,"depth":371,"text":242,"children":374},[375,378,379,380,381],{"id":246,"depth":376,"text":377},3,"1. State-Machine Driven Operator (kopf + python-statemachine)",{"id":276,"depth":376,"text":277},{"id":319,"depth":376,"text":320},{"id":329,"depth":376,"text":330},{"id":360,"depth":376,"text":361},"Explore the architectural evolution of Gefyra 2. State-machine driven operator, decoupled BridgeMounts, fine-grained RBAC client management, and Carrier2 proxying.","md",null,{},{"title":211,"icon":214},{"title":227,"description":382},"PNjThZoKhO1Jt0vh7b_Ki9aVvuMMUq2JUXWqjPQCaRc",[390,392],{"title":206,"path":207,"stem":208,"description":391,"icon":209,"children":-1},"Complete reference for Gefyra's Kubernetes Custom Resources (GefyraBridge, GefyraClient, GefyraBridgeMount). API schemas, states, and YAML manifests.",{"title":216,"path":217,"stem":218,"description":393,"icon":219,"children":-1},"Talks, videos, podcasts, and articles about Gefyra and Kubernetes local development.",1795114695800]