[[["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-29 UTC."],[[["\u003cp\u003eVersion 1.8 of Google Distributed Cloud changes the ingress mechanism, eliminating the need for Istio Gateway objects used in versions prior to 1.8.\u003c/p\u003e\n"],["\u003cp\u003eUpgrading from a 1.7 user cluster with ingress enabled to 1.8 requires running a migration tool to convert the old ingress mechanism.\u003c/p\u003e\n"],["\u003cp\u003eYou can determine if the migration tool is required by attempting the cluster upgrade and checking for a specific "User cluster Ingress" error message.\u003c/p\u003e\n"],["\u003cp\u003eThe migration process involves using a specific tool, resolving potential issues, and annotating the Gateway object, followed by the regular upgrade steps.\u003c/p\u003e\n"],["\u003cp\u003eSkipping the ingress migration step, if required, may cause service traffic disruption for all services that rely on ingress.\u003c/p\u003e\n"]]],[],null,["# Ingress migration\n\nThis document shows how to upgrade to version 1.8 from a 1.7 user cluster that\nhas an Isto Gateway object.\n\nOverview\n--------\n\nIn version 1.8 of Google Distributed Cloud, the ingress mechanism has\nchanged substantially from previous versions.\n\nIn versions\n[prior to 1.8](/anthos/clusters/docs/on-prem/1.7/how-to/enable-ingress),\nyou enabled ingress by creating an Istio Gateway\nobject. Then you could create Ingress objects.\n\nIn version 1.8, you do not create a Gateway object. You can create Ingress\nobjects as usual.\n\nTo upgrade to 1.8 from a 1.7 user cluster that has ingress enabled, you must first\nrun a tool that converts the old ingress mechanism to the new one.\n\nTo check to see whether you need to run the tool, attempt to\n[upgrade the user cluster](/anthos/clusters/docs/on-prem/1.8/how-to/upgrading#upgrade_user_cluster):\n\n```\ngkectl upgrade cluster --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config USER_CLUSTER_CONFIG\n```\n\nIf you see the following error, then you need to run the tool:\n\n```\n- Validation Category: Ingress\n Running validation check for \"User cluster Ingress\"... /\n - [FAILURE] User cluster Ingress: detected usage of unsupported Ingress, ...\n```\n\nHere are the steps:\n\n1. Follow the instructions for using the\n [migration tool](https://github.com/istio-ecosystem/istio-ingress-migrate#usage).\n\n2. After resolving any issues remember to annotate the Gateway object.\n\n3. Continue with the regular upgrade process.\n\nIf your cluster has ingress enabled, skipping the migration step might result in\ntraffic disruption for all services using ingress.\n\nWhat's next\n-----------\n\n[Create a Service and an Ingress](/anthos/clusters/docs/on-prem/1.8/how-to/create-service-ingress)"]]