An opinionated Kubernetes distribution with a focus on long-term on-prem deployments

MetalK8s offers a set of tools to deploy Kubernetes applications, given a set of standards for packaging such applications is respected.

For more information, please refer to the Integration Guidelines.

Prerequisites are listed here.

To build a MetalK8s ISO, simply type ./doit.sh.

For more information, please refer to the Building Documentation.

If you'd like to contribute, please review the Contributing Guidelines.

• Python3.6+
• tox
• Vagrant
• VirtualBox

# Install virtualbox guest addition plugin
vagrant plugin install vagrant-vbguest
# Bootstrap a platform on a vagrant environment using
./doit.sh vagrant_up

To run the test-suite locally, first complete the bootstrap step as outlined above, then:

# Run tests with tox
tox -e tests

• Python3.6+
• tox
• Plantuml

To generate HTML documentation locally in docs/_build/html, run the following command:

# Generate doc with tox
tox -e docs

MetalK8s version 1 is still hosted in this repository but is no longer maintained. The last release is MetalK8s 1.3.