xoxys.k3s/README.md

375 lines
6.2 KiB
Markdown

# 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)