Upgrade the gloo control plane and any Gloo Gateway proxies that run in your cluster. During the upgrade, pods that run the new version of the control plane and proxies are created. Then, the old pods are terminated. Because zero downtime is not guaranteed, try testing the upgrade in a staging environment before upgrading your production environment.

  1. Update the Gloo Gateway Helm repositories.

      helm repo update

  2. Set the version to upgrade Gloo Gateway to in an environment variable, such as the latest patch version for open source (1.17.0-rc8) or enterprise (1.17.0-rc3).

      export NEW_VERSION=1.17.0-rc8
  
      export NEW_VERSION=1.17.0-rc3

  3. Apply the new and updated CRDs.

    1. Download and apply the new CRDs.
        helm pull gloo/gloo --version $NEW_VERSION --untar
kubectl apply -f gloo/crds
    2. Verify that the deployed CRDs use the version that you want to upgrade to.
        glooctl check-crds
    1. Download and apply the new CRDs.
        helm pull glooe/gloo-ee --version $NEW_VERSION --untar
kubectl apply -f gloo-ee/charts/gloo/crds
    2. Verify that the deployed CRDs use the version that you want to upgrade to.
        glooctl check-crds

  4. Get the Helm values files for your current version.

      helm get values gloo-gateway -n gloo-system -o yaml > gloo-gateway.yaml
open gloo-gateway.yaml

  5. Make any changes to your Helm values file.

  6. Upgrade the Helm release.

      helm upgrade -n gloo-system gloo-gateway gloo/gloo \
   -f gloo-gateway.yaml \
   --version=$NEW_VERSION
  
      helm upgrade -n gloo-system gloo-gateway glooe/gloo-ee \
   -f gloo-gateway.yaml \
   --version=$NEW_VERSION

  7. Verify that Gloo Gateway runs the upgraded version.

      kubectl -n gloo-system get pod -l gloo=gloo -ojsonpath='{.items[0].spec.containers[0].image}'

    Example output:

      quay.io/solo-io/gloo-ee:1.17.0-rc3@sha256:582ab27a995e9526522f81a9325584aefb528fa4d939455fd285e5148615991b

  8. Confirm that the Gloo Gateway control plane is up and running.

      kubectl get pods -n gloo-system