Overview

Ansible to create and configure minikube clusters.

Install role

ansible-galaxy role install kameshsampath.minikube

Role Variables

Variable Name	Description	Default
minikube_create	If True creates the cluster	True
minikube_destroy	If True destroys the cluster	False
minikube_version	The minikube version	v1.24.0
minikube_home_dir	The directory where minikube files will be stored	{{ playbook_dir }}/.minikube
minikube_driver	The minikube driver	hyperkit
minikube_memory	The memory to use for minikube	8g
minikube_cpus	The cpus to use for minikube	4
minikube_disk_size	The disk size to use for minikube	50g
minikube_kubernetes_version	The kubernetes version to use	stable
kubeconfig_dir	The directory to create the flattened kubeconfig	{{ playbook_dir }}/.kube

minikube_profiles is used to configure the minikube profiles(clusters) that will be created while using the role,

The default value of minikube_profiles is:

minikube_profiles: 
  minikube:
    create: yes
    destroy: no
    addons:
     - registry
     - registry-aliases
     - metallb

A minikube dictionary as shown above will create minikube profile named minikube with 8g of RAM and 4 cpus. The profile also enables the addons registry,registry-aliases and metallb. The create attribute determines if this profile needs to be created, similarly destroy will determine if the cluster is to be deleted.

Note

The minkube_profiles create and destroy are mutally exclusive.

Overriding default values

All the role variables like minikube_* could be overriden at the profile level. When overiding the value at profile level make sure you add attribute name without minikube_ prefix.

Lets say we want to create minikube cluster with 4 cpus, 16G ram and 100g hard-disk, then the minikube profile looks like,

minikube_profiles: 
  minikube:
    create: yes
    destroy: no
    cpus: 4
    memory: 16g
    disk_size: 100g
    addons:
     - registry
     - registry-aliases
     - metallb

Example playbooks

Creating a minikube Cluster(s)

- name: "Create minikube Clusters"
  hosts: all
  vars:
    # the demo work directory
    work_dir: "{{ playbook_dir }}/work"
    # the kubeconfig directory
    kubeconfig_dir: "{{ work_dir }}/.kube"
    # the kubernetes version to use with minikube
    minikube_kubernetes_version: v1.21.6
    # the minikube home directory
    minikube_home_dir: "{{ work_dir }}/.minikube"
    # minikube profiles
    minikube_profiles:
      mgmt: # profile name and Kubernetes context name
        create: yes
        destroy: no
        memory: 16g # override the default memory, note the attribute name without prefix _minikube
        addons:
          - metallb
        lbStartIP: 192.168.64.80
        lbEndIP: 192.168.64.90
      cluster1: # profile name and Kubernetes context name
        create: yes
        destroy: no
        addons:
          - metallb
        lbStartIP: 192.168.64.110
        lbEndIP: 192.168.64.120
  roles:
    - role: kameshsampath.minikube

  # Some extra configurations
  tasks:
    - name: "Configure metallb"
      ansible.builtin.expect:
        command: "{{ minikube_binary }} -p {{ item.key }} addons configure metallb"
        responses:
          "-- Enter Load Balancer Start IP:": "{{ item.value.lbStartIP}}"
          "-- Enter Load Balancer End IP:": "{{ item.value.lbEndIP}}"
      loop: "{{ minikube_profiles | dict2items }}"
      loop_control:
         label: "{{ item.key }}"
      register: lb_setup_result
      when: item.value.create and not item.value.destroy

Deleting minikue Cluster(s)

- name: "Delete minikube Cluster(s)"
  hosts: all
  vars:
    # the demo work directory
    work_dir: "{{ playbook_dir }}/work"
    # the kubeconfig directory
    kubeconfig_dir: "{{ work_dir }}/.kube"
    # the kubernetes version to use with minikube
    minikube_kubernetes_version: v1.21.6
    # the minikube home directory
    minikube_home_dir: "{{ work_dir }}/.minikube"
    # minikube profiles
    minikube_profiles:
      mgmt: # profile name and Kubernetes context name
        create: no
        destroy: yes
      cluster1: # profile name and Kubernetes context name
        create: no
        destroy: yes
  roles:
    - role: kameshsampath.minikube