Skip to main content

Breaking Changes

This document holds all information regarding breaking changes unrelated to Grain or Commons releases.

Some examples of those breaking changes are:

  • a kubernetes release
  • a Fedora CoreOS release
info

Breaking changes regarding a specific release version (i.e. 3.0.0) of Grain or Commons will be thoroughly documented in the release notes of that version.

Breaking Change with k3s 1.30.6​

warning

This section is relevant to you only if you are managing an AHD VM installation running k3s < 1.30.6 and want to upgrade to k3s >= 1.30.6

If you're installing AHD VM from scratch, do not worry about this issue.

Since k3s 1.30.6, the bundled Traefik installation has a breaking change in its configurations when upgrading from a previous installation. To fix it, follow these steps:

Update k3s​

Update k3s to >= 1.30.6 by following the docs

Update Traefik​

Update traefik's configuration by running the following commands:

  • sudo su
  • nano /var/lib/rancher/k3s/server/manifests/traefik-cfg.yaml

Change the file's contents from:

---
apiVersion: helm.cattle.io/v1
kind: HelmChartConfig
metadata:
  name: traefik
  namespace: kube-system
spec:
  valuesContent: |-
    ports:
      openvscode:
        port: 3500
        expose: true
        exposedPort: 3500

to:

---
apiVersion: helm.cattle.io/v1
kind: HelmChartConfig
metadata:
  name: traefik
  namespace: kube-system
spec:
  valuesContent: |-
    ports:
      openvscode:
        port: 3500
        expose:
          default: true
        exposedPort: 3500

Reboot the VM​

Reboot AHD VM by running sudo reboot

Check Traefik's status​

To check if Traefik has been properly deployed, run the command helm list -A and check for a record with name = "traefik", with version >= 27.x.x

NAME                    NAMESPACE       REVISION        UPDATED                                 STATUS          CHART                           APP VERSION
commons                 default         2               2024-10-09 10:43:30.401181851 +0000 UTC deployed        commons-2.2.0                             
traefik                 kube-system     2               2024-11-11 09:43:13.653059034 +0000 UTC deployed        traefik-27.0.201+up27.0.2       v2.11.10   
traefik-crd             kube-system     2               2024-11-11 09:43:13.643279974 +0000 UTC deployed        traefik-crd-27.0.201+up27.0.2   v2.11.10