We are excited to release the September Update of AKS Edge Essentials.
Version Numbers
-
AKS-EE Version: 1.8.202.0
-
Mariner Version: 2.0.20240731
-
K8s (upstream Kubernetes) distribution: 1.28.9, 1.29.4
-
K3s distribution: 1.28.5, 1.29.6
-
Json version schema: 1.14
New Features
-
Kubernetes versions supported: On K8S 1.28.9 and 1.29.4, on K3s 1.28.5 and 1.29.6
-
Update from K3S 1.28.3 (July release) to 1.28.5 (September release), and on K8S from 1.28.3 (July release) to 1.28.9 (September release).
-
Upgrade from K3S 1.27.6 (July release) to 1.28.5 (September release), and K3S 1.28.3 (July release) to 1.29.6 (September release)
-
Upgrade from K8S from 1.27.6 (July release) to 1.28.9 (September release), and on K8S from 1.28.3 (July release) to 1.29.4 (September release).
-
There is a new precheck during install to validate fdatasync latency. If disk latency is higher than 10ms, install will return a non-blocking warning message.
Experimental or Preview Features
-
Run Windows containerized workloads.
-
Create multi-node deployments either on a single machine or across multiple machines.
-
GPU-PV is in preview
For more information feature set and benefits, see AKS Edge Essentials Overview.
Key bug fixes
- The bug where a K3s cluster with multiple network interfaces would fail to start up after a reboot, has been fixed
CVE fixes
-
All CVEs fixed with K3s 1.28.5 and 1.29.6
-
All CVEs fixed with K8s 1.28.9 and 1.29.4
-
CVE's included in the Microsoft August 2024 Patch Tuesday Update.
Known issues
Update
-
When updating from 1.5.203 to 1.6.384.0 on both Linux and Windows, customers may see one of the following non-fatal errors:
-
"Get-Content: Cannot find path 'C:\Windows\System32\akswindows-manifest.json' because it does not exist."
-
"Get-Content: Cannot find path 'C:\Program Files\AksEdge\akswindows-manifest.json' because it does not exist."
-
This is a non-fatal error and can be ignored.
- Updates from K8S 1.26.3 to 1.26.6 fails when disk pressure is high. As a workaround, extract the tarball /opt/container-images/container-images-tar-file.tar.gz and use ctr to reimport the images that are missing, using the command
ctr -n=k8s.io images import {extracted tar files location}
Deployment
-
New deployment fails when the execution policy is set to AllSigned (
Set-ExecutionPolicy –ExecutionPolicy AllSigned
) . Recommend setting the policy to 'ByPass'. -
Uninstalling and reinstalling k8s/k3s causes a “deployment already exists” error or the 'Virtual machine creation failed' error, when creating a new deployment, so recommend restarting your machine before deployment .
-
Event logging fails when uninstalling and reinstalling an MSI without a reboot in between . Particularly true when switching between using K3S and K8S.
-
When a deployment fails due to lack of memory/disk space, it creates an incomplete VHDX file that causes errors in later deployments .
-
Deployment with External virtual switch fails when using Windows RS5.
Linux nodes
- When you use the Remove-AksEdgeNode to remove a node, it might still show up in the
kubectl get nodes
as the cluster tries to reconcile the state of the present nodes. Please note that the command Remove-AksEdgeNode is a asynchronous call and will return before the cluster state is updated to reflect the new state.
Windows nodes
-
On a K3s Windows node, load balancer klipper-lb pulls images from the internet when connected .
-
Adding a Windows node takes around ~10 minutes to complete .
-
No storage provisioner is available for the Windows node .
-
NFS subdir external provisioner pod fails on Windows nodes.