dehaze

Installing Space Cloud on MicroK8s

Follow these instructions to install Space Cloud on MicroK8s.

Step 1: Install MicroK8s

Make sure you have kubectl installed before installing microk8s.

Install the latest version of MicroK8s for Windows, Linux or macOS.

Install the required add-ons:

microk8s enable dns rbac

Copy the kubernetes config file to your host:

mkdir ~/.kube
microk8s config > ~/.kube/config

Wait for all the pods to start:

kubectl get pods -n istio-system --watch

Step 2: Install Istio

Space Cloud requires Istio to work correctly. The default Istio profile works perfectly well.

Download the latest istio release:

curl -L https://istio.io/downloadIstio | sh -

Space Cloud has been tested with Istio versions v1.8.X, v1.7.X and v1.6.X.

Move to the Istio package directory and install Istio. For example, if the package is istio-1.8.0:

cd istio-1.8.0
./bin/istioctl install --set profile=demo

For more detailed Istio install instructions, visit the Istio Docs

Step 3: Install Space Cloud

To install Space Cloud, first download space-cli:

Now install Space Cloud using the following command:

space-cli setup

For details on how to customise Space Cloud installation, visit the customisation docs.

Wait for all the pods to start:

kubectl get pods -n space-cloud --watch

Set up port forwarding to access Mission Control on localhost:4122.

kubectl port-forward -n istio-system deployments/istio-ingressgateway 4122:8080

Step 4: Open Mission Control

You should be able to access Mission Control on http://localhost:4122/mission-control or http://YOUR_IP:4122/mission-control.

If you are running microk8s on Windows or MacOS, k8s runs in a separate VM. Run multipass list to find the IP of that VM. It should have an ouptut similar to:

Name                    State             IPv4             Image
microk8s-vm             Running           192.168.64.17    Ubuntu 18.04 LTS

Use the IP printed on the terminal to connect to Space Cloud instead of localhost.

The default credentials are:

  • Username: admin
  • Key: 1234

You can change it by editing the admin.username and admin.password variables of the space-cloud configuration file.

Next Steps

Awesome! We just started Space Cloud using Kubernetes. Next step would be to set up a project to use Space Cloud in your preferred language.

Feel free to check out various capabilities of space-cloud:

Have a technical question?

Improve the docs!