# xoxys.k3s

[![Build Status](https://ci.rknet.org/api/badges/ansible/xoxys.k3s/status.svg)](https://ci.rknet.org/repos/ansible/xoxys.k3s)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?label=license)](https://gitea.rknet.org/ansible/xoxys.k3s/src/branch/main/LICENSE)

Setup K3s cluster nodes.

## Table of content

- [Requirements](#requirements)
- [Default Variables](#default-variables)
  - [k3s_flannel_external_ip](#k3s_flannel_external_ip)
  - [k3s_flannel_ipv6_masq_enabled](#k3s_flannel_ipv6_masq_enabled)
  - [k3s_init_log_enabled](#k3s_init_log_enabled)
  - [k3s_iscsi_enabled](#k3s_iscsi_enabled)
  - [k3s_node_ip](#k3s_node_ip)
  - [k3s_node_labels](#k3s_node_labels)
  - [k3s_node_name](#k3s_node_name)
  - [k3s_packages](#k3s_packages)
  - [k3s_packages_extra](#k3s_packages_extra)
  - [k3s_protect_kernel_defaults](#k3s_protect_kernel_defaults)
  - [k3s_reset](#k3s_reset)
  - [k3s_selinux_enabled](#k3s_selinux_enabled)
  - [k3s_server](#k3s_server)
  - [k3s_server_admission_configuration](#k3s_server_admission_configuration)
  - [k3s_server_admission_plugins](#k3s_server_admission_plugins)
  - [k3s_server_bind_ip](#k3s_server_bind_ip)
  - [k3s_server_cloud_controller_enabled](#k3s_server_cloud_controller_enabled)
  - [k3s_server_cluster_cidr](#k3s_server_cluster_cidr)
  - [k3s_server_cluster_dns](#k3s_server_cluster_dns)
  - [k3s_server_cluster_domain](#k3s_server_cluster_domain)
  - [k3s_server_components_disabled](#k3s_server_components_disabled)
  - [k3s_server_feature_gates](#k3s_server_feature_gates)
  - [k3s_server_flannel_backend_enabled](#k3s_server_flannel_backend_enabled)
  - [k3s_server_kube_proxy_enabled](#k3s_server_kube_proxy_enabled)
  - [k3s_server_manifests_templates](#k3s_server_manifests_templates)
  - [k3s_server_manifests_urls](#k3s_server_manifests_urls)
  - [k3s_server_network_policy_enabled](#k3s_server_network_policy_enabled)
  - [k3s_server_nodes](#k3s_server_nodes)
  - [k3s_server_resource_creations](#k3s_server_resource_creations)
  - [k3s_server_resource_patches](#k3s_server_resource_patches)
  - [k3s_server_service_cidr](#k3s_server_service_cidr)
  - [k3s_server_service_node_port_range](#k3s_server_service_node_port_range)
  - [k3s_server_workload_enabled](#k3s_server_workload_enabled)
  - [k3s_token](#k3s_token)
  - [k3s_version](#k3s_version)
- [Dependencies](#dependencies)
- [License](#license)
- [Author](#author)

---

## Requirements

- Minimum Ansible version: `2.10`

## Default Variables

### k3s_flannel_external_ip

#### Default value

```YAML
k3s_flannel_external_ip: _unset_
```

### k3s_flannel_ipv6_masq_enabled

#### Default value

```YAML
k3s_flannel_ipv6_masq_enabled: false
```

### k3s_init_log_enabled

#### Default value

```YAML
k3s_init_log_enabled: false
```

### k3s_iscsi_enabled

#### Default value

```YAML
k3s_iscsi_enabled: false
```

### k3s_node_ip

#### Default value

```YAML
k3s_node_ip:
  - '{{ ansible_default_ipv4.address }}'
```

### k3s_node_labels

#### Default value

```YAML
k3s_node_labels: {}
```

### k3s_node_name

#### Default value

```YAML
k3s_node_name: '{{ ansible_hostname }}'
```

### k3s_packages

#### Default value

```YAML
k3s_packages:
  - epel-release
  - python3-kubernetes
  - container-selinux
  - selinux-policy-base
```

### k3s_packages_extra

#### Default value

```YAML
k3s_packages_extra: []
```

### k3s_protect_kernel_defaults

#### Default value

```YAML
k3s_protect_kernel_defaults: false
```

### k3s_reset

#### Default value

```YAML
k3s_reset: false
```

### k3s_selinux_enabled

#### Default value

```YAML
k3s_selinux_enabled: false
```

### k3s_server

#### Default value

```YAML
k3s_server: true
```

### k3s_server_admission_configuration

#### Default value

```YAML
k3s_server_admission_configuration:
  - name: EventRateLimit
    configuration:
      kind: Configuration
      apiVersion: eventratelimit.admission.k8s.io/v1alpha1
      limits:
        - type: Namespace
          qps: 50
          burst: 100
          cacheSize: 2000
        - type: User
          qps: 10
          burst: 50
```

### k3s_server_admission_plugins

#### Default value

```YAML
k3s_server_admission_plugins:
  - NodeRestriction
  - EventRateLimit
  - ServiceAccount
  - NamespaceLifecycle
```

### k3s_server_bind_ip

#### Default value

```YAML
k3s_server_bind_ip: 0.0.0.0
```

### k3s_server_cloud_controller_enabled

#### Default value

```YAML
k3s_server_cloud_controller_enabled: true
```

### k3s_server_cluster_cidr

#### Default value

```YAML
k3s_server_cluster_cidr:
  - 10.42.0.0/16
```

### k3s_server_cluster_dns

#### Default value

```YAML
k3s_server_cluster_dns: 10.43.0.10
```

### k3s_server_cluster_domain

#### Default value

```YAML
k3s_server_cluster_domain: cluster.local
```

### k3s_server_components_disabled

#### Default value

```YAML
k3s_server_components_disabled:
  - traefik
```

### k3s_server_feature_gates

#### Default value

```YAML
k3s_server_feature_gates: []
```

### k3s_server_flannel_backend_enabled

#### Default value

```YAML
k3s_server_flannel_backend_enabled: true
```

### k3s_server_kube_proxy_enabled

#### Default value

```YAML
k3s_server_kube_proxy_enabled: true
```

### k3s_server_manifests_templates

#### Default value

```YAML
k3s_server_manifests_templates: []
```

### k3s_server_manifests_urls

#### Default value

```YAML
k3s_server_manifests_urls: []
```

### k3s_server_network_policy_enabled

#### Default value

```YAML
k3s_server_network_policy_enabled: true
```

### k3s_server_nodes

#### Default value

```YAML
k3s_server_nodes:
  - '{{ ansible_hostname }}'
```

### k3s_server_resource_creations

#### Default value

```YAML
k3s_server_resource_creations: []
```

### k3s_server_resource_patches

#### Default value

```YAML
k3s_server_resource_patches: []
```

### k3s_server_service_cidr

#### Default value

```YAML
k3s_server_service_cidr:
  - 10.43.0.0/16
```

### k3s_server_service_node_port_range

#### Default value

```YAML
k3s_server_service_node_port_range: 30000-32767
```

### k3s_server_workload_enabled

#### Default value

```YAML
k3s_server_workload_enabled: true
```

### k3s_token

#### Default value

```YAML
k3s_token: secure-token
```

### k3s_version

#### Default value

```YAML
k3s_version: 1.28.6+k3s2
```

## Dependencies

None.

## License

MIT

## Author

[Robert Kaussow](https://gitea.rknet.org/xoxys)