Installing SuperGloo

Install command line tool (CLI)

The supergloo command line makes it much easier to install and operate SuperGloo, though it is not required.

To install using the Homebrew package manager, run the following.

brew install solo-io/tap/supergloo

To install on any platform run the following.

curl -sL https://run.solo.io/supergloo/install | sh

You can download the CLI directly via the github releases page. You need to add SuperGloo to your path after downloading.

export PATH=$HOME/.supergloo/bin:$PATH

Verify the CLI is installed and running correctly with:

supergloo --version

Install the SuperGloo Controller to your Kubernetes Cluster using supergloo init

Once your Kubernetes cluster is up and running, run the following command to deploy the SuperGloo Controller and Discovery pods to the supergloo-system namespace:

supergloo init

installing supergloo version 0.3.14
using chart uri https://storage.googleapis.com/supergloo-helm/charts/supergloo-0.3.14.
tgz
configmap/sidecar-injection-resources created
serviceaccount/supergloo created
serviceaccount/discovery created
serviceaccount/mesh-discovery created
clusterrole.rbac.authorization.k8s.io/discovery created
clusterrole.rbac.authorization.k8s.io/mesh-discovery created
clusterrolebinding.rbac.authorization.k8s.io/supergloo-role-binding created
clusterrolebinding.rbac.authorization.k8s.io/discovery-role-binding created
clusterrolebinding.rbac.authorization.k8s.io/mesh-discovery-role-binding created
deployment.extensions/supergloo created
deployment.extensions/discovery created
deployment.extensions/mesh-discovery created
install successful!

You can see the kubernetes YAML supergloo is installing to your cluster without installing by running supergloo init --dry-run.


NOTE: You can install SuperGloo to an existing namespace by providing the --namespace option. If the option is not provided, the namespace defaults to supergloo-system.

supergloo init --namespace my-namespace

Check that the SuperGloo and Discovery pods have been created:

kubectl --namespace supergloo-system get all
NAME                                 READY   STATUS    RESTARTS   AGE
pod/discovery-68df78f9c-rk2w4        1/1     Running   0          2m49s
pod/mesh-discovery-bc9fbcb7f-z84r9   1/1     Running   0          2m49s
pod/supergloo-59445698c5-p2fvm       1/1     Running   0          2m49s

NAME                             DESIRED   CURRENT   UP-TO-DATE   AVAILABLE   AGE
deployment.apps/discovery        1         1         1            1           2m49s
deployment.apps/mesh-discovery   1         1         1            1           2m49s
deployment.apps/supergloo        1         1         1            1           2m49s

NAME                                       DESIRED   CURRENT   READY   AGE
replicaset.apps/discovery-68df78f9c        1         1         1       2m49s
replicaset.apps/mesh-discovery-bc9fbcb7f   1         1         1       2m49s
replicaset.apps/supergloo-59445698c5       1         1         1       2m49s

Install SuperGloo using Helm

Add the SuperGloo Helm charts to your local Helm installation.

helm repo add supergloo http://storage.googleapis.com/supergloo-helm

You can examine the available versions of SuperGloo by running the following command

helm search supergloo/supergloo --versions
NAME               	CHART VERSION	APP VERSION	DESCRIPTION
supergloo/supergloo	0.3.16       	           	The official Helm Chart for SuperGloo
supergloo/supergloo	0.3.15       	           	The official Helm Chart for SuperGloo
supergloo/supergloo	0.3.14       	           	The official Helm Chart for SuperGloo
supergloo/supergloo	0.3.13       	           	The official Helm Chart for SuperGloo
supergloo/supergloo	0.3.12       	           	The official Helm Chart for SuperGloo
supergloo/supergloo	0.3.11       	           	The official Helm Chart for SuperGloo
supergloo/supergloo	0.3.10       	           	The official Helm Chart for SuperGloo
supergloo/supergloo	0.3.9        	           	The official Helm Chart for SuperGloo
supergloo/supergloo	0.3.8        	           	The official Helm Chart for SuperGloo
supergloo/supergloo	0.3.7        	           	The official Helm Chart for SuperGloo
supergloo/supergloo	0.3.6        	           	The official Helm Chart for SuperGloo
supergloo/supergloo	0.3.5        	           	The official Helm Chart for SuperGloo
supergloo/supergloo	0.3.4        	           	The official Helm Chart for SuperGloo
supergloo/supergloo	0.3.3        	           	The official Helm Chart for SuperGloo
supergloo/supergloo	0.3.2        	           	The official Helm Chart for SuperGloo
supergloo/supergloo	0.3.1        	           	The official Helm Chart for SuperGloo
supergloo/supergloo	0.3.0        	           	The official Helm Chart for SuperGloo
supergloo/supergloo	0.2.1        	           	The official Helm Chart for SuperGloo
supergloo/supergloo	0.0.0        	           	The official Helm Chart for SuperGloo

Next steps

Now that you’ve successfully installed SuperGloo, let’s put it to work in our tutorial, installing a mesh with SuperGloo

Uninstall

To uninstall SuperGloo and all related components, simply run the following:

supergloo init --dry-run | kubectl delete --filename -

If you installed SuperGloo to a different namespace, you will have to specify that namespace using the --namespace option:

supergloo init --dry-run --namespace my-namespace | kubectl delete --filename -