12 KiB
Change Log
2022-11-15, v3.3.1
Notable changes
- fix: length indentation in registry.yaml
2022-09-11, v3.3.0
Notable changes
- fix:
no_log
removed fromansible.builtin.uri
tasks - feat:
k3s_skip_post_checks
option added
2022-06-17, v3.2.0
Notable changes
- feature: added support for alpine #182
- fix:
k3s_control_token
not working #187
2022-05-02, v3.1.2
Notable changes
- fix: molecule tests
2022-02-18, v3.1.1
Notable changes
- fix: support nftables for debian 11
Contributors
2022-01-30, v3.1.0
Notable changes
- feat: use basename of url for items in
k3s_server_manifests_urls
andk3s_server_pod_manifests_urls
if filename is not provided #177
Contributors
2022-01-06, v3.0.1
Notable changes
- fix: adding become to pre checks packages #173
Contributors
2022-01-02, v3.0.0
Notable changes
- feat: Flattened task filesystem
- feat: Moved some tasks into
vars/
as templated variables - feat: Airgap installation method added #165
Breaking changes
- Minimum
python
version on targets is 3.6 k3s_become_for_all
renamed tok3s_become
k3s_become_for_*
removed.
Contributors
2021-12-23, v2.12.1
Notable changes
- Fix typo in systemd unit file
Contributors
2021-12-20, v2.12.0
Notable changes
- Fix RockyLinux HA etcd tests
- add Debian 11 test
- Fix Snapshotter in Molecule tests
- Added missing documentation for
k3s_api_url
- Added option to change K3s updates API url
- Custom environment variables in systemd unit files
- Debian Bullseye support
- Fix HA etcd cluster startup
- Fix rootless for Debian
Contributors
2021-10-10, v2.11.1
Notable changes
- docs: fixed references to
write-kubeconfig-mode
to set correct permissions #157 - fix: Flag --delete-local-data has been deprecated #159
2021-09-08, v2.11.0
Notable changes
- docs: example of IPv6 configuration
- feat: checks for s3 backup configuration
- feat: implement config.yaml.d
Contributors
2021-08-18, v2.10.6
Notable changes
- Fix: Define registration address from node-ip #142
2021-08-14, v2.10.5
Notable changes
- Add advertised address #139
Contributors
2021-07-24, v2.10.4
Notable changes
- Updated systemd template to use token when joining a cluster #138
2021-07-21, v2.10.3
Notable changes
- fix: typo #133
- fix: restore clustering and avoid failure with jinja2_native=true #135
- fix: do ignore etcd member count when uninstalling #136
Contributors
2021-06-22, v2.10.2
Notable changes
- Role is now tested against RockyLinux
2021-05-30, v2.10.1
Notable changes
- Case insensitive control node lookup #126
Contributors
2021-05-27, v2.10.0
Notable changes
- Only deploy templates on primary controller #119
- Allow control plane static pods #120
- Add support for specifying URLs in templates #124
Contributors
2021-05-14, v2.9.1
Notable changes
- Documentation, remove references to deprecated configuration techniques #115
- Bugfix: Templating issue.
2021-05-13, v2.9.0
Notable changes
- Feature: Support k3s private registry configuration #114
Contributors
2021-05-06, v2.8.5
Notable changes
- Bugfix: Unmount CSI plugin folder to avoid data lost on uninstall #113
Contributors
2021-05-01, v2.8.4
Notable changes
- Fixed issue with draining nodes #112
Contributors
2021-04-18, v2.8.3
Notable changes
- Typo fix in README.md #110
- Fixed check mode for cgroup test #111
- Added check mode into molecule test sequence
inventory.yml
is nowblockinfile
Contributors
2021-04-10, v2.8.2
Notable changes
- #105 - Added Ansible v2.9.16 support
- #102 - Pre-check for cgroup status
Known issues
- As per README.md, you require
ansible
>= 2.9.16 oransible-base
>= 2.10.4. See #105(comment)
2021-03-22, v2.8.1
Notable changes
- #100 - Fixed typo in README.md
Contributors
2021-03-14, v2.8.0
Happy π day!
Notable changes
- Updated GitHub Actions, resolved linting errors.
- Renamed
k3s_control_node_address
->k3s_registration_address
Breaking changes
- A task has been added to rename
k3s_control_node_address
tok3s_registration_address
for any users still using this variable name, however this might still break something.
2021-02-28, v2.7.1
Notable changes
- Bugfix, missing become on cluster token check.
2021-02-27, v2.7.0
Notable changes
- Cluster init checks added.
- Tidy up of tasks, failed checks.
- Possible fix for #93 - force draining of nodes added.
2021-02-27, v2.6.1
Notable changes
- Bugfix: Templating error for single control plane nodes using Etcd.
- Bugfix: a number of typos fixed.
2021-02-16, v2.6.0
Notable changes
- Tidy up of
when
params andassert
tasks to be more readable. - Added feature to tweak K3S service dependencies.
- Updated documentation:
- Node labels and component arguments
- systemd config
- Use alternate CNI (Calico example)
2021-01-31, v2.5.3
Notable changes
- Bugfix, missing update to minimum ansible version var #91.
2021-01-30, v2.5.2
Notable changes
- Bugfix, missing
k3s_start_on_boot
to controlsystemd.enabled
added.
2021-01-30, v2.5.1
Notable changes
- Added uninstall task to remove hard-linked files #88
- Fixed missing become for
systemd
operations tasks. #89 - Added
k3s_start_on_boot
to controlsystemd.enabled
.
2021-01-24, v2.5.0
Notable changes
- Added support for Ansible >= 2.9.17 #83
2021-01-23, v2.4.3
Notable changes
- Bufgix: Installation hangs on "Check that all nodes to be ready" #84
2021-01-10, v2.4.2
Notable changes
- Bufgix: Docker check still failing on "false"
2021-01-02, v2.4.1
Notable changes
- Fixed issue with armv6l (Raspberry Pi Zero W)
- Added path for private repositories config to directory creation list.
2020-12-21, v2.4.0
Notable changes
k3s_config_dir
derived fromk3s_config_file
, reused throughout the role to allow for easy removal of "Rancher" references #73.k3s_token_location
has moved to be ink3s_config_dir
.- Tasks for creating directories now looped to caputure configuration from
k3s_server
andk3s_agent
and ensure directories exist before k3s starts, see #75. - Server token collected directly from token file, not symlinked file (node-token).
k3s_runtime_config
defined invars/
for validation and overwritten in tasks for control plane and workers.- Removed unused references to GitHub API.
set_fact
andcommand
tasks now use FQCN.- Check of
ansible_version
in environment check. - Introduction of target environment checks for #72.
- Fixed bug with non-default listening port not being passed to workers.
- Added ability to put documentation links into validation checks #76.
- Removed the requirement for
jmespath
on the Ansible controller. - Fixed bug with issue data collection tasks.
Breaking changes
- Ansible minimum version is hard set to v2.10.4
k3s_token_location
has moved to be ink3s_config_dir
so re-running the role will create a duplicate file here.
2020-12-19, v2.3.0
Notable changes
- Updated k3s uninstall scripts #74
- Started moving Rancher references to
vars/
as per #73
2020-12-19, v2.2.2
Notable changes
- Fixed typos in documentation.
- Molecule testing pinned to v3.1 due to tests failing.
2020-12-16, v2.2.1
Notable changes
- Re-working documentation
- Updated GitHub link, org changed from Rancher to k3s-io.
- Replace deprecated
play_hosts
variable.
Breaking changes
- Moving git branch from
master
tomain
.
2020-12-12, v2.2.0
Notable changes
- Use of FQCNs enforced, minimum Ansible version now v2.10
k3s_etcd_datastore
no longer experimental after K3s version v1.19.5+k3s1- Docker marked as deprecated for K3s > v1.20.0+k3s1
Breaking changes
- Use of FQCNs enforced, minimum Ansible version now v2.10
- Use of Docker requires
k3s_use_unsupported_config
to betrue
after v1.20.0+k3s1
2020-12-05, v2.1.1
Notable changes
- Fixed link to documentation.
2020-12-05, v2.1.0
Notable changes
- Deprecated configuration check built into validation steps.
- Removed duplicated tasks for single node cluster.
- Added documentation providing quickstart examples and common operations.
- Fixed data-dir configuration.
- Some tweaks to rootless.
- Fix draining and removing of nodes.
Breaking changes
k3s_token_location
now points to a file location, not a directory.k3s_systemd_unit_directory
renamed tok3s_systemd_unit_dir
- Removed
k3s_node_data_dir
as this is now configured withdata-dir
ink3s_server
and/ork3s_agent
.
Known issues
- Rootless is still broken, this is still not supported as a method for running k3s using this role.
2020-11-30, v2.0.2
Notable changes
- Updated issue template and information collection tasks.
2020-11-30, v2.0.1
Notable changes
- Fixed a number of typos in the README.md
- Updated the meta/main.yml to put quotes around minimum Ansible version.
2020-11-29, v2.0.0
Notable changes
- #64 - Initial release of v2.0.0 of ansible-role-k3s.
- Minimum supported k3s version now: v1.19.1+k3s1
- Minimum supported Ansible version now: v2.10.0
- #62 - Remove all references to the word "master".
- #53 - Move to file-based configuration.
- Refactored to avoid duplication in code and make contribution easier.
- Validation checks moved to using variables defined in
vars/
Breaking changes
File based configuration
Issue #53
With the release of v1.19.1+k3s1, this role has moved to file-based configuration of k3s. This requires manuall translation of v1 configuration variables into configuration file format.
Please see: https://rancher.com/docs/k3s/latest/en/installation/install-options/#configuration-file
Minimum supported k3s version
As this role now relies on file-based configuration, the v2.x release of this role will only support v1.19+ of k3s. If you are not in a position to update k3s you will need to continue using the v1.x release of this role, which will be supported until March 2021.
Minimum supported ansible version
This role now only supports Ansible v2.10+, this is because it has moved on to
using FQDNs, with the exception of set_fact
tasks which have
been broken and the fixes
have not yet been backported to v2.10.
The use of FQDNs allows for custom modules to be introduced to override task behavior. If this role requires a custom ansible module to be introduced then this can be added as a dependency and targeted specifically by using the correct FQDN.