gsuryatej / kubeinit

Ansible automation to have a KUBErnetes cluster INITialized as soon as possible...

The KUBErnetes INITiator

Abstract

KubeInit provides Ansible playbooks and roles for the deployment and configuration of multiple Kubernetes distributions. The main goal of KubeInit is to have a fully automated way to deploy in a single command a curated list of prescribed architectures.

Documentation

KubeInit's documentation is hosted in this same repository. The documentation is rendered using Sphinx and uploaded to GitHub pages using a GitHub action.

Requirements

• A server with enough RAM and disk space (120GB in RAM and 300GB in disk).
• A hypervisor with Centos 8.
• We assume that the hypervisor node is called nyctea (defined in the inventory).
• Have root access with certificates.
• Adjust the inventory file to suit your needs i.e. the worker nodes you will need in your cluster.

ssh root@nyctea
ssh-keygen -t rsa -f ~/.ssh/id_rsa -q -P ""
curl -sS https://github.com/<your_github_username>.keys >> ~/.ssh/authorized_keys
exit

How to run

The following example command will deploy a multi-master OKD 4.5 cluster with 1 worker node in a single command and in approximately 30 minutes.

git clone https://github.com/ccamacho/kubeinit.git
cd kubeinit
ansible-playbook \
    --user root \
    -v -i ./hosts/okd/inventory \
    --become \
    --become-user root \
    ./playbooks/okd.yml

After provisioning any of the scenarios, you should have your environment ready to go.

To connect to the nodes from the hypervisor use the IP addresses from the inventory files.