ansible-role-kind

Installs & manages kind (Kubernetes in Docker)

Optionally it can setup one or more clusters including the nginx ingress controller
Project: https://kind.sigs.k8s.io
Github: https://github.com/kubernetes-sigs/kind

Dependencies

Roles

• deitkrachten.python
• deitkrachten.docker

Collections

• kubernetes.core
• kubernetes.core

Platforms

Supported platforms

• Red Hat Enterprise Linux 8¹
• Red Hat Enterprise Linux 9¹
• Red Hat Enterprise Linux 10¹
• RockyLinux 8
• RockyLinux 9
• RockyLinux 10
• OracleLinux 8
• OracleLinux 9
• OracleLinux 10
• AlmaLinux 8
• AlmaLinux 9
• AlmaLinux 10
• SUSE Linux Enterprise 15¹
• openSUSE Leap 15¹
• Debian 11 (Bullseye)
• Debian 12 (Bookworm)
• Debian 13 (Trixie)
• Ubuntu 20.04 LTS
• Ubuntu 22.04 LTS
• Ubuntu 24.04 LTS
• Fedora 41
• Fedora 42

Note: ¹ : no automated testing is performed on these platforms

Role Variables

defaults/main.yml

# Github CLI - API
kind_api: https://api.github.com/repos/kubernetes-sigs/kind

# Github CLI - repo
kind_repo: https://github.com/kubernetes-sigs/kind

# Lookup table for architecture
kind:
  architecture:
    x86_64: amd64
    i386: i386
    armv6l: arm
    armv7l: arm
    aarch64: arm64
  system:
    Linux: linux
    Darwin: darwin

# Construct filename based on the system & architecture
kind_file: "kind-{{ kind_system }}-{{ kind_architecture }}"

# Version of the CLI to install
kind_version: latest

# Location/ownership/permissions of the binary
kind_path: /usr/local/bin/kind
kind_owner: root
kind_group: root
kind_mode: '0755'

# List of clusters to create
kind_cluster_names: []

# Examples :
# kind_cluster_names:
# - name: cluster1
#   ingress: true
#   roles:
#     - control-plane
#     - worker
#     - worker
# - name: cluster2
#   template: templates/kind/cluster1.yml.j2

# OS packages
kind_os_packages:
  - python3-kubernetes
kind_pip_packages: []

Example Playbook

molecule/default/converge.yml

- name: sample playbook for role 'kind'
  hosts: all
  become: 'yes'
  vars:
    python_package_install_optional: true
    docker_compose_type: pip
    kind_cluster_names:
      - name: cluster1
        ingress: true
        roles:
          - control-plane
  roles:
    - deitkrachten.kubectl
  tasks:
    - name: Include role 'kind'
      ansible.builtin.include_role:
        name: kind