601 lines
12 KiB
Markdown
601 lines
12 KiB
Markdown
|
# Change Log
|
||
|
|
|
||
|
|
<!--
|
||
|
|
## DATE, vx.x.x
|
||
|
|
|
||
|
|
### Notable changes
|
||
|
|
|
||
|
|
### Breaking changes
|
||
|
|
|
||
|
|
### Known issues
|
||
|
|
|
||
|
|
### Contributors
|
||
|
|
|
||
|
|
---
|
||
|
|
-->
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 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
|
||
|
|
|
||
|
|
- [eaglesemanation](https://github.com/eaglesemanation)
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 2022-01-30, v3.1.0
|
||
|
|
|
||
|
|
### Notable changes
|
||
|
|
|
||
|
|
- feat: use basename of url for items in `k3s_server_manifests_urls` and
|
||
|
|
`k3s_server_pod_manifests_urls` if filename is not provided #177
|
||
|
|
|
||
|
|
### Contributors
|
||
|
|
|
||
|
|
- [kossmac](https://github.com/kossmac)
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 2022-01-06, v3.0.1
|
||
|
|
|
||
|
|
### Notable changes
|
||
|
|
|
||
|
|
- fix: adding become to pre checks packages #173
|
||
|
|
|
||
|
|
### Contributors
|
||
|
|
|
||
|
|
- [xlejo](https://github.com/xlejo)
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 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 to `k3s_become`
|
||
|
|
- `k3s_become_for_*` removed.
|
||
|
|
|
||
|
|
### Contributors
|
||
|
|
|
||
|
|
- [crutonjohn](https://github.com/crutonjohn)
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 2021-12-23, v2.12.1
|
||
|
|
|
||
|
|
### Notable changes
|
||
|
|
|
||
|
|
- Fix typo in systemd unit file
|
||
|
|
|
||
|
|
### Contributors
|
||
|
|
|
||
|
|
- [andrewchen5678](https://github.com/andrewchen5678)
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 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
|
||
|
|
|
||
|
|
- [janar153](https://github.com/janar153)
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 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
|
||
|
|
|
||
|
|
- [onedr0p](https://github.com/onedr0p)
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 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
|
||
|
|
|
||
|
|
- [@abelfodil](https://github.com/abelfodil)
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 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
|
||
|
|
|
||
|
|
- [@Yaro](https://github.com/Yajo)
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 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
|
||
|
|
|
||
|
|
- [@mrobinsn](https://github.com/mrobinsn)
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 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
|
||
|
|
|
||
|
|
- [@bjw-s](https://github.com/bjw-s)
|
||
|
|
- [@onedr0p](https://github.com/onedr0p)
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 2021-05-14, v2.9.1
|
||
|
|
|
||
|
|
<!-- Today was a better day... <3 -->
|
||
|
|
|
||
|
|
### Notable changes
|
||
|
|
|
||
|
|
- Documentation, remove references to deprecated configuration techniques #115
|
||
|
|
- Bugfix: Templating issue.
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 2021-05-13, v2.9.0
|
||
|
|
|
||
|
|
<!-- a shit day... -->
|
||
|
|
|
||
|
|
### Notable changes
|
||
|
|
|
||
|
|
- Feature: Support k3s private registry configuration #114
|
||
|
|
|
||
|
|
### Contributors
|
||
|
|
|
||
|
|
- [@anjia0532](https://github.com/anjia0532)
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 2021-05-06, v2.8.5
|
||
|
|
|
||
|
|
### Notable changes
|
||
|
|
|
||
|
|
- Bugfix: Unmount CSI plugin folder to avoid data lost on uninstall #113
|
||
|
|
|
||
|
|
### Contributors
|
||
|
|
|
||
|
|
- [@angelnu](https://github.com/angelnu)
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 2021-05-01, v2.8.4
|
||
|
|
|
||
|
|
### Notable changes
|
||
|
|
|
||
|
|
- Fixed issue with draining nodes #112
|
||
|
|
|
||
|
|
### Contributors
|
||
|
|
|
||
|
|
- [@anjia0532](https://github.com/anjia0532)
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 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 now `blockinfile`
|
||
|
|
|
||
|
|
### Contributors
|
||
|
|
|
||
|
|
- [@bdronneau](https://github.com/bdronneau)
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 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
|
||
|
|
or `ansible-base` >= 2.10.4. See [#105(comment)](https://github.com/PyratLabs/ansible-role-k3s/issues/105#issuecomment-817182233)
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 2021-03-22, v2.8.1
|
||
|
|
|
||
|
|
### Notable changes
|
||
|
|
|
||
|
|
- #100 - Fixed typo in README.md
|
||
|
|
|
||
|
|
### Contributors
|
||
|
|
|
||
|
|
- [@mbwmbw1337](https://github.com/mbwmbw1337)
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 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` to
|
||
|
|
`k3s_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 and `assert` 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 control `systemd.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 control `systemd.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 from `k3s_config_file`, reused throughout the role
|
||
|
|
to allow for easy removal of "Rancher" references #73.
|
||
|
|
- `k3s_token_location` has moved to be in `k3s_config_dir`.
|
||
|
|
- Tasks for creating directories now looped to caputure configuration from
|
||
|
|
`k3s_server` and `k3s_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 in `vars/` for validation and overwritten in
|
||
|
|
tasks for control plane and workers.
|
||
|
|
- Removed unused references to GitHub API.
|
||
|
|
- `set_fact` and `command` 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 in `k3s_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` to `main`.
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 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 be `true` 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 to `k3s_systemd_unit_dir`
|
||
|
|
- Removed `k3s_node_data_dir` as this is now configured with `data-dir` in
|
||
|
|
`k3s_server` and/or `k3s_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](https://github.com/PyratLabs/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<!-- 1 year after k8s v1.18 release -->.
|
||
|
|
|
||
|
|
#### 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](https://github.com/ansible/ansible/issues/72319) and the fixes
|
||
|
|
have [not yet been backported to v2.10](https://github.com/ansible/ansible/pull/71824).
|
||
|
|
|
||
|
|
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.
|