Edit this page

Release notes

1.25+ck1 Bugfix release

September 19, 2022 - `charmed-kubernetes --channel 1.25/stable`

The release bundle can also be downloaded here.

Fixes

Notable fixes in this release include:

Metallb-Operators LP#1988410

With the removal of PodSecurityPolicy in Kubernetes 1.25, the metallb operators (speaker and controller) no longer include PSP-related podspec rules if the API endpoint does not support PSP. Existing PSP rules from deployments < 1.25 will be removed upon upgrade to 1.25+.
Kubernetes-Control-Plane / Vault relation LP#1988448

Fixes a race condition which can occur when a Vault unit loses connectivity with a related database. Vault will now retry the connection until the database becomes available again.
Kubernetes-Control-Plane / Google Cloud Platform LP#1988867

Fixes a race condition which can occur when applying configuration changes in Google Cloud Platform deployments when the NetworkUnavailable index cannot be found in a node’s status conditions.

A list of bug fixes and other minor feature updates in this release can be found at the launchpad milestone page for 1.25+ck1.

1.25

September 1, 2022 - `charmed-kubernetes --channel 1.25/stable`

The release bundle can also be downloaded here.

What’s new

Telco-ready CNI

Identifying a need for increasingly sophisticated SDN within Kubernetes, Charmed Kubernetes now has a Kube-OVN charm. This enables a set of new networking capabilities such as VXLAN, QoS, IP Dualstack and more.

High availability secret management

Furthering our commitment to resilience, we have now extended the Hashicorp Vault charm to provide HA capabilities, ensuring your secrets are always available.

Cloud provider integration

OpenStack, vSphere and Azure become the latest Cloud integrations to benefit from updated Charmed Kubernetes charms. With these integrations, we enable you to deploy our Kubernetes and make it your own as you leverage native features within those clouds.

Lightweight observability

Canonical Observability Stack (COS Lite) now integrates with our flagship networking charm Kube-OVN. This marks a commitment to providing high quality relations that enable zero-ops observability.

CDK-addons uplifted to operators

As an effort to keep our charms evergreen and ready for production use, we have uplifted CDK-addons to individual operators. This provides a range of benefits, from individual build processes to versioning and releasing.

Ubuntu 22.04 LTS support

All the components of Charmed Kubernetes can now run on the newest Ubuntu release for the very latest kernel features and security enhancements.

Component Versions

Charm/Addons pinned versions

kube-ovn 1.10.4
calico 3.21.4
cephcsi 3.5.1
cinder-csi-plugin 1.23.0
coredns 1.9.0
ingress-nginx 1.2.0
k8s-keystone-auth 1.23.0
kube-state-metrics 2.4.2
kubernetes-dashboard 2.5.1
openstack-cloud-controller-manager 1.23.0

Charm default versions

cloud-provider-vsphere 1.24
vsphere-csi-driver v2.6.0
cloud-provider-azure v1.24.0
azuredisk-csi-driver v1.21.0

Fixes

Notable fixes in this release include:

A full list of bug fixes and updates since Charmed Kubernetes 1.24 can be found at:

Notes and Known Issues

LP1988186 Storage Components on AWS and Google Cloud

Beginning in 1.25 CSIMigrationAWS and CSIMigrationGCE have been locked to true resulting this release being unable to support storage volume mounting in AWS or Google Cloud without the use of those providers’ out-of-tree csi-drivers. No charms yet exist for these two cloud platforms but will soon be addressed.

:warning: do not set channel=1.25 on charm config kubernetes-control-plane and kubernetes-worker unless your cluster has taken steps to mitigate the lack of built-in storage such as:
- Not using storage
- Using alternative storage like ceph-csi
- Manually configuring the out-of-tree storage provisioner
PodSecurityPolicy Removed PodSecurityPolicy has been removed in 1.25. Please see the PodSecurityPolicy Migration Guide if you have deployed pod security policies in your cluster. :warning: do not set channel=1.25 on charm config kubernetes-control-plane and kubernetes-worker until your policies have been migrated.

Deprecations and API changes

CSIMigration The CSIMigration feature is generally available, and its feature flag was locked to enable.
PodSecurityPolicy The beta PodSecurityPolicy admission plugin, deprecated since 1.21, is removed. See the above section for instructions to migrate to the built-in PodSecurity admission plugin.
PodDisruptionBudget The policy/v1beta1 API version of PodDisruptionBudget is deprecated. Migrate manifests and API clients to use the policy/v1 API version, available since 1.21.
vSphere vSphere releases less than 7.0u2 are not supported for in-tree vSphere volumes as of Kubernetes 1.25. Upgrading vSphere (ESXi and vCenter) to 7.0u2 or above is advised.

For details of other deprecation notices and API changes for Kubernetes 1.25, please see the relevant sections of the upstream release notes.

1.24+ck1 Bugfix release

August 5, 2022 - `charmed-kubernetes --channel 1.24/stable`

The release bundle can also be downloaded here.

What’s new

Jammy Jellyfish (22.04) Support

All Charmed Kubernetes charms now come with the ability to run on jammy series machines. Xenial (16.04) support has been removed. Focal (20.04) remains the default series in all bundles and charms, however the charms now advertise jammy support and are considered stable for that series.

Improved Documentation

Vault documentation updated to cover 20.04 focal environment. Operator charms and replacements for addons now have dedicated guides. CIDR size limitations are better described in the charm’s cidr config option.

Containerd

Improved GPU support by referencing apt sources with https and refreshing NVIDIA repository keys. Also improved NVIDIA driver upgrades and debug messages for units that encounter connectivity failures in air-gapped or proxied environments.

Improved upgrade actions for containerd packages as well as NVIDIA packages.

Docker Registry

Exposes docker registry cache-* settings to configure it as a pull-through cache.

Etcd

Limits the set of TLS ciphers to remove weaker ones.

Fixes

A list of bug fixes and other minor feature updates in this release can be found at the launchpad milestone page for 1.24+ck1.

1.24

May 6th, 2022 - `charmed-kubernetes --channel 1.24/stable`

Before upgrading, please read the upgrade notes. Specific instructions for the 1.23 => 1.24 upgrade can be found here.

What’s new

Transition to Charmhub

Starting with this release, charms and bundles will be published to Charmhub instead of the Charm Store.

If you have any processes that rely on pulling Charmed Kubernetes components from the Charm Store (for example, references to cs:charmed-kubernetes or cs:~containers/...), make sure you update those processes to pull from Charmhub instead.

When upgrading existing clusters, please refer to the upgrade notes for instructions on how to navigate this transition properly.

kubernetes-master renamed to kubernetes-control-plane

The kubernetes-master charm has been renamed to kubernetes-control-plane. See the inclusive naming page for more details about this change.

Kubelet added to kubernetes-control-plane

The kubernetes-control-plane charm now includes Kubelet, allowing kubernetes-control-plane units to participate as fully functioning nodes within Kubernetes clusters.

By default, the kubernetes-control-plane nodes will be configured with a taint to prevent pods from being scheduled to them. The new register-with-taints config option can be used to control this behavior at deploy time.

Calico is now the default CNI

The charmed-kubernetes and kubernetes-core reference bundles have been updated to use Calico for pod networking instead of Flannel. We recommend Calico as the default CNI choice for all new deployments due to the rich set of advanced networking features that it provides.

While we do recommend Calico as the default choice, we will continue to support new and existing deployments that use Flannel as well.

Docker support deprecated

The default container runtime in Charmed Kubernetes has been containerd for some time. The Docker container runtime is no longer supported.

Component upgrades

calico 3.21.4
cephcsi 3.5.1
cinder-csi-plugin 1.23.0
coredns 1.9.0
ingress-nginx 1.2.0
k8s-keystone-auth 1.23.0
kube-state-metrics 2.4.2
kubernetes-dashboard 2.5.1
openstack-cloud-controller-manager 1.23.0

Fixes

A list of bug fixes and other feature updates in this release can be found at the launchpad milestone page.

Notes and Known Issues

LP 1907153 Snap install failure in LXD

Snaps may fail to install when the kubernetes-control-plane charm is deployed to a LXD container. This happens when the version of snapd on the host does not match the version inside the container. As a workaround, ensure the same version of snapd is installed on the host and in LXD containers.

Deprecations and API changes

Upstream

For details of other deprecation notices and API changes for Kubernetes 1.24, please see the relevant sections of the upstream release notes.

1.23

December 15, 2021 - charmed-kubernetes-862

What’s new

CNI support added to kubernetes-master

The core CNI plugins have been added to kubernetes-master, and the CNI subordinate charms have been updated to render CNI configuration when attached to kubernetes-master. These changes pave the way for Kubelet to be added to kubernetes-master in a future release.

Grafana dashboard for etcd

The etcd charm can now be related to the Prometheus and Grafana charms. When doing so, a new Grafana dashboard will be created that makes it easier to monitor the performance characteristics of etcd.

Component upgrades

kube-dns 1.21.1 (note: coredns 1.8.3 is the default DNS provider)
metrics-server 0.5.1

Fixes

A list of bug fixes and other feature updates in this release can be found at the launchpad milestone page.

Notes and Known Issues

LP 1907153 Snap install failure in LXD

Snaps may fail to install when the kubernetes-master charm is deployed to a LXD container. This happens when the version of snapd on the host does not match the version inside the container. As a workaround, ensure the same version of snapd is installed on the host and in LXD containers.

LP 1936816 and LP 1913228 Filesystem Hierachy Standards

Applications running inside a kubernetes-master should set pid files and log files in appropriate operational locations like /run/ and /var/log/kubernetes/. Care was taken to restart services using these new locations and migrate some existing files out of /root/cdk/.

For the service cdk.master.auth-webhook the new pid file and log files are named /run/cdk.master.auth-webhook.pid and /var/log/kubernetes/cdk.master.auth-webhook.log to match the systemctl service name.

If the filebeat charm is related to kubernetes-master, ensure that its logpath include this new path ( e.g. juju config filebeat logpath='/var/log/kubernetes/*.log' )

Deprecations and API changes

Upstream

For details of other deprecation notices and API changes for Kubernetes 1.23, please see the relevant sections of the upstream release notes.

1.22+ck2 Bugfix release

October 27, 2021 - charmed-kubernetes-814

Fixes

A list of bug fixes and other minor feature updates in this release can be found at the launchpad milestone page for 1.22+ck2.

1.22+ck1 Bugfix release

October 21, 2021 - charmed-kubernetes-807

What’s new

Configurable default PodSecurityPolicy

A new pod-security-policy config option has been added to the kubernetes-master charm. This option allows you to override the default PodSecurityPolicy that is created by the charm.

Configurable Nvidia APT sources

New config options have been added to the containerd charm: nvidia_apt_key_urls, nvidia_apt_sources, and nvidia_apt_packages. These provide better support for Nvidia GPUs in air gapped deployments by allowing you to specify where the Nvidia Container Runtime and CUDA packages are pulled from.

Better OpenStack credential handling

The openstack-integrator charm now checks for updated cloud credentials from Juju every time its update-status hook runs, ensuring that cloud credentials are properly detected a short time after they change. To expedite this process, you can use the new openstack-integrator charm’s new refresh-credentials action to force a recheck immediately.

Fixes

A list of bug fixes and other minor feature updates in this release can be found at the launchpad milestone page for 1.22+ck1.

1.22

September 1, 2021 - charmed-kubernetes-761

What’s new

Calico BGP Service IP Advertisement

The Calico charm now supports advertising Kubernetes service IPs using Border Gateway Protocol (BGP). More information can be found in the CNI with Calico page.

Improved load balancer provider support

Support for load balancing the Kubernetes control plane is being improved with two new relation endpoints: loadbalancer-external and loadbalancer-internal. This change adds support for Azure native load balancers for the Kubernetes control plane, and improves LB configurability while still simplifying the relations needed between the various components of the cluster.

Component upgrades

cephcsi 3.3.1 (note: see upstream notes if upgrading from a previous release)
kube-dns 1.17.3 (note: coredns 1.8.3 is the default DNS provider)
nginx-ingress 1.0.0-beta.3
metrics-server 0.5.0

Fixes

A list of bug fixes and other feature updates in this release can be found at the launchpad milestone page.

Notes and Known Issues

LP 1935992 Code cleanup

Previously deprecated features have been removed in this release. This includes the following kubernetes-master features:
- addons-registry config
- create-rbd-pv action and related templates
- monitoring-storage config
- kube-dns interface
- migrate_from_pre_snaps code
The following deprecated kubernetes-worker features have been removed in this release:
- allow-privileged config
- kube-dns interface
- registry action and related templates
- code paths for k8s < 1.10
LP 1907153 Snap install failure in LXD

Snaps may fail to install when the kubernetes-master charm is deployed to a LXD container. This happens when the version of snapd on the host does not match the version inside the container. As a workaround, ensure the same version of snapd is installed on the host and in LXD containers.

Deprecations and API changes

Upstream

For details of other deprecation notices and API changes for Kubernetes 1.22, please see the relevant sections of the upstream release notes.

Previous releases

Please see this page for release notes of earlier versions.

1.21+ck3 Bugfix release

August 02, 2021 - charmed-kubernetes-733

Fixes

A list of bug fixes and other minor feature updates in this release can be found at the launchpad milestone page.

1.21+ck2 Bugfix release

May 28, 2021 - charmed-kubernetes-679

Fixes

A list of bug fixes and other minor feature updates in this release can be found at the launchpad milestone page.

1.21+ck1 Bugfix release

May 04, 2021 - charmed-kubernetes-655

Fixes

A list of bug fixes and other minor feature updates in this release can be found at the launchpad milestone page.

1.21

April 15, 2021 - charmed-kubernetes-632

What’s new

Azure Arc conformance

Charmed Kubernetes is compliant with the Azure Arc Validation test suite. More information about this program can be found in the azure-arc-validation documentation.

Container images by release

LP 1891530 describes an upgrade failure for deployments that use a private image registry. The Charmed Kubernetes release process now publishes a list of required images per-release for administrators to easily determine what registry changes are needed prior to an upgrade.

Component upgrades

cloud-provider-openstack 1.20.0
coredns 1.8.3
kube-state-metrics 1.9.8
kubernetes-dashboard 2.2.0
nginx-ingress 0.44.0
pause 3.4.1

Fixes

A list of bug fixes and other minor feature updates in this release can be found at the launchpad milestone page.

Notes and Known Issues

LP 1920216 MetalLB speaker pod logs error with “selfLink was empty, can’t make reference”.

Deprecations and API changes

Private container registry action

The registry action of the kubernetes-worker charm is deprecated and will be removed in a future release. See the Private Docker Registry documentation for using a custom registry with Charmed Kubernetes.

Upstream

For details of other deprecation notices and API changes for Kubernetes 1.21, please see the relevant sections of the upstream release notes

Previous releases

Please see this page for release notes of earlier versions.

1.20+ck1 Bugfix release

February 23rd, 2021 - charmed-kubernetes-596

Fixes

A list of bug fixes and other minor feature updates in this release can be found at the launchpad milestone page

Notes / Known Issues

Secret names

LP 1906732 highlighted an issue where kubernetes-worker units would overwrite existing secrets when deployed as different application names. This lead to some worker units losing the ability to authenticate with the cluster. This has be resolved by ensuring new secrets are uniquely named in the form: auth-$username-$random.

Juju and GCP

LP 1761838 describes an issue with Juju and Google cloud where deployments may fail due to FAN networking. Workaround this by disabling FAN configuration for Google cloud models:

juju model-config -m <model_name> fan-config="" container-networking-method=""

1.20

December 16th, 2020 - charmed-kubernetes-559

What’s new

Calico VXLAN support

The Calico charm now supports enabling VXLAN encapsulation for Calico network traffic. This provides an easier alternative to the direct routing or IPIP encapsulation modes, making it possible to run Calico on any Juju cloud without special cloud configuration. For more details, see the Calico CNI documentation page.

CoreDNS operator charm support

The CoreDNS component can now be deployed as an operator charm inside the Kubernetes cluster instead of being managed by the cdk-addons snap. This allows for more control over the component, including additional configuration options and easier contribution of bug fixes or upgrades to that component.

Details on how to set this up can be found in the [CoreDNS section of the Addons page][coredns].

Kubernetes Dashboard operator charm support

The Kubernetes Dashboard component can now be deployed as an operator charm inside the Kubernetes cluster instead of being managed by the cdk-addons snap. This allows for more control over the component, including additional configuration options and easier contribution of bug fixes or upgrades to that component.

Details on how to set this up can be found in the Kubernetes Dashboard section of the Addons page.

Component upgrades

Fixes

A list of bug fixes and other minor feature updates in this release can be found at https://launchpad.net/charmed-kubernetes/+milestone/1.20.

Notes / Known Issues

Deprecations and API changes

For details of deprecation notices and API changes for Kubernetes 1.20, please see the relevant sections of the upstream release notes

1.19+ck2 Bugfix release

November 27th, 2020 - charmed-kubernetes-545

Fixes

A list of bug fixes and other minor feature updates in this release can be found at https://launchpad.net/charmed-kubernetes/+milestone/1.19+ck2.

1.19+ck1 Bugfix release

November 20th, 2020 - charmed-kubernetes-541

Fixes

A list of bug fixes and other minor feature updates in this release can be found at https://launchpad.net/charmed-kubernetes/+milestone/1.19+ck1.

1.19

September 30th, 2020 - charmed-kubernetes-519

Before upgrading, please read the upgrade notes.

What’s new

IPv6 support

This release of Charmed Kubernetes can now enable the alpha IPv6 dual-stack or beta IPv6-only support in Kubernetes by using IPv6 CIDRs in addition to or instead of IPv4 CIDRs in the Kubernetes Master charm’s service-cidr and the Calico charm’s cidr charm config.

More information can be found in Using IPv6 with Charmed Kubernetes, including limitations and known issues.

CIS benchmark compliance

Charmed Kubernetes is now compliant with the Center for Internet Security (CIS) benchmark for Kubernetes. Significant changes to the kubernetes-master and kubernetes-worker charms have been made to achieve this. Find more information about these changes, running the benchmark, and analyzing test results in the CIS compliance for Charmed Kubernetes documentation.

Authentication changes

File-based authentication is not compliant with the CIS benchmark. Charmed Kubernetes now deploys a webhook authentication service that compares API requests to Kubernetes secrets. If needed, any existing entries in previous authentication files (basic_auth.csv and known_tokens.csv) are migrated to secrets during the kubernetes-master charm upgrade.

More information about this new service can be found in the Authorisation and Authentication documentation.

New Calico configuration options

The new veth-mtu setting allows fine tuning of the MTU setting for optimum performance on the underlying network. See the Calico documentation for more details and recommendations, and the Calico charm docs for information on how to set this configuration.

Calico and related charms (Canal, Tigera Secure EE) also have a new ignore-loose-rpf configuration option. By default, for security, these charms check that the kernel has strict reverse path forwarding set (net.ipv4.conf.all.rp_filter set to 0 or 1). In some circumstances you may need to set this to 2, in which case you can now set ignore-loose-rpf=true to ignore the check.

Ubuntu 20.04

The default operating system for deployed machines is now Ubuntu 20.04 (Focal). Ubuntu 18.04 (Bionic) and 16.04 (Xenial) are still supported.

MetalLB Operator

MetalLB offers a software network load balancing implementation that allows for LoadBalancing services in Kubernetes. This bundle has been made available in the Charm Store to be deployed along Charmed Kubernetes, MicroK8s, or any Kubernetes supported by Juju. This operator deploys upstream MetalLB in layer 2 mode. The BGP mode of upstream MetalLB is not supported yet. For more information about deploying and operating MetalLB, please see the MetalLB documentation.

SR-IOV CNI

A new SR-IOV CNI addon has been made available for Charmed Kubernetes. Using SR-IOV CNI, it is now possible to take network interfaces that are SR-IOV Virtual Functions and attach them directly to pods. For more information, see the new SR-IOV CNI documentation.

For a full list of the changes introduced in Kubernetes 1.19, please see the upstream release notes

Component upgrades

addon-resizer 1.8.9
ceph-csi 2.1.2
cloud-provider-openstack 1.18.0
coredns 1.6.7
kube-state-metrics 1.9.7
kubernetes-dashboard 2.0.1
nginx-ingress 0.31.1

Fixes

A list of bug fixes and other minor feature updates in this release can be found at https://launchpad.net/charmed-kubernetes/+milestone/1.19.

Notes / Known Issues

The insecure-bind-address and insecure-port options to kube-apiserver have been removed in this release. Using juju run with kubectl to interact with the cluster now requires an explicit --kubeconfig <file> option:

  juju run --unit kubernetes-master/0 'kubectl --kubeconfig /root/.kube/config get nodes'
  NAME              STATUS   ROLES    AGE   VERSION
  ip-172-31-10-19   Ready    <none>   71m   v1.19.0

The webhook authentication service included in this release runs on port 5000 of each kubernetes-master unit. Ensure this port is available prior to upgrading.
Additional known issues scheduled for the first 1.19 bugfix release can be found at https://launchpad.net/charmed-kubernetes/+milestone/1.19+ck1

Deprecations and API changes

For details of deprecation notices and API changes for Kubernetes 1.19, please see the relevant sections of the upstream release notes

Previous releases

Please see this page for release notes of earlier versions.

Previous releases

Please see this page for release notes of earlier versions.

We appreciate your feedback on the documentation. You can edit this page or file a bug here.

Release notes

1.25+ck1 Bugfix release

September 19, 2022 - charmed-kubernetes --channel 1.25/stable

Fixes

1.25

September 1, 2022 - charmed-kubernetes --channel 1.25/stable

What’s new

Component Versions

Charm/Addons pinned versions

Charm default versions

Fixes

Notes and Known Issues

Deprecations and API changes

1.24+ck1 Bugfix release

August 5, 2022 - charmed-kubernetes --channel 1.24/stable

What’s new

Fixes

1.24

May 6th, 2022 - charmed-kubernetes --channel 1.24/stable

What’s new

Component upgrades

Fixes

Notes and Known Issues

Deprecations and API changes

1.23

December 15, 2021 - charmed-kubernetes-862

What’s new

Component upgrades

Fixes

Notes and Known Issues

Deprecations and API changes

1.22+ck2 Bugfix release

October 27, 2021 - charmed-kubernetes-814

Fixes

1.22+ck1 Bugfix release

October 21, 2021 - charmed-kubernetes-807

What’s new

Fixes

1.22

September 1, 2021 - charmed-kubernetes-761

What’s new

Component upgrades

Fixes

Notes and Known Issues

Deprecations and API changes

Previous releases

1.21+ck3 Bugfix release

August 02, 2021 - charmed-kubernetes-733

Fixes

1.21+ck2 Bugfix release

May 28, 2021 - charmed-kubernetes-679

Fixes

1.21+ck1 Bugfix release

May 04, 2021 - charmed-kubernetes-655

Fixes

1.21

April 15, 2021 - charmed-kubernetes-632

What’s new

Component upgrades

Fixes

Notes and Known Issues

Deprecations and API changes

Previous releases

1.20+ck1 Bugfix release

February 23rd, 2021 - charmed-kubernetes-596

Fixes

Notes / Known Issues

1.20

December 16th, 2020 - charmed-kubernetes-559

What’s new

Component upgrades

Fixes

Notes / Known Issues

Deprecations and API changes

1.19+ck2 Bugfix release

November 27th, 2020 - charmed-kubernetes-545

Fixes

1.19+ck1 Bugfix release

November 20th, 2020 - charmed-kubernetes-541

Fixes

September 19, 2022 - `charmed-kubernetes --channel 1.25/stable`

September 1, 2022 - `charmed-kubernetes --channel 1.25/stable`

August 5, 2022 - `charmed-kubernetes --channel 1.24/stable`

May 6th, 2022 - `charmed-kubernetes --channel 1.24/stable`