Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

1.32 release docs #899

Merged
merged 5 commits into from
Dec 19, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
```

Expand Down
4 changes: 2 additions & 2 deletions docs/canonicalk8s/reuse/substitutions.yaml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
product: 'Canonical Kubernetes'
version: '1.31'
channel: '1.31/candidate'
version: '1.32'
channel: '1.32/stable'
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why do we define those channels here but still need to change the channels in a bunch of places?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These {{channels}}/{{version}} cannot be included in code snippets so that is why we have the install file instead. I'm not sure if they will be used in the future.

multi_line_example: |-
*Multi-line* text
that uses basic **markup**.
14 changes: 7 additions & 7 deletions docs/src/_parts/install.md
Original file line number Diff line number Diff line change
@@ -1,23 +1,23 @@
<!-- snap start -->
sudo snap install k8s --classic --channel=1.31-classic/candidate
sudo snap install k8s --classic --channel=1.32-classic/stable
<!-- snap end -->
<!-- lxd start -->
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
<!-- lxd end -->
<!-- offline start -->
sudo snap download k8s --channel 1.31-classic/candidate --basename k8s
sudo snap download k8s --channel 1.32-classic/stable --basename k8s
<!-- offline end -->
<!-- juju control start -->
juju deploy k8s --channel=1.31/candidate
juju deploy k8s --channel=1.32/edge
<!-- juju control end -->
<!-- juju worker start -->
juju deploy k8s-worker --channel=1.31/candidate -n 2
juju deploy k8s-worker --channel=1.32/edge -n 2
<!-- juju worker end -->
<!-- juju control constraints start -->
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 control constraints end -->
<!-- juju worker constraints start -->
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 worker constraints end -->
<!-- juju vm start -->
juju deploy k8s --channel=latest/edge \
Expand Down
2 changes: 1 addition & 1 deletion docs/src/assets/how-to-epa-maas-cloud-init
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
3 changes: 2 additions & 1 deletion docs/src/snap/reference/releases.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,7 @@ and backwards-incompatible changes.
:titlesonly:
:maxdepth: 2
/src/snap/reference/versions/1.31
/src/snap/reference/versions/1.32
```


Expand All @@ -21,4 +22,4 @@ available on the main Ubuntu website, on the [release cycle page][].

<!-- LINKS -->

[release cycle page]: https://ubuntu.com/about/release-cycle#canonical-kubernetes-release-cycle
[release cycle page]: https://ubuntu.com/about/release-cycle#canonical-kubernetes-release-cycle
111 changes: 111 additions & 0 deletions docs/src/snap/reference/versions/1.32.md
Original file line number Diff line number Diff line change
@@ -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].

<!-- LINKS -->

[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

<!-- PR -->
[#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

<!-- CONTRIBUTORS -->
[@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
Loading