This document shows how to upgrade to version 1.8 from a 1.7 user cluster that has an Isto Gateway object.
Overview
In version 1.8 of Google Distributed Cloud, the ingress mechanism has changed substantially from previous versions.
In versions prior to 1.8 , you enabled ingress by creating an Istio Gateway object. Then you could create Ingress objects.
In version 1.8, you do not create a Gateway object. You can create Ingress objects as usual.
To upgrade to 1.8 from a 1.7 user cluster that has ingress enabled, you must first run a tool that converts the old ingress mechanism to the new one.
To check to see whether you need to run the tool, attempt to upgrade the user cluster :
gkectl upgrade cluster --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config USER_CLUSTER_CONFIG
If you see the following error, then you need to run the tool:
- Validation Category: Ingress
Running validation check for "User cluster Ingress"... /
- [FAILURE] User cluster Ingress: detected usage of unsupported Ingress, ...
Here are the steps:
-
Follow the instructions for using the migration tool .
-
After resolving any issues remember to annotate the Gateway object.
-
Continue with the regular upgrade process.
If your cluster has ingress enabled, skipping the migration step might result in traffic disruption for all services using ingress.
