Uninstall
If you no longer need your Gloo Mesh Gateway environment, you can uninstall Gloo Mesh Gateway components, such as the management server, agent, gateway proxies, and sample apps.
Single cluster
Uninstall Gloo Mesh Gateway from a single-cluster setup.
Gateway proxies
Uninstall the Istio control plane and gateway proxies. Note: For demo installations, skip to the next section.
OpenShift installations: Revoke the extra permissions and resources required for OpenShift to run Istio.
Revoke the Istio namespace ID permissions for the Istio service accounts.
Revoke the Istio namespace ID permissions for sample app project service accounts.
Delete the NetworkAttachmentDefinition resources and the Istio namespace ID permissions for your workload projects.
Gloo Mesh Gateway
Uninstall Gloo Mesh Gateway.
Delete the
gloo-mesh
namespace.
Optional: Sample apps
If you installed the Bookinfo and httpbin sample apps, run the following commands to uninstall their resources.
Export the Istio version that your cluster runs as an environment variable, such as 1.23.4 in the following example.
Remove the Bookinfo application components and service accounts.
Delete the
bookinfo
namespace.Remove the httpbin application components.
Delete the
httpbin
namespace.
Multicluster
Uninstall Gloo Mesh Gateway from a multicluster setup.
Gateway proxies
Save the names and contexts of the clusters you want to uninstall Gloo Mesh Gateway from.
Uninstall the Istio control plane and gateway proxies. These steps differ depending on how you installed them.
OpenShift installations: Revoke the extra permissions and resources required for OpenShift to run Istio.
Revoke the Istio namespace ID permissions for the Istio service accounts.
Revoke the Istio namespace ID permissions for sample app project service accounts.
Delete the NetworkAttachmentDefinition resources and the Istio namespace ID permissions for your workload projects.
Workload clusters
Uninstall the Gloo data plane components from the workload clusters.
Uninstall the Gloo agent that runs on each workload cluster.
Uninstall the Gloo CRDs Helm releases in each workload cluster.
Delete the
gloo-mesh
namespace from each workload cluster.Repeat these steps for any other cluster that is registered with Gloo Mesh. For example, if you ran the management plane in a cluster that was also registered, repeat these steps for the
MGMT_CLUSTER
and specify theMGMT_CONTEXT
. If you registered multiple workload clusters, repeat these steps for each workload cluster.
Management cluster
Uninstall the Gloo management plane components from the management cluster.
Uninstall the Gloo management plane components.
Uninstall the Gloo CRDs Helm release from the management cluster.
Delete the
gloo-mesh
namespace, and if applicable, thegloo-mesh-config
namespace.
Optional: Sample apps
If you installed the Bookinfo and httpbin sample apps, run the following commands to uninstall their resources.
Export the Istio version that your cluster runs as an environment variable, such as 1.23.4 in the following example.
Remove the Bookinfo application components and service accounts.
Delete the
bookinfo
namespace.Remove the httpbin application components.
Delete the
httpbin
namespace.