3e83e3c301
I was receiving this error when running the task on my [Odroid HC1 running Armbian](https://www.armbian.com/odroid-hc1/): ``` TASK [xanmanning.k3s : Ensure target host architecture information is set as a fact] ************************************************************************** fatal: [odroid]: FAILED! => {"msg": "The task includes an option with an undefined variable. The error was: 'dict object' has no attribute 'armv7l'\n\nThe error appears to have been in '/home/jdmarble/.ansible/roles/xanmanning.k3s/tasks/download-k3s.yml': line 3, column 3, but may\nbe elsewhere in the file depending on the exact syntax problem.\n\nThe offending line appears to be:\n\n\n- name: Ensure target host architecture information is set as a fact\n ^ here\n"} ``` I worked around the problem by overriding `k3s_arch_lookup` in my play book: ```yaml --- - hosts: all roles: - role: xanmanning.k3s k3s_arch_lookup: armv7l: arch: arm suffix: "-armhf" ``` |
||
|---|---|---|
| defaults | ||
| handlers | ||
| meta | ||
| tasks | ||
| templates | ||
| tests | ||
| vars | ||
| .gitignore | ||
| LICENSE | ||
| README.md | ||
Ansible Role: k3s
Ansible role for installing Racher Labs k3s ("Lightweight Kubernetes") as either a standalone server or cluster.
Requirements
This role has been tested on Ansible 2.6.0+ against the following Linux Distributions:
- CentOS 7
- Debian 9
- Ubuntu 18.04 LTS
Disclaimer
⚠️ Not suitable for production use.
Whilst Rancher Labs are awesome, k3s is a fairly new project and not yet a v1.0 release so extreme caution and operational rigor is recommended before using this role for any serious development.
Role Variables
Group Variables
Below are variables that are set against all of the play hosts for environment consistency.
| Variable | Description | Default Value |
|---|---|---|
k3s_release_version |
Use a specific version of k3s, eg. v0.2.0. Specify false for latest. |
false |
k3s_github_url |
Set the GitHub URL to install k3s from. | https://github.com/rancher/k3s |
k3s_install_dir |
Installation directory for k3s. | /usr/local/bin |
k3s_control_workers |
Are control hosts also workers? | true |
k3s_ensure_docker_installed |
Use Docker rather than Containerd? | false |
Important note about k3s_release_version
If you do not set a k3s_release_version the latest version of k3s will be
installed. If you are developing against a specific version of k3s you must
ensure this is set in your Ansible configuration, eg:
k3s_release_version: v0.2.0
Host Variables
Below are variables that are set against specific hosts in your inventory.
| Variable | Description | Default Value |
|---|---|---|
k3s_control_node |
Define the host as a control plane node, (True/False). | false |
Important note about k3s_control_node
Currently only one host can be defined as a control node, if multiple hosts are set to true the play will fail.
If you do not set a host as a control node, the role will automatically delegate the first play host as a control node.
Dependencies
No dependencies on other roles.
Example Playbook
Example playbook:
- hosts: k3s_nodes
roles:
- { role: xanmanning.k3s, k3s_release_version: v0.2.0 }
License
BSD