vmware-archive / wardroom

A tool for creating Kubernetes-ready base operating system images.
Apache License 2.0
161 stars 44 forks source link
ansible image kubernetes tools

wardroom

Wardroom provides tooling that helps simplify the deployment of a Kubernetes cluster. More specifically, Wardroom provides the following functionality:

Both use cases share a common set of Ansible roles that can be found in the ansible directory.

Image Building

Wardroom leverages Packer to build golden images of Kubernetes deployments across a wide variety of operating systems as well as image formats. During the build phase, Wardroom leverages Ansible to configure the base operating system and produce the Kubernetes-ready golden image.

This functionality is used to create base images for the Heptio aws-quickstart.

Supported Image Formats

Supported Operating Systems

Deployment Orchestration

The swizzle directory contains an Ansible playbook that can be used to orchestrate the deployment of a Kubernetes cluster using kubeadm.

Documentation

Documentation and usage information can be found in the docs directory.

Contributing

See our contributing guidelines and our code of conduct. Contributions welcome by all.

Development

Vagrant may be used to test local ansible playbook development. In this scenario, Vagrant makes use of the ansible provisioner to configure the resulting operating system image. To test all operating systems simultaneously:

vagrant up

You may also selectively test a single operating system as such:

vagrant up [xenial|bionic|centos7]

To enable verbose ansible logging, you may do so by setting the WARDROOM_DEBUG environment variable to 'vvvv'.

The default Vagrant provisioner is Virtualbox, but other providers are possible by way of the vagrant-mutate plugin.