Skip to content

Theme color

k3s

Install and configure a single-server k3s cluster with kube-vip.

Usage

playbook.yml
- hosts: all
roles:
- role: giftpilz0.kubernetes.k3s

Variables

  • k3s install version.

    Defaultv1.37.1+k3s1
  • virtual IP for the API server.

    Default{{ hostvars[groups['k3s'][0]]['ansible_host'] | default(groups['k3s'][0]) }}
  • API server port.

    Default6443
  • shared cluster token for node authentication.

    DefaultW7hzb52sN7wpDHv2ayzQYfLz4tH2pQvpyg3vKe2iAK577bStCuruqeftKjwkd34
  • additional arguments passed to k3s server.

    Default--tls-san {{ k3s_vip_api_endpoint }} --flannel-backend=none --disable-network-policy --disable-helm-controller --disable metrics-server --disable servicelb --disable traefik --selinux
  • systemd service unit name.

    Defaultk3s.service
  • desired state of the k3s service.

    Choicesreloadedrestartedstartedstopped
    Defaultstarted
  • whether the k3s service is enabled at boot.

    Defaulttrue
  • kube-vip container image tag.

    Defaultv1.3.1
  • network interface for kube-vip.

    Defaultenp6s18
  • cluster service CIDR range.

    Default10.43.0.0/16
  • cluster pod CIDR range.

    Default10.42.0.0/16
  • desired state of firewall rules.

    Choicespresentabsentenableddisabledskip
    Defaultenabled
  • firewall zone for k3s rules.

    Defaultkubernetes
  • whether to install and configure cilium.

    Defaulttrue
  • k9s version tag passed to the k9s role.

    Default0.51.0
  • flux CLI version tag passed to the fluxcli role.

    Default2.9.6
  • helm version tag passed to the helm role.

    Default4.3.1
  • cilium chart version passed to the cilium role.

    Default1.20.3