christianlempa-boilerplates/ansible/installation/inst-k8s/README.md

Kubernetes (K8s) Installation Script

• Introduction
• Prerequisites
• Execution Instructions

Introduction

The objective of this playbook is to automate the installation and setup of a kubernetes instance. The playbook consist of 3 main plays. For both controller and nodes, for controller only and for nodes only. It will ask user confirmation before moving on to each stage. By the end of the playbook two files will be created on the controller node named worker_conn_string and locally inside the playbook directory with the name Remote_Files/worker_conn_string. This will have the connection string. (Note:- If you want to join controllers or nodes manually later. For controllers use --control-plane flag)

References

Documentation - https://kubernetes.io/docs/setup/

Prerequisites

• Atleast 2 VMs (1 For Control Node and 1 For Worker Node).
• Static IPs should be set along with unique host names.
• Inventory should be in this format

    [controllers]
    host_name ansible_ssh_host=<IP> ansible_user='<USERNAME>' ansible_become_pass='<PASSWORD>'

    [nodes]

    [instance:children]
    controllers
    nodes

(If you want to change this, don't forget to change the inst-k8s as well)

Execution Instructions

ansible-playbook -i <INVENTORY> <PLAYBOOK>

Optional Flags

Flag	Use Case
--ask-vault-pass	If the vault is encrypted
--start-at-task	If you want to start from a specific task
--tags	If you want to only run a specific group of tasks