An Ansible role for ensuring the configuration of an Agent K3s worker node.
Requires Docker installed.
The role installs on CentOS 7, Alpine 3.10 and Ubuntu Bionic.
| Variable | Required | Default | Choices | Comments |
|---|---|---|---|---|
| default_retries | yes | 60 | Integer value | default number of retries |
| default_delay | yes | 60 | Integer value | default delay in seconds between retries |
| k3s_version | yes | v1.19.4+k3s1 | matches release tag | k3s version to install |
| k3s_server_hostname | yes | 192.168.0.10 | String | The address of the server |
| k3s_flannel_iface | no | not defined | String | Either provide (e.g., eth0) or the role will |
| vault_k3s_cluster_secret | yes | String | Please, set via Ansible vault | |
| retrieve_kubeconfig | no. | false | Boolean | Retreive the kubeconfig file |
| images_cache_path | no | not defined | Path | Path to folder used to cache saved Docker images |
| cache_container_timeout | no | 300 seconds | Integer value | Number of seconds before Ansible times out |
An example can be found used in my Hands-on DevOps course's ansible/master-playbook.yml.
- hosts: masters
remote_user: vagrant
roles:
- common
- docker
- k3s-agent
The above Ansible playbook uses my
- Common role to configure the instance past the base CentOS 7, Alpine 3.10 or Ubuntu Bionic image
- Docker role to install and configure Docker
- This role to install Lightweight Kubernetes (K3s)
For more information and to see this role put into action checkout my Hands-on DevOps class project.
The K3s cluster secret is set by vault_k3s_cluster_secret. Please, ansible vault this variable.
3-Clause BSD License
Michael Joseph Walsh mjwalsh@nemonik.com