This project is not maintained anymore, please use minikube instead
Kube-Cluster for macOS is a status bar app
which allows in an easy way to bootstrap and control multi-node (master+ two nodes) Kubernetes cluster on three CoreOS VMs.
It leverages macOS native Hypervisor virtualisation framework of using corectl command line tool, so there are no needs to use VirtualBox or any other virtualisation software anymore.
Includes: Helm Classic / Helm v2 - The Kubernetes Package Manager and an option from shell to install Deis Workflow on top of Kubernetes: $ install_deis
Kube-Cluster App can be used together with CoreOS VM App which allows to build Docker containers and both apps have access to the same local Docker registry hosted by Corectl App.
App's menu looks as per image below:
Head over to the Releases Page to grab the latest release.
corectld
server daemon control.latest dmg
from the Releases Page and install it to /Applications
folder, it allows to start/stop/update corectl tools needed to run CoreOS VMs on macOSdmg
file and drag the App e.g. to your Desktop. Start the Kube-Cluster
and Initial setup of Kube-Cluster VMs
will run, then follow the instructions there.TL;DR
~/kube-cluster
foldermaster + two nodes
Kubernetes cluster on three VMs./Users/my_user
:/Users/my_user
on each boot, check the PV example how to use Persistent Volumes.kcluster
cli as well. Cli resides in ~/kube-cluster/bin
folder and has simple commands: kcluster start|stop|status|ip
. Just copy the kcluster
to your shell pre-set path.The install will do the following:
kube-cluster
folder in the user's home folder e.g /Users/someuser/kube-cluster
corectl
to initialise VM fleetctl, kubectl, helm and deis
clients to ~/kube-cluster/bin/
~/kube-cluster/fleet
, this allows very easy updates to fleet units if needed.xxx-data.img
will be created and mounted to VMs as /data
for these mount binds and other folders:/data/var/lib/docker -> /var/lib/docker
/data/var/lib/rkt -> /var/lib/rkt
/var/lib/kubelet sym linked to /data/kubelet
/data/opt/bin
/data/var/lib/etcd2
/data/kubernetes
Just start Kube-Cluster
application and you will find a small icon with the Kubernetes logo in the Status Bar.
There you can Up
, Halt
, Reload
CoreOS VMs
Under Up
and OS Shell
OS Shell (terminal) will have such environment set:
1) kubernetes master - export KUBERNETES_MASTER=http://192.168.64.xxx:8080
2) etcd endpoint - export ETCDCTL_PEERS=http://192.168.64.xxx:2379
3) fleetctl endpoint - export FLEETCTL_ENDPOINT=http://192.168.64.xxx:2379
4) fleetctl driver - export FLEETCTL_DRIVER=etcd
5) Path to ~/kube-cluster/bin where fleetctl, helmc, deis and kubectl are stored
Updates/Update Kubernetes to latest stable version
will update to latest stable version of Kubernetes.
Updates\Change Kubernetes version
allows you to insatll any Kubernetes version available on github.com.
Updates/Update macOS fleetctl, helmc and deis clients
will update fleetctl to the same versions as Kube-Cluster Master runs and helmc and deis to the latest versions.
SSH to k8smaster01 and k8snode-01/02
menu options will open VMs shell
Fleet-UI dashboard will show running fleet units and etc
Kubernetes Dashboard will show nice Kubernetes Dashboard, where you can check Nodes, Pods, Replication, Deployments, Service Controllers, deploy Apps and etc.
Example ouput of succesfull CoreOS + Kubernetes cluster install:
fleetctl list-units:
UNIT MACHINE ACTIVE SUB
fleet-ui.service 78ea6428.../192.168.64.5 active running
kube-apiserver.service 78ea6428.../192.168.64.5 active running
kube-controller-manager.service 78ea6428.../192.168.64.5 active running
kube-scheduler.service 78ea6428.../192.168.64.5 active running
kube-kubelet.service 1d00e269.../192.168.64.6 active running
kube-kubelet.service de9127a5.../192.168.64.7 active running
kube-proxy.service 1d00e269.../192.168.64.6 active running
kube-proxy.service de9127a5.../192.168.64.7 active running
Waiting for Kubernetes cluster to be ready. This can take a few minutes...
\...
Waiting for Kubernetes nodes to be ready. This can take a bit...
-...
node "k8snode-01" labeled
node "k8snode-02" labeled
Creating kube-system namespace ...
Installing SkyDNS ...
replicationcontroller "kube-dns-v17" created
service "kube-dns" created
Installing Kubernetes Dashboard ...
Deployment "kubernetes-dashboard-v1.4.0" created
service "kubernetes-dashboard" created
kubectl get nodes:
NAME STATUS AGE
k8snode-01 Ready 6s
k8snode-02 Ready 6s
You're now ready to use Kubernetes cluster.
Some examples to start with Kubernetes examples.
Kubernetes Solo Cluster VM App can be found here Kube-Solo for macOS.
Standalone CoreOS VM App (good for docker images building and testing) can be found here CoreOS VM for macOS.
CoreOS Cluster App without Kubernetes can be found here CoreOS Cluster for macOS.
Kube-Cluster for macOS is an open source project release under the Apache License, Version 2.0, hence contributions and suggestions are gladly welcomed!