Oh My Kubernetes!

An Ansible Playbook to automate the configuration of (Ubuntu Linux x86_64) machines to be ready for Kubernetes development. It cuts down the development environment preparation from tedious hours to less than 5 minutes.

Included software

The below are installed on both k8sdev and k8sdevlite groups:

• git
• kubectl
• helm
• skaffold
• k9s
• sops and helm secrets plugin
• azure-cli and kubelogin
• awscli
• kube-ps1
• tmux and .tmux
• kubectx/kubens

All of the above come with bash completion, whenever applicable.

The below are installed only on the k8sdev group:

• Docker Engine
• Kubernetes (microk8s)
• ingress-nginx

System requirements

1. Ansible on your controller machine (e.g. laptop) which is typically different from, but could be the same as, the target machine you are preparing. You also need a couple of Ansible collections, install using the command: ansible-galaxy collection install community.general community.kubernetes (Make sure that you are using Ansible > v2.9)

2. One or more SSH connections to the target machine(s) with public key authentication configured. You can do that by editing your .ssh/config. For example:

   # ~/.ssh/config
   Host awsdev1
       HostName 100.100.100.100
       User ubuntu
       IdentityFile ~/.ssh/id_rsa
       IdentitiesOnly yes

3. A configured Ansible hosts file with 2 sections called k8sdev and k8sdevlite containing all the machines you want to configure (yes you can configure many machines at once!). For example:

   # /etc/ansible/hosts
   [k8sdev]
   awsdev1 ansible_user=ubuntu
   1.2.3.4 ansible_user=anotheruser
   5.6.7.8 ansible_user=ubuntu
   ...
   [k8sdevlite]
   ...

The above file can be stored in the default location /etc/ansible/hosts if the control machine is running Debian/Ubuntu or a similar distro. For other distros or other operating systems, you can store it in any location then supply --inventory <file-location> to the ansible-playbook command.

Installation

To launch the installation process that will configure all target machines at once, run the following:

git clone https://github.com/hammady/ohmyk8s.git
cd ohmyk8s
ansible-playbook ohmyk8s.yaml -v

Note: ansible-playbook accepts -v for verbose mode (-vvv for more, -vvvv to enable connection debugging)

Sit (or stand!) and watch the results, you should get a report similar to the below if everything goes well:

...
PLAY RECAP *******************************
awsdev1                     : ok=56   changed=7    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0   

Caveats

• This only supports Ubuntu 20.04 running on x86_64 architectures. Support for other distributions and architectures is possible but needs some work. For example, the focal distro is hard-coded in some lines and should be detected.

Support

If there are any errors from the above command, please create an issue in this repo or drop me a line at: github at hammady dot net.

If you have any suggestions or enhancements, please feel free to create a PR or discuss with me. Please note that I am a total noob in Ansible, I learned it in the same day I created this repo.