Shipa with Minikube

Minikube can also be used to quickly install Shipa and start deploying applications

📘

Minikube

Users can find detailed information on how to install Minikube by using link below:

https://kubernetes.io/docs/tasks/tools/install-minikube/

📘

Virtualbox

Virtualbox can be downloaded by using the following link:

Note: Ensure that Virtualbox is installed prior to executing the instructions below.

https://www.virtualbox.org/wiki/Downloads

📘

HyperKit

For newer Macs, you might have to switch the minikube driver to HyperKit.

Can use Homebrew to install HyperKit on your Mac.
brew install hyperkit

After installing MiniKube and Virtualbox, it's time to get a cluster up and running by using the command below:

minikube start --kubernetes-version='v1.18.2' --memory='5gb' --disk-size='20gb' --driver=virtualbox

Once the cluster is running, Add the Shipa Helm chart repo using the following command:

helm repo add shipa-charts https://shipa-charts.storage.googleapis.com

Install Shipa

helm install shipa shipa-charts/shipa \
--timeout=15m \
--set=metrics.image=gcr.io/shipa-1000/metrics:30m \
[email protected] \
--set=auth.adminPassword=shipa2020 \
--set=shipaCluster.serviceType=ClusterIP \
--set=shipaCluster.ip=10.100.10.20 \
--set=service.nginx.serviceType=ClusterIP \
--set=service.nginx.clusterIP=10.100.10.10

📘

Install process

Shipa installs its services in the default namespace of your local clusters.

To check its progress, run kubectl get pods.

Once the dashboard-web-1-x service is running, Shipa is ready to be used!

With Shipa installed and running, the next step is to add route to the ngnix ingress. To do this, use the following command:

sudo route -n add -host -net 10.100.10.10/32 $(minikube ip )

Now, add the route to the Traefik ingress:

sudo route -n add -host -net 10.100.10.20/32 $(minikube ip )

📘

Shipa CLI Download

Users can download the Shipa CLI by using this link

Once the route to ngnix and Traefik have been added, next add your local Shipa instance as a target to your Shipa CLI:

shipa target-add -s shipa-v101 10.100.10.10

📘

Self Signed Shipa CA

Depending on your connectivity, you might be asked to use a self signed cert that is generated for a new target e.g shipa-v101 in this case.

By installing the Shipa CLI and adding the Shipa instance as a target, you can run a pair of commands to find the Web UI. By running the login and app list commands, you will have access to the Web UI. The output from app list will provide the dashboard URL.

#Login
shipa login
#List Apps
shipa app list

#Output from shipa app list
+-------------+-----------+---------------+------------------------------------+
| Application | Status    | Shipa Managed | Address                            |
+-------------+-----------+---------------+------------------------------------+
| dashboard   | 1 running | true          | http://dashboard.10.100.10.20.   ↵ |
|             |           |               | shipa.cloud                        |
+-------------+-----------+---------------+------------------------------------

In this case, the dashboard URL is http://dashboard.10.100.10.20.shipa.cloud


Did this page help you?