From 4e03dc8ec15293068def6badf729d9951e8a2175 Mon Sep 17 00:00:00 2001 From: Niamh Hennigan Date: Thu, 19 Dec 2024 08:27:52 +0000 Subject: [PATCH] 1.32 release docs (#899) * 1.32 release docs for snap --- README.md | 2 +- docs/canonicalk8s/reuse/substitutions.yaml | 4 +- docs/src/_parts/install.md | 14 +-- docs/src/assets/how-to-epa-maas-cloud-init | 2 +- docs/src/snap/reference/releases.md | 3 +- docs/src/snap/reference/versions/1.32.md | 111 +++++++++++++++++++++ 6 files changed, 124 insertions(+), 12 deletions(-) create mode 100644 docs/src/snap/reference/versions/1.32.md diff --git a/README.md b/README.md index bffcd24ef..7023f0df8 100644 --- a/README.md +++ b/README.md @@ -15,7 +15,7 @@ For more information and instructions, please see the official documentation at: Install Canonical Kubernetes and initialise the cluster with: ```bash -sudo snap install k8s --channel=1.31-classic/candidate --classic +sudo snap install k8s --channel=1.32-classic/stable --classic sudo k8s bootstrap ``` diff --git a/docs/canonicalk8s/reuse/substitutions.yaml b/docs/canonicalk8s/reuse/substitutions.yaml index e7e3452e0..1e22962f3 100644 --- a/docs/canonicalk8s/reuse/substitutions.yaml +++ b/docs/canonicalk8s/reuse/substitutions.yaml @@ -1,6 +1,6 @@ product: 'Canonical Kubernetes' -version: '1.31' -channel: '1.31/candidate' +version: '1.32' +channel: '1.32/stable' multi_line_example: |- *Multi-line* text that uses basic **markup**. diff --git a/docs/src/_parts/install.md b/docs/src/_parts/install.md index 82bb3574e..c80b00361 100644 --- a/docs/src/_parts/install.md +++ b/docs/src/_parts/install.md @@ -1,23 +1,23 @@ -sudo snap install k8s --classic --channel=1.31-classic/candidate +sudo snap install k8s --classic --channel=1.32-classic/stable -lxc exec k8s -- sudo snap install k8s --classic --channel=1.31-classic/candidate +lxc exec k8s -- sudo snap install k8s --classic --channel=1.32-classic/stable -sudo snap download k8s --channel 1.31-classic/candidate --basename k8s +sudo snap download k8s --channel 1.32-classic/stable --basename k8s -juju deploy k8s --channel=1.31/candidate +juju deploy k8s --channel=1.32/edge -juju deploy k8s-worker --channel=1.31/candidate -n 2 +juju deploy k8s-worker --channel=1.32/edge -n 2 -juju deploy k8s --channel=1.31/candidate --constraints='cores=2 mem=16G root-disk=40G' +juju deploy k8s --channel=1.32/edge --constraints='cores=2 mem=16G root-disk=40G' -juju deploy k8s-worker --channel=1.31/candidate --constraints='cores=2 mem=16G root-disk=40G' +juju deploy k8s-worker --channel=1.32/edge --constraints='cores=2 mem=16G root-disk=40G' juju deploy k8s --channel=latest/edge \ diff --git a/docs/src/assets/how-to-epa-maas-cloud-init b/docs/src/assets/how-to-epa-maas-cloud-init index c2578d785..2ec896ed9 100644 --- a/docs/src/assets/how-to-epa-maas-cloud-init +++ b/docs/src/assets/how-to-epa-maas-cloud-init @@ -82,7 +82,7 @@ write_files: # install the snap snap: commands: - 00: 'snap install k8s --classic --channel=1.31/candidate' + 00: 'snap install k8s --classic --channel=1.32/stable' runcmd: # fetch dpdk driver binding script diff --git a/docs/src/snap/reference/releases.md b/docs/src/snap/reference/releases.md index f4a4618e4..4acde708b 100644 --- a/docs/src/snap/reference/releases.md +++ b/docs/src/snap/reference/releases.md @@ -11,6 +11,7 @@ and backwards-incompatible changes. :titlesonly: :maxdepth: 2 /src/snap/reference/versions/1.31 +/src/snap/reference/versions/1.32 ``` @@ -21,4 +22,4 @@ available on the main Ubuntu website, on the [release cycle page][]. -[release cycle page]: https://ubuntu.com/about/release-cycle#canonical-kubernetes-release-cycle \ No newline at end of file +[release cycle page]: https://ubuntu.com/about/release-cycle#canonical-kubernetes-release-cycle diff --git a/docs/src/snap/reference/versions/1.32.md b/docs/src/snap/reference/versions/1.32.md new file mode 100644 index 000000000..2d8c148e4 --- /dev/null +++ b/docs/src/snap/reference/versions/1.32.md @@ -0,0 +1,111 @@ +# 1.32 + +**{{product}} 1.32 - Release notes - 12 December 2024** + +Welcome to the latest release of {{product}}! +These release notes cover the highlights of this release. + +## Requirements and compatibility + +{{product}} can be installed on a variety of operating systems using several +methods. For specific requirements, see the [Installation guides]. + +## What’s new + +- **Kubernetes 1.32** - read more about the upstream release [here]. + +- **User provided certificate validation** - Now {{product}} can validate user +provided certificates allowing greater control over the cluster. + +- **Additional CNIs** - By adding the annotation `cni.exclusive`, users can now + configure their {{product}} cluster to add additional CNIs such as Multus + providing greater networking possibilities. + +- **Configurable containerd installation** - This new feature allows the user to +specify the installation path of containerd at bootstrap and node join with +`--containerd-base-dir`. This means configurations files will not conflict with + other containerd installations already on the host (for example from docker). + +## Also in this release + +- Update to CNI v1.6.0 +- Update go v1.23 +- Update How to use COS Lite tutorial to use k8s-operator charm +- Update Dqlite to v1.17.1 LTS, go-dqlite to v2 and k8s-dqlite to v1.3.0 +- Update Microcluster to v2.1.0 +- Update lxd to v0.0.0-20241106165613-4aab50ec18c3 +- Implement Vale spellcheck for documentation +- Use rock for metallb FRR instead of upstream +- Add review Kubernetes authentication token RPC +- Make updating documentation easier by implementing literalinclude +- Checks k8s-related port availability in PreInitChecks +- Add download links for long files +- Add patches for Kubernetes 1.32 +- Minor SBOM improvements +- Add proxy setting from /etc/environment to inspection report +- Added test level tags + +## Deprecations and API changes + +- Upstream - For details of other deprecation notices and API changes for +Kubernetes 1.32, please see the relevant sections of the + [upstream release notes][upstream-changelog-1.32]. + +## Fixed bugs and issues + +- Fixed nightly tests ([#876]) +- Fixed containerd pebble path ([#874]) +- Fixed MicroK8s snap check ([#861]) +- Set default k8s snap track for registry in integration tests ([#852]) +- Fixed cilium ingress, refactor string literals ([#848]) +- Removed hardened runner from CI ([#847]) +- Increase integration test timeouts([#798]) +- Changed BusyBox image registry in our integration tests to avoid rate limit + errors ([#845]) + +## Contributors + +Many thanks to [@neoaggelos], [@bschimke95], [@evilnick], +[@eaudetcobello], [@louiseschmidtgen], [@mateoflorido], [@berkayoz], +[@addyess], [@HomayoonAlimohammadi], [@ktsakalozos], [@kwmonroe], [@maci3jka], +[@petrutlucian94], [@nhennigan], [@claudiubelu], [@aznashwan], [@YanisaHS], +[@hemanthnakkina], [@dulmandakh], [@perk]. + + + +[Installation guides]: ../../howto/install/index +[tutorial]: ../../tutorial/getting-started +[here]: https://kubernetes.io/blog/2024/12/11/kubernetes-v1-32-release/ +[upstream-changelog-1.32]: https://github.com/kubernetes/kubernetes/blob/master/CHANGELOG/CHANGELOG-1.32.md#deprecation + + +[#876]: https://github.com/canonical/k8s-snap/commit/dd6b5e7075fe5d21df9698cd84eb2a369a446ae8 +[#874]: https://github.com/canonical/k8s-snap/commit/a181d4c0a6be41efc5608c6140bdf3d41c7e4890 +[#861]: https://github.com/canonical/k8s-snap/commit/bb70203feff748282b0ca337a6e9204ed04d2fd7 +[#852]: https://github.com/canonical/k8s-snap/commit/cb4e4b1c78b413aace6656213f81549b9e2cd954 +[#848]: https://github.com/canonical/k8s-snap/commit/b652f3d06c8fb9ffbafccfa6c9bb8ab6c61f5a69 +[#847]: https://github.com/canonical/k8s-snap/commit/457c64021c70483ccb8bc022647269b53fa02b6b +[#798]: https://github.com/canonical/k8s-snap/commit/1167d62d6a9ef41c4e06b350eb94ab19bcfc82ee +[#845]: https://github.com/canonical/k8s-snap/commit/334d79e333dc7b49c021c5b66a6da6012b82236b + + +[@perk]: https://github.com/perk +[@neoaggelos]: https://github.com/neoaggelos +[@bschimke95]: https://github.com/bschimke95 +[@evilnick]: https://github.com/evilnick +[@eaudetcobello]: https://github.com/eaudetcobello +[@louiseschmidtgen]: https://github.com/louiseschmidtgen +[@mateoflorido]: https://github.com/mateoflorido +[@berkayoz]: https://github.com/berkayoz +[@addyess]: https://github.com/addyess +[@HomayoonAlimohammadi]: https://github.com/HomayoonAlimohammadi +[@ktsakalozos]: https://github.com/ktsakalozos +[@kwmonroe]: https://github.com/kwmonroe +[@maci3jka]: https://github.com/maci3jka +[@petrutlucian94]: https://github.com/petrutlucian94 +[@nhennigan]: https://github.com/nhennigan +[@claudiubelu]: https://github.com/claudiubelu +[@aznashwan]: https://github.com/aznashwan +[@YanisaHS]: https://github.com/YanisaHS +[@hemanthnakkina]: https://github.com/hemanthnakkina +[@dulmandakh]: https://github.com/dulmandakh