jcwimer / kubernetes-ansible

kubernetes-ansible

Deploy kubernetes with rke with ansible.

Deploy

Requirements

1. Python
2. Pip
3. Pipenv
4. Nodes already deployed and running with ubuntu.
5. SSH access to all nodes you're deploying to.
   • You will need to define an environment variable for your ssh key. export PRIVATE_KEY="/location/of/key"

Steps

1. Copy hosts.example to hosts
   • Name the node and under ansible_host put the ip of the node.
   • Master nodes run the control plane. See kubernetes documentation for more info on masters: https://kubernetes.io/docs/concepts/overview/components/
   • Workers are nodes used for running containers.
2. Copy group_vars/all.example to group_vars/all
   • Fill out with the settings that pertain to your configuration.
3. Run bash supporting-scripts/run-setup.sh

Lab environment

You can easily run a lab environment with Vagrant.

Requirements

1. Install Virtualbox
2. Install Vagrant

Steps

1. Run vagrant up - This will deploy 5 machines. A "client" node for running the deploy with ansible. A master node and 3 worker nodes.
2. Run vagrant ssh client -c 'bash /vagrant/tests/files/test-deploy.sh'
3. Run vagrant ssh master then run kubectl commands like kubectl get nodes or kubectl get pods --all-namespaces
4. Kubernetes nodes will be running on a host-only network that you can access from your machine with ips 192.168.254.2-5.

To see what is going on, this has deployed Traefik as an ingress controller to kubernetes. To get Traefik's port, run kubectl get services -n kube-system on the master. Then navigate to http://192.168.254.2:traefikport on your browser.

To destroy these machines, run vagrant destroy -f.

Development

This project is tested with bash and Vagrant.

Requirements

1. Virtualbox
2. Vagrant

Running tests

bash tests/vagrant-tests.sh