[{"data":1,"prerenderedAt":1423},["ShallowReactive",2],{"navigation_docs_en":3,"-en-reference-crd-reference":225,"-en-reference-crd-reference-surround":1418},[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":1411,"extension":1412,"links":1413,"meta":1414,"navigation":1415,"path":207,"seo":1416,"stem":208,"__hash__":1417},"docs_en\u002Fen\u002F8.reference\u002F2.crd-reference.md","Custom Resource Definition (CRD) Reference",{"type":229,"value":230,"toc":1392},"minimark",[231,240,282,285,293,299,343,348,518,522,637,639,645,654,685,688,822,825,927,929,935,946,977,980,1145,1148,1273,1275,1282,1288,1388],[232,233,234,235,239],"p",{},"Gefyra's Kubernetes operator manages its cluster-side lifecycle through three custom resources defined under the ",[236,237,238],"code",{},"gefyra.dev"," API group:",[241,242,243,257,268],"ol",{},[244,245,246,252,253,256],"li",{},[247,248,249],"strong",{},[236,250,251],{},"GefyraClient"," (",[236,254,255],{},"gefyraclients.gefyra.dev","): Represents an authorized developer workstation and its WireGuard connection parameters.",[244,258,259,252,264,267],{},[247,260,261],{},[236,262,263],{},"GefyraBridgeMount",[236,265,266],{},"gefyrabridgemounts.gefyra.dev","): Intercepts traffic at a specific container or workload by injecting the proxy sidecar.",[244,269,270,252,275,278,279,281],{},[247,271,272],{},[236,273,274],{},"GefyraBridge",[236,276,277],{},"gefyrabridges.gefyra.dev","): Binds a local developer container to an active ",[236,280,263],{}," to route traffic.",[283,284],"hr",{},[286,287,289,290,292],"h2",{"id":288},"_1-gefyraclient-gefyraclientsgefyradev","1. GefyraClient (",[236,291,255],{},")",[232,294,295,296,298],{},"A ",[236,297,251],{}," resource represents a developer workstation authorized to connect to the cluster.",[300,301,302,311,319,331],"ul",{},[244,303,304,307,308],{},[247,305,306],{},"Group:"," ",[236,309,310],{},"gefyra.dev\u002Fv1",[244,312,313,307,316],{},[247,314,315],{},"Kind:",[236,317,318],{},"gefyraclient",[244,320,321,307,324,327,328,292],{},[247,322,323],{},"Scope:",[236,325,326],{},"Namespaced"," (default namespace: ",[236,329,330],{},"gefyra",[244,332,333,307,336,339,340],{},[247,334,335],{},"Short Names:",[236,337,338],{},"gclient",", ",[236,341,342],{},"gclients",[344,345,347],"h3",{"id":346},"specification-fields","Specification & Fields",[349,350,351,368],"table",{},[352,353,354],"thead",{},[355,356,357,362,365],"tr",{},[358,359,361],"th",{"align":360},"left","Field",[358,363,364],{"align":360},"Type",[358,366,367],{"align":360},"Description",[369,370,371,394,409,423,437,462,477,492],"tbody",{},[355,372,373,379,384],{},[374,375,376],"td",{"align":360},[236,377,378],{},"provider",[374,380,381],{"align":360},[236,382,383],{},"string",[374,385,386,387,307,390,393],{"align":360},"Connection provider. Currently supported: ",[236,388,389],{},"stowaway",[247,391,392],{},"(required)",".",[355,395,396,401,406],{},[374,397,398],{"align":360},[236,399,400],{},"providerParameter",[374,402,403],{"align":360},[236,404,405],{},"object",[374,407,408],{"align":360},"Connection parameters for the provider.",[355,410,411,416,420],{},[374,412,413],{"align":360},[236,414,415],{},"providerConfig",[374,417,418],{"align":360},[236,419,405],{},[374,421,422],{"align":360},"Generated WireGuard keys and interface settings.",[355,424,425,430,434],{},[374,426,427],{"align":360},[236,428,429],{},"serviceAccountName",[374,431,432],{"align":360},[236,433,383],{},[374,435,436],{"align":360},"Name of the Kubernetes ServiceAccount created for this client.",[355,438,439,444,448],{},[374,440,441],{"align":360},[236,442,443],{},"serviceAccountData",[374,445,446],{"align":360},[236,447,405],{},[374,449,450,451,339,454,457,458,461],{"align":360},"Contains ",[236,452,453],{},"token",[236,455,456],{},"ca.crt",", and ",[236,459,460],{},"namespace"," for client authentication.",[355,463,464,469,474],{},[374,465,466],{"align":360},[236,467,468],{},"sunset",[374,470,471],{"align":360},[236,472,473],{},"string (datetime)",[374,475,476],{"align":360},"Timestamp after which this client is automatically purged from the cluster.",[355,478,479,484,489],{},[374,480,481],{"align":360},[236,482,483],{},"maxConnectionAge",[374,485,486],{"align":360},[236,487,488],{},"integer",[374,490,491],{"align":360},"Maximum duration (in seconds) the client session may stay active.",[355,493,494,499,503],{},[374,495,496],{"align":360},[236,497,498],{},"state",[374,500,501],{"align":360},[236,502,383],{},[374,504,505,506,339,509,339,512,339,515,393],{"align":360},"Current lifecycle state: ",[236,507,508],{},"REQUESTED",[236,510,511],{},"ACTIVE",[236,513,514],{},"WAITING",[236,516,517],{},"TERMINATING",[344,519,521],{"id":520},"example-manifest","Example Manifest",[523,524,529],"pre",{"className":525,"code":526,"language":527,"meta":528,"style":528},"language-yaml shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","apiVersion: gefyra.dev\u002Fv1\nkind: gefyraclient\nmetadata:\n  name: client-alice-d4f1\n  namespace: gefyra\nspec:\n  provider: stowaway\n  sunset: \"2026-11-20T18:00:00Z\"\n  maxConnectionAge: 28800\n","yaml","",[236,530,531,548,558,567,578,589,597,608,625],{"__ignoreMap":528},[532,533,536,540,544],"span",{"class":534,"line":535},"line",1,[532,537,539],{"class":538},"swJcz","apiVersion",[532,541,543],{"class":542},"sMK4o",":",[532,545,547],{"class":546},"sfazB"," gefyra.dev\u002Fv1\n",[532,549,551,553,555],{"class":534,"line":550},2,[532,552,109],{"class":538},[532,554,543],{"class":542},[532,556,557],{"class":546}," gefyraclient\n",[532,559,561,564],{"class":534,"line":560},3,[532,562,563],{"class":538},"metadata",[532,565,566],{"class":542},":\n",[532,568,570,573,575],{"class":534,"line":569},4,[532,571,572],{"class":538},"  name",[532,574,543],{"class":542},[532,576,577],{"class":546}," client-alice-d4f1\n",[532,579,581,584,586],{"class":534,"line":580},5,[532,582,583],{"class":538},"  namespace",[532,585,543],{"class":542},[532,587,588],{"class":546}," gefyra\n",[532,590,592,595],{"class":534,"line":591},6,[532,593,594],{"class":538},"spec",[532,596,566],{"class":542},[532,598,600,603,605],{"class":534,"line":599},7,[532,601,602],{"class":538},"  provider",[532,604,543],{"class":542},[532,606,607],{"class":546}," stowaway\n",[532,609,611,614,616,619,622],{"class":534,"line":610},8,[532,612,613],{"class":538},"  sunset",[532,615,543],{"class":542},[532,617,618],{"class":542}," \"",[532,620,621],{"class":546},"2026-11-20T18:00:00Z",[532,623,624],{"class":542},"\"\n",[532,626,628,631,633],{"class":534,"line":627},9,[532,629,630],{"class":538},"  maxConnectionAge",[532,632,543],{"class":542},[532,634,636],{"class":635},"sbssI"," 28800\n",[283,638],{},[286,640,642,643,292],{"id":641},"_2-gefyrabridgemount-gefyrabridgemountsgefyradev","2. GefyraBridgeMount (",[236,644,266],{},[232,646,295,647,649,650,653],{},[236,648,263],{}," attaches to a deployment, statefulset, or pod. It manages the injection and lifecycle of the ",[247,651,652],{},"Carrier2"," proxy sidecar container into the target workload.",[300,655,656,662,669,675],{},[244,657,658,307,660],{},[247,659,306],{},[236,661,310],{},[244,663,664,307,666],{},[247,665,315],{},[236,667,668],{},"gefyrabridgemount",[244,670,671,307,673],{},[247,672,323],{},[236,674,326],{},[244,676,677,307,679,339,682],{},[247,678,335],{},[236,680,681],{},"gbridgemount",[236,683,684],{},"gbridgemounts",[344,686,347],{"id":687},"specification-fields-1",[349,689,690,700],{},[352,691,692],{},[355,693,694,696,698],{},[358,695,361],{"align":360},[358,697,364],{"align":360},[358,699,367],{"align":360},[369,701,702,716,737,751,772,786,799],{},[355,703,704,709,713],{},[374,705,706],{"align":360},[236,707,708],{},"targetNamespace",[374,710,711],{"align":360},[236,712,383],{},[374,714,715],{"align":360},"The namespace of the workload to intercept.",[355,717,718,723,727],{},[374,719,720],{"align":360},[236,721,722],{},"target",[374,724,725],{"align":360},[236,726,383],{},[374,728,729,730,733,734,393],{"align":360},"Resource notation ",[236,731,732],{},"resource\u002Fname\u002Fcontainer",", e.g., ",[236,735,736],{},"deployment\u002Fbackend-api\u002Fweb",[355,738,739,744,748],{},[374,740,741],{"align":360},[236,742,743],{},"targetContainer",[374,745,746],{"align":360},[236,747,383],{},[374,749,750],{"align":360},"The specific container name within the pod to intercept.",[355,752,753,757,761],{},[374,754,755],{"align":360},[236,756,378],{},[374,758,759],{"align":360},[236,760,383],{},[374,762,763,764,767,768,771],{"align":360},"Interception provider engine (",[236,765,766],{},"carrier2"," or ",[236,769,770],{},"carrier",").",[355,773,774,779,783],{},[374,775,776],{"align":360},[236,777,778],{},"missingGracePeriod",[374,780,781],{"align":360},[236,782,488],{},[374,784,785],{"align":360},"Seconds before an unreachable workload mount is terminated (default: 30).",[355,787,788,792,796],{},[374,789,790],{"align":360},[236,791,468],{},[374,793,794],{"align":360},[236,795,473],{},[374,797,798],{"align":360},"Timestamp when the mount is automatically rolled back.",[355,800,801,805,809],{},[374,802,803],{"align":360},[236,804,498],{},[374,806,807],{"align":360},[236,808,383],{},[374,810,811,812,339,814,339,817,339,819,393],{"align":360},"Mount state: ",[236,813,508],{},[236,815,816],{},"INSTALLING",[236,818,511],{},[236,820,821],{},"ROLLING_BACK",[344,823,521],{"id":824},"example-manifest-1",[523,826,828],{"className":525,"code":827,"language":527,"meta":528,"style":528},"apiVersion: gefyra.dev\u002Fv1\nkind: gefyrabridgemount\nmetadata:\n  name: mount-backend-web\n  namespace: staging\nspec:\n  targetNamespace: staging\n  target: deployment\u002Fbackend-api\u002Fweb\n  targetContainer: web\n  provider: carrier2\n  missingGracePeriod: 60\n",[236,829,830,838,847,853,862,871,877,886,896,906,916],{"__ignoreMap":528},[532,831,832,834,836],{"class":534,"line":535},[532,833,539],{"class":538},[532,835,543],{"class":542},[532,837,547],{"class":546},[532,839,840,842,844],{"class":534,"line":550},[532,841,109],{"class":538},[532,843,543],{"class":542},[532,845,846],{"class":546}," gefyrabridgemount\n",[532,848,849,851],{"class":534,"line":560},[532,850,563],{"class":538},[532,852,566],{"class":542},[532,854,855,857,859],{"class":534,"line":569},[532,856,572],{"class":538},[532,858,543],{"class":542},[532,860,861],{"class":546}," mount-backend-web\n",[532,863,864,866,868],{"class":534,"line":580},[532,865,583],{"class":538},[532,867,543],{"class":542},[532,869,870],{"class":546}," staging\n",[532,872,873,875],{"class":534,"line":591},[532,874,594],{"class":538},[532,876,566],{"class":542},[532,878,879,882,884],{"class":534,"line":599},[532,880,881],{"class":538},"  targetNamespace",[532,883,543],{"class":542},[532,885,870],{"class":546},[532,887,888,891,893],{"class":534,"line":610},[532,889,890],{"class":538},"  target",[532,892,543],{"class":542},[532,894,895],{"class":546}," deployment\u002Fbackend-api\u002Fweb\n",[532,897,898,901,903],{"class":534,"line":627},[532,899,900],{"class":538},"  targetContainer",[532,902,543],{"class":542},[532,904,905],{"class":546}," web\n",[532,907,909,911,913],{"class":534,"line":908},10,[532,910,602],{"class":538},[532,912,543],{"class":542},[532,914,915],{"class":546}," carrier2\n",[532,917,919,922,924],{"class":534,"line":918},11,[532,920,921],{"class":538},"  missingGracePeriod",[532,923,543],{"class":542},[532,925,926],{"class":635}," 60\n",[283,928],{},[286,930,932,933,292],{"id":931},"_3-gefyrabridge-gefyrabridgesgefyradev","3. GefyraBridge (",[236,934,277],{},[232,936,295,937,939,940,942,943,945],{},[236,938,274],{}," associates an active ",[236,941,263],{}," with a specific ",[236,944,251],{},", completing the traffic routing circuit from the cluster to the developer's local container.",[300,947,948,954,961,967],{},[244,949,950,307,952],{},[247,951,306],{},[236,953,310],{},[244,955,956,307,958],{},[247,957,315],{},[236,959,960],{},"gefyrabridge",[244,962,963,307,965],{},[247,964,323],{},[236,966,326],{},[244,968,969,307,971,339,974],{},[247,970,335],{},[236,972,973],{},"gbridge",[236,975,976],{},"gbridges",[344,978,347],{"id":979},"specification-fields-2",[349,981,982,992],{},[352,983,984],{},[355,985,986,988,990],{},[358,987,361],{"align":360},[358,989,364],{"align":360},[358,991,367],{"align":360},[369,993,994,1009,1025,1038,1054,1070,1087,1109,1123],{},[355,995,996,1000,1004],{},[374,997,998],{"align":360},[236,999,378],{},[374,1001,1002],{"align":360},[236,1003,383],{},[374,1005,1006,1007,771],{"align":360},"Interception engine (",[236,1008,766],{},[355,1010,1011,1016,1020],{},[374,1012,1013],{"align":360},[236,1014,1015],{},"connectionProvider",[374,1017,1018],{"align":360},[236,1019,383],{},[374,1021,1022,1023,771],{"align":360},"Connection backend (",[236,1024,389],{},[355,1026,1027,1031,1035],{},[374,1028,1029],{"align":360},[236,1030,708],{},[374,1032,1033],{"align":360},[236,1034,383],{},[374,1036,1037],{"align":360},"Target workload namespace.",[355,1039,1040,1044,1048],{},[374,1041,1042],{"align":360},[236,1043,722],{},[374,1045,1046],{"align":360},[236,1047,383],{},[374,1049,1050,1051,1053],{"align":360},"The ",[236,1052,263],{}," name to bind to.",[355,1055,1056,1061,1065],{},[374,1057,1058],{"align":360},[236,1059,1060],{},"client",[374,1062,1063],{"align":360},[236,1064,383],{},[374,1066,1050,1067,1069],{"align":360},[236,1068,251],{}," identifier receiving intercepted traffic.",[355,1071,1072,1077,1081],{},[374,1073,1074],{"align":360},[236,1075,1076],{},"destinationIP",[374,1078,1079],{"align":360},[236,1080,383],{},[374,1082,1083,1084,771],{"align":360},"Local container WireGuard IP address (e.g. ",[236,1085,1086],{},"192.168.99.2",[355,1088,1089,1094,1099],{},[374,1090,1091],{"align":360},[236,1092,1093],{},"portMappings",[374,1095,1096],{"align":360},[236,1097,1098],{},"array[string]",[374,1100,1101,1102,1105,1106,393],{"align":360},"Port translations in ",[236,1103,1104],{},"remote:local"," format, e.g. ",[236,1107,1108],{},"[\"80:8000\"]",[355,1110,1111,1116,1120],{},[374,1112,1113],{"align":360},[236,1114,1115],{},"clusterEndpoint",[374,1117,1118],{"align":360},[236,1119,405],{},[374,1121,1122],{"align":360},"Host and port coordinates of the client stowaway proxy.",[355,1124,1125,1129,1133],{},[374,1126,1127],{"align":360},[236,1128,498],{},[374,1130,1131],{"align":360},[236,1132,383],{},[374,1134,1135,1136,339,1138,339,1140,339,1143,393],{"align":360},"State: ",[236,1137,508],{},[236,1139,511],{},[236,1141,1142],{},"FAILED",[236,1144,517],{},[344,1146,521],{"id":1147},"example-manifest-2",[523,1149,1151],{"className":525,"code":1150,"language":527,"meta":528,"style":528},"apiVersion: gefyra.dev\u002Fv1\nkind: gefyrabridge\nmetadata:\n  name: bridge-alice-backend\n  namespace: staging\nspec:\n  provider: carrier2\n  connectionProvider: stowaway\n  targetNamespace: staging\n  target: mount-backend-web\n  client: client-alice-d4f1\n  destinationIP: 192.168.99.2\n  portMappings:\n    - \"8000:8000\"\n",[236,1152,1153,1161,1170,1176,1185,1193,1199,1207,1216,1224,1232,1241,1252,1260],{"__ignoreMap":528},[532,1154,1155,1157,1159],{"class":534,"line":535},[532,1156,539],{"class":538},[532,1158,543],{"class":542},[532,1160,547],{"class":546},[532,1162,1163,1165,1167],{"class":534,"line":550},[532,1164,109],{"class":538},[532,1166,543],{"class":542},[532,1168,1169],{"class":546}," gefyrabridge\n",[532,1171,1172,1174],{"class":534,"line":560},[532,1173,563],{"class":538},[532,1175,566],{"class":542},[532,1177,1178,1180,1182],{"class":534,"line":569},[532,1179,572],{"class":538},[532,1181,543],{"class":542},[532,1183,1184],{"class":546}," bridge-alice-backend\n",[532,1186,1187,1189,1191],{"class":534,"line":580},[532,1188,583],{"class":538},[532,1190,543],{"class":542},[532,1192,870],{"class":546},[532,1194,1195,1197],{"class":534,"line":591},[532,1196,594],{"class":538},[532,1198,566],{"class":542},[532,1200,1201,1203,1205],{"class":534,"line":599},[532,1202,602],{"class":538},[532,1204,543],{"class":542},[532,1206,915],{"class":546},[532,1208,1209,1212,1214],{"class":534,"line":610},[532,1210,1211],{"class":538},"  connectionProvider",[532,1213,543],{"class":542},[532,1215,607],{"class":546},[532,1217,1218,1220,1222],{"class":534,"line":627},[532,1219,881],{"class":538},[532,1221,543],{"class":542},[532,1223,870],{"class":546},[532,1225,1226,1228,1230],{"class":534,"line":908},[532,1227,890],{"class":538},[532,1229,543],{"class":542},[532,1231,861],{"class":546},[532,1233,1234,1237,1239],{"class":534,"line":918},[532,1235,1236],{"class":538},"  client",[532,1238,543],{"class":542},[532,1240,577],{"class":546},[532,1242,1244,1247,1249],{"class":534,"line":1243},12,[532,1245,1246],{"class":538},"  destinationIP",[532,1248,543],{"class":542},[532,1250,1251],{"class":635}," 192.168.99.2\n",[532,1253,1255,1258],{"class":534,"line":1254},13,[532,1256,1257],{"class":538},"  portMappings",[532,1259,566],{"class":542},[532,1261,1263,1266,1268,1271],{"class":534,"line":1262},14,[532,1264,1265],{"class":542},"    -",[532,1267,618],{"class":542},[532,1269,1270],{"class":546},"8000:8000",[532,1272,624],{"class":542},[283,1274],{},[286,1276,1278,1279],{"id":1277},"inspecting-gefyra-resources-with-kubectl","Inspecting Gefyra Resources with ",[236,1280,1281],{},"kubectl",[232,1283,1284,1285,1287],{},"Because Gefyra resources are native Kubernetes Custom Resources, you can inspect and manipulate them with standard ",[236,1286,1281],{}," commands:",[523,1289,1293],{"className":1290,"code":1291,"language":1292,"meta":528,"style":528},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","# List all active clients\nkubectl get gefyraclients -n gefyra\n\n# List active bridge mounts in a namespace\nkubectl get gefyrabridgemounts -n staging\n\n# List active traffic bridges\nkubectl get gefyrabridges -A\n\n# Describe a failing bridge for operator error diagnostics\nkubectl describe gefyrabridge my-bridge -n staging\n","bash",[236,1294,1295,1301,1317,1323,1328,1341,1345,1350,1362,1366,1371],{"__ignoreMap":528},[532,1296,1297],{"class":534,"line":535},[532,1298,1300],{"class":1299},"sHwdD","# List all active clients\n",[532,1302,1303,1306,1309,1312,1315],{"class":534,"line":550},[532,1304,1281],{"class":1305},"sBMFI",[532,1307,1308],{"class":546}," get",[532,1310,1311],{"class":546}," gefyraclients",[532,1313,1314],{"class":546}," -n",[532,1316,588],{"class":546},[532,1318,1319],{"class":534,"line":560},[532,1320,1322],{"emptyLinePlaceholder":1321},true,"\n",[532,1324,1325],{"class":534,"line":569},[532,1326,1327],{"class":1299},"# List active bridge mounts in a namespace\n",[532,1329,1330,1332,1334,1337,1339],{"class":534,"line":580},[532,1331,1281],{"class":1305},[532,1333,1308],{"class":546},[532,1335,1336],{"class":546}," gefyrabridgemounts",[532,1338,1314],{"class":546},[532,1340,870],{"class":546},[532,1342,1343],{"class":534,"line":591},[532,1344,1322],{"emptyLinePlaceholder":1321},[532,1346,1347],{"class":534,"line":599},[532,1348,1349],{"class":1299},"# List active traffic bridges\n",[532,1351,1352,1354,1356,1359],{"class":534,"line":610},[532,1353,1281],{"class":1305},[532,1355,1308],{"class":546},[532,1357,1358],{"class":546}," gefyrabridges",[532,1360,1361],{"class":546}," -A\n",[532,1363,1364],{"class":534,"line":627},[532,1365,1322],{"emptyLinePlaceholder":1321},[532,1367,1368],{"class":534,"line":908},[532,1369,1370],{"class":1299},"# Describe a failing bridge for operator error diagnostics\n",[532,1372,1373,1375,1378,1381,1384,1386],{"class":534,"line":918},[532,1374,1281],{"class":1305},[532,1376,1377],{"class":546}," describe",[532,1379,1380],{"class":546}," gefyrabridge",[532,1382,1383],{"class":546}," my-bridge",[532,1385,1314],{"class":546},[532,1387,870],{"class":546},[1389,1390,1391],"style",{},"html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}",{"title":528,"searchDepth":550,"depth":550,"links":1393},[1394,1399,1404,1409],{"id":288,"depth":550,"text":1395,"children":1396},"1. GefyraClient (gefyraclients.gefyra.dev)",[1397,1398],{"id":346,"depth":560,"text":347},{"id":520,"depth":560,"text":521},{"id":641,"depth":550,"text":1400,"children":1401},"2. GefyraBridgeMount (gefyrabridgemounts.gefyra.dev)",[1402,1403],{"id":687,"depth":560,"text":347},{"id":824,"depth":560,"text":521},{"id":931,"depth":550,"text":1405,"children":1406},"3. GefyraBridge (gefyrabridges.gefyra.dev)",[1407,1408],{"id":979,"depth":560,"text":347},{"id":1147,"depth":560,"text":521},{"id":1277,"depth":550,"text":1410},"Inspecting Gefyra Resources with kubectl","Complete reference for Gefyra's Kubernetes Custom Resources (GefyraBridge, GefyraClient, GefyraBridgeMount). API schemas, states, and YAML manifests.","md",null,{},{"title":206,"icon":209},{"title":227,"description":1411},"w6JFynbuVHdHvVCijNrqOsPD6ykFZFIQgpBnNd_QVNs",[1419,1421],{"title":201,"path":202,"stem":203,"description":1420,"icon":204,"children":-1},"Gefyra's CLI allows you to run containers on your local machine and connect them to Kubernetes-based resources.",{"title":211,"path":212,"stem":213,"description":1422,"icon":214,"children":-1},"Explore the architectural evolution of Gefyra 2. State-machine driven operator, decoupled BridgeMounts, fine-grained RBAC client management, and Carrier2 proxying.",1795114695734]