bashtools / mokctl Goto Github PK

View Code? Open in Web Editor NEW

110.0 6.0 13.0 3.23 MB

Build verifiably conformant multi-node kubernetes clusters in containers.

License: Apache License 2.0

Dockerfile 1.73% Shell 96.80% Makefile 1.48%

kubernetes kind laptop

mokctl's Introduction

My Own Kind

View a Transcript of the screenscast.

Features

Tracks the latest stable version
After downloading 'build' images a single node cluster builds in under 60 seconds
Very simple to use without need for YAML files
Builds kubernetes master and worker nodes in containers
Can create multi-master and multi-node clusters
Can create an haproxy load balancer to front master nodes with '--with-lb'
For multi-node clusters the 'create cluster' command returns when kubernetes is completely ready, with all nodes and pods up and ready.
Can skip master, worker, or load balancer set up
- In this case the set-up scripts are placed in /root in the containers
- The set-up scripts can be run by hand
- Can do kubernetes the hard way (see kthwic)
Each release tested by AI and test logs saved in e2e-logs
Build and create can show extensive logs with '--tailf'
Supports docker, podman and moby
Written in Bash in the style of Go for maintainability - see Why Bash? and src/

Install on Linux, Mac or Windows

Note for Fedora 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:

mokbox

Use 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 -A

Type exit or Ctrl-d to 'log out' of 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

exit

Two 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.

mokctl's People

Contributors

Stargazers

Watchers

Forkers

resonancellc jpdro rojocodes syscloudorg mrbrandao aaam csantanapr kap4102 jagipson devopstoday11 maksim-se opfour shepardo

mokctl's Issues

Bash and zsh completion

Is your feature request related to a problem? Please describe.
A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]

When I'm writing mokctl commands I would like to be able to use tab to complete the options

Describe the solution you'd like
A clear and concise description of what you want to happen.

bash and zsh completion

Describe alternatives you've considered
A clear and concise description of any alternative solutions or features you've considered.

There are none I can think of

Additional context
Add any other context or screenshots about the feature request here.

Try mokbox on Mac OS

https://hub.docker.com/r/mclarkson/mokctl
Write in this issue if it works on Mac OS (supply the version) or not, thanks!

Make JSONPath.sh use the MOK shell programming style.

Describe the bug
JSONPath.sh has been imported to remove nasty sed lines from the mokctl code, but JSONPath.sh pollutes the global namespace.

To Reproduce
Look at the top of JSONPath.sh. It pollutes the global namespace.

Expected behavior
Its global variables should be in the MOK shell style - in an associative array.

Screenshots
N/A

Desktop (please complete the following information):
N/A

Smartphone (please complete the following information):
N/A

Additional context
All globals should be put in an associative array, _JP maybe. It should initialise itself.

Try mokbox on Windows

https://hub.docker.com/r/mclarkson/mokctl
Write in this issue if it works on Windows (supply the version) or not, thanks!

Extend mokctl to add worker nodes

CLI Interface extension:

mokctl edit cluster CLUSTNAME add worker X
mokctl edit cluster CLUSTNAME delete worker X

or something similar.

Extend mokctl to `mokctl exec` into a 'node'

Is your feature request related to a problem? Please describe.
A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]

After a cluster is installed I would like to use mokctl exec to exec into it rather than using docker exec

Describe the solution you'd like
A clear and concise description of what you want to happen.

mokctl exec myclust-master-1 - to exec into the myclust cluster master-1 node.

mokctl exec - will give me a list of nodes I can log into (probably using select) then I just press the number and enter.

Describe alternatives you've considered
A clear and concise description of any alternative solutions or features you've considered.

Using docker exec is fine, I just want a shorter version.

Additional context
Add any other context or screenshots about the feature request here.

bashtools / mokctl Goto Github PK

mokctl's Introduction

My Own Kind

Features

Install on Linux, Mac or Windows

mokctl's People

Contributors

Stargazers

Watchers

Forkers

mokctl's Issues

Bash and zsh completion

Try mokbox on Mac OS

Make JSONPath.sh use the MOK shell programming style.

Try mokbox on Windows

Extend mokctl to add worker nodes

Extend mokctl to `mokctl exec` into a 'node'

Recommend Projects

React

Vue.js

Typescript

TensorFlow

Django

Laravel

D3

Recommend Topics

javascript

web

server

Machine learning

Visualization

Game

Recommend Org

Facebook

Microsoft

Google

Alibaba

D3

Tencent