Installing Gloo as an Ingress Controller
Install command line tool (CLI)
glooctl command line provides useful functions to install, configure, and debug Gloo, though it is not required to use Gloo.
- To install
glooctlusing the Homebrew package manager, run the following.
brew install solo-io/tap/glooctl
- To install on any platform run the following.
curl -sL https://run.solo.io/gloo/install | sh export PATH=$HOME/.gloo/bin:$PATH
- You can download
glooctldirectly via the GitHub releases page. You need to add
glooctlto your system’s
Verify the CLI is installed and running correctly with:
glooctl community edition version 0.13.29
Installing the Gloo Ingress Controller on Kubernetes
These directions assume you’ve prepared your Kubernetes cluster appropriately. Full details on setting up your Kubernetes cluster here.
Installing on Kubernetes with
Once your Kubernetes cluster is up and running, run the following command to deploy the Gloo Ingress Controller to the
glooctl install ingress
Note: You can run the command with the flag
--dry-runto output the Kubernetes manifests (as
glooctlwill apply to the cluster instead of installing them.
Installing on Kubernetes with Helm
This is the recommended method for installing Gloo to your production environment as it offers rich customization to the Gloo control plane and the proxies Gloo manages.
As a first step, you have to add the Gloo repository to the list of known chart repositories:
helm repo add gloo https://storage.googleapis.com/solo-public-helm
The Gloo chart archive contains the necessary value files for the Ingress deployment option. Run the following command to download and extract the archive to the current directory:
helm fetch --untar=true --untardir=. gloo/gloo
Finally, install Gloo using the following command:
helm install gloo --namespace gloo-system -f gloo/values-ingress.yaml
Gloo can be installed to a namespace of your choosing with the
Verify your Installation
Check that the Gloo pods and services have been created. Depending on your install option, you may see some differences
from the following example. And if you choose to install Gloo into a different namespace than the default
then you will need to query your chosen namespace instead.
kubectl get all -n gloo-system
NAME READY STATUS RESTARTS AGE pod/ingress-proxy-6d786fd9f-4k5r4 1/1 Running 0 64s pod/discovery-55b8645d77-72mbt 1/1 Running 0 63s pod/gloo-9f9f77c8d-6sk7z 1/1 Running 0 64s pod/ingress-85ffc7b77b-z6lsm 1/1 Running 0 64s NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE service/ingress-proxy LoadBalancer 10.7.250.225 22.214.171.124 80:32436/TCP,443:32667/TCP 64s service/gloo ClusterIP 10.7.251.47 <none> 9977/TCP 4d10h NAME DESIRED CURRENT UP-TO-DATE AVAILABLE AGE deployment.apps/ingress-proxy 1 1 1 1 64s deployment.apps/discovery 1 1 1 1 63s deployment.apps/gloo 1 1 1 1 64s deployment.apps/ingress 1 1 1 1 64s NAME DESIRED CURRENT READY AGE replicaset.apps/ingress-proxy-6d786fd9f 1 1 1 64s replicaset.apps/discovery-55b8645d77 1 1 1 63s replicaset.apps/gloo-9f9f77c8d 1 1 1 64s replicaset.apps/ingress-85ffc7b77b 1 1 1 64s
To uninstall Gloo and all related components, simply run the following.
If you installed Gloo to a different namespace, you will have to specify that namespace using the
glooctl uninstall -n my-namespace
To begin using Gloo with the Kubernetes Ingress API, check out the Ingress Controller guide.