Build verifiably conformant kubernetes multi-node clusters in containers.
The FAQ, integrating the Parser in your own project, and how mokctl was created are all in Documentation.
All types of contributions are welcome, from giving this project a STAR, bug reports, success stories, feature requests, fixing typppos, correcting documentation, to coding. Also check the CONTRIBUTING.md document.
Take note of the Status below and the Releases page.
stable version - not yet.
development version - 0.8.10
OS Version Terminal Status Notes Ubuntu 18.04.4 gnome terminal works install as below Fedora 31 gnome terminal works disable cgroups2
install as belowFedora 32 gnome terminal works disable cgroups2
install as belowMac OS not tried
no reports receivedWindows not tried
no reports received
Note for Linux users: Cgroups 2 must be disabled. See Linux Installation Options.
Ensure Docker or Moby are installed first.
Add the following to your shell startup file, for example ~/.bashrc or ~/.zshrc:
alias mokbox='docker run --rm -ti --hostname mokbox --name mokbox -v /var/run/docker.sock:/var/run/docker.sock -v /var/tmp:/var/tmp myownkind/mokbox'Close the terminal and start it again so the alias is created.
Then 'log in' to the work container:
mokboxUse mokctl and kubectl, which are already installed in the 'mokbox' container:
mokctl build image --get-prebuilt-image
mokctl create cluster myk8s --masters 1
export KUBECONFIG=/var/tmp/admin-myk8s.conf
kubectl get pods -AType exit or Ctrl-d to 'log out' of the mokbox. The mokbox container will be deleted but the kubernetes cluster will remain, as will the kubectl file,/var/tmp/admin-myk8s.conf.
To remove the kubernetes cluster:
mokbox
export KUBECONFIG=/var/tmp/admin-myk8s.conf
mokctl delete cluster myk8s
exitTwo docker images will remain, 'myownkind/mokbox' and 'myownkind/mok-centos-7-v1.19.1'. Remove them to reclaim disk space, or keep them around to be able to quickly build kubernetes clusters.
See also:
Mokctl on Docker Hub - to alias the
mokctlcommand only, no mokbox.