Stay organized with collections
Save and categorize content based on your preferences.
This document shows how to disable bundled ingress for a user cluster in
Google Distributed Cloud.
By default, bundled ingress is enabled in user clusters. This means that the
istiod and istio-ingress Deployments are running. For more information, see
Ingress components.
If you want to use a full installation of
Cloud Service Mesh in a user cluster, you might want
to disable bundled ingress. This is because bundled ingress is not needed when
Cloud Service Mesh is fully installed, and there are potential conflicts between
bundled ingress and Cloud Service Mesh.
If you want to enable bundled ingress for an existing user cluster that has
bundled ingress disabled, edit the user cluster configuration file, and run
gkectl update cluster.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[],[],null,["# Disable bundled ingress\n\nThis document shows how to disable bundled ingress for a user cluster in\nGoogle Distributed Cloud.\n\nBy default, bundled ingress is enabled in user clusters. This means that the\n`istiod` and `istio-ingress` Deployments are running. For more information, see\n[Ingress components](/kubernetes-engine/distributed-cloud/vmware/docs/how-to/create-service-ingress#ingress_components).\n\nIf you want to use a full installation of\n[Cloud Service Mesh](/service-mesh/docs/overview) in a user cluster, you might want\nto disable bundled ingress. This is because bundled ingress is not needed when\nCloud Service Mesh is fully installed, and there are potential conflicts between\nbundled ingress and Cloud Service Mesh.\n\nDisable bundled ingress for a new cluster\n-----------------------------------------\n\nCreate a user cluster as described in\n[Create a user cluster](/kubernetes-engine/distributed-cloud/vmware/docs/how-to/create-user-cluster).\n\nAs you fill in your user cluster configuration file:\n\n- Set `disableBundledIngress` to `true`.\n- Do not specify a value for `loadBalancer.vips.ingressVIP`.\n\n```\napiVersion: v1\nkind: UserCluster\n...\ndisableBundledIngress: true\n...\nloadBalancer:\n vips:\n controlPlaneVIP: 172.16.21.30\n ingressVIP:\n```\n\nDisable bundled ingress for an existing cluster\n-----------------------------------------------\n\nIn your existing user cluster configuration file:\n\n- Set `disableBundledIngress` to `true`.\n- Remove the `loadBalancer.vips.ingressVIP` value.\n\nUpdate the cluster:\n\n```\ngkectl update cluster --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config USER_CLUSTER_CONFIG\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eADMIN_CLUSTER_KUBECONFIG\u003c/var\u003e: the path of the admin cluster kubeconfig\n file\n\n- \u003cvar translate=\"no\"\u003eUSER_CLUSTER_CONFIG\u003c/var\u003e: the path of the user cluster configuration\n file\n\nManual load balancing\n---------------------\n\nIf your cluster uses manual load balancing and you want to disable bundled\ningress, do not specify values for the following fields:\n\n- `loadBalancer.manualLB.ingressHTTPSNodePort`\n- `loadBalancer.manualLB.ingressHTTPNodePort`\n\n```\nloadBalancer:\n Kind: ManaulLB\n manualLB:\n ingressHTTPSNodePort:\n ingressHTTPNodePort:\n controlPlaneNodePort: 30562\n```\n\nEnable bundled ingress for an existing cluster\n----------------------------------------------\n\nIf you want to enable bundled ingress for an existing user cluster that has\nbundled ingress disabled, edit the user cluster configuration file, and run\n`gkectl update cluster`.\n\nRelated documents\n-----------------\n\n- [Overview of load balancing](/kubernetes-engine/distributed-cloud/vmware/docs/how-to/setup-load-balance)\n- [Create a Service and an Ingress](/kubernetes-engine/distributed-cloud/vmware/docs/how-to/create-service-ingress)"]]