Documentation
Guide
Configuration
Roles
K3s

K3s

The role performs various tasks related to OS configuration, K3s cluster deployment, reset and validation.

Role Settings

See the related role settings listed below, defined into main.yaml defaults file.

k3s_vars.directory

  • Default value: null

See the related child settings, listed below.

directory.bin

  • Default value: string, /usr/local/bin

directory.config

  • Default value: string, /etc/rancher/k3s

directory.kubeconfig

  • Default value: string, /Users/username/.kube

directory.lib

  • Default value: string, /var/lib/rancher/k3s

k3s_vars.kubelet

  • Default value: list

k3s_vars.network

  • Default value: null

See the related child settings, listed below.

network.interface

  • Default value: string, eth0

k3s_vars.release

  • Default value: null

See the related child settings, listed below.

release.checksum

  • Default value: string, sha256sum-arm64.txt

release.file

  • Default value: string, k3s-arm64

release.repository

  • Default value: null
repository.name
  • Default value: string, k3s
repository.org
  • Default value: string, k3s-io

release.version

  • Default value: string

Visit k3s-io/k3s, for latest release version.

k3s_vars.server

  • Default value: null

See the related child settings, listed below.

server.api

  • Default value: null
api.host
  • Default value: string, 192.168.4.10
api.port
  • Default value: integer, 6443

server.cluster

  • Default value: null
cluster.dns
  • Default value: string, 10.43.0.10
cluster.domain
  • Default value: string, cluster.local

server.controlplane

  • Default value: null
controlplane.tainted
  • Default value: boolean, true

server.kubeconfig

  • Default value: null
kubeconfig.local
  • Default value: boolean, true

Copies the remote /.kube/config to local computer.

server.loadbalancer

  • Default value: null
loadbalancer.host
  • Default value: string, 127.0.0.1

Host for apiserver client load-balancer.

loadbalancer.port
  • Default value: integer, 6444

Port for apiserver client load-balancer.

k3s_vars.service

  • Default value: null

See the related child settings, listed below.

service.debug

  • Default value: boolean, false

Deploys the K3s service with debug mode enabled.

k3s_vars.tolerations

  • Default value: list

Role Tasks

See the related role tasks, listed below.

Facts

Ansible facts, see facts.yaml for details.

Load Balancer

Load balancer related tasks, see loadbalancer.yaml for details.

Main

Main role related tasks, see main.yaml for details.

Reset

Reset related tasks, see reset.yaml for details.

Validation

Validation related tasks, see validation.yaml for details.

Role Templates

See the related role templates, listed below.

Configuration

Cluster configuration template, see config.j2 for details.

HAProxy

HAProxy configuration template, see haproxy.j2 for details.

KeepAlived

KeepAlived configuration template, see keepalived.j2 for details.

Registries

Registries configuration template, see registries.j2 for details.

Service

Service configuration template, see service.j2 for details.

RolesArgoCD