CAPZ Releases

• Jan 22, 2026 CAPZ releases releases azure-34.0.0

  Warning: Important Note for Upgrading to this Release

  tl;dr: Please first upgrade your existing cluster to Giant Swarm Release v33.1.1 for Azure or newer before upgrading to this release! Otherwise, you risk service outage and severe issues.

  Giant Swarm Release v34.0.0 for Azure comes with Kubernetes v1.34. This version contains etcd v3.6, which makes use of the so-called v3 store by default. Before, with etcd v3.5, the v2 store was used by default and synchronized to the already existing v3 store.

  Different flaws could lead to an inconsistency between the old v2 store and the already present but unused standby v3 store in etcd v3.5 and before. Because of this, new etcd v3.6 members, which first start to use this v3 store, might suffer from these inconsistencies.

  This can come into play when upgrading a cluster to this and future releases from any release older than Giant Swarm Release v33.1.1 for Azure. For this reason, we require you to first upgrade your cluster to Giant Swarm Release v33.1.1 for Azure or newer before upgrading to this or future releases.

  OIDC Structured Authentication (optional)

  This release introduces optional support for Kubernetes Structured Authentication Configuration for OIDC providers. We recommend testing this feature on a non-production cluster first.

  Minimal example

  global:
    controlPlane:
      oidc:
        structuredAuthentication:
          enabled: true
          issuers:
            - issuerUrl: https://your-idp.example.com
              clientId: kubernetes
  

  Example with customization

  global:
    controlPlane:
      oidc:
        structuredAuthentication:
          enabled: true
          issuers:
            - issuerUrl: https://your-idp.example.com
              clientId: kubernetes
              usernameClaim: email          # Optional: use 'email' instead of 'sub'
              groupsClaim: roles            # Optional: use 'roles' instead of 'groups'
              usernamePrefix: "oidc:"       # Optional: prefix usernames
              groupsPrefix: "oidc:"         # Optional: prefix groups
  

  Migration from legacy OIDC configuration

  If you already use OIDC with the legacy configuration, add structuredAuthentication.enabled: true to migrate:

  global:
    controlPlane:
      oidc:
        issuerUrl: https://your-idp.example.com
        clientId: kubernetes
        structuredAuthentication:
          enabled: true
  

  This will automatically convert your legacy configuration to the new structured format.

  Advanced options

  Additional configuration options are available for more complex setups, including:

  • Multiple audiences (audiences, audienceMatchPolicy)
  • Custom discovery URL (discoveryUrl)
  • Custom CA certificate (caPem)
  • CEL expressions for claim and user validation (claimValidationRules, userValidationRules)
  • Advanced claim mappings with CEL expressions (claimMappings)

  Refer to the Kubernetes Structured Authentication documentation for details.

  Changes compared to v33.1.1

  Components

  • cluster-azure from v4.4.0 to v5.1.2
  • Flatcar from v4459.2.1 to v4459.2.2
  • Kubernetes from v1.33.6 to v1.34.3
  • os-tooling from v1.26.2 to v1.26.3

  cluster-azure v4.4.0…v5.1.2

  Added

  • Add the priority-classes default app, enabled by default. This app provides standardised PriorityClass resources like giantswarm-critical and giantswarm-high, which should replace the previous inconsistent per-app priority classes.
  • Add "helm.sh/resource-policy": keep annotation to AzureCluster CR so that it doesn’t get removed by Helm when uninstalling this chart. The CAPI controllers will take care of removing it, following the expected deletion order.

  Changed

  • Chart: Update cluster to v5.1.2.
  • Chart: Update cluster to v5.1.1.
  • Chart: Update cluster to v5.1.0.
  • Chart: Update cluster to v5.0.0.

  Apps

  • azure-cloud-controller-manager from v1.32.7-1 to v2.0.0
  • azure-cloud-node-manager from v1.32.7 to v2.0.0
  • azuredisk-csi-driver from v1.32.9 to v2.1.0
  • azurefile-csi-driver from v1.32.5 to v2.0.0
  • cert-exporter from v2.9.14 to v2.9.15
  • cilium from v1.3.2 to v1.3.4
  • coredns from v1.28.3 to v1.29.1
  • etcd-k8s-res-count-exporter from v1.10.11 to v1.10.12
  • external-dns from v3.2.0 to v3.4.0
  • k8s-audit-metrics from v0.10.10 to v0.10.11
  • network-policies from v0.1.1 to v0.1.3
  • node-exporter from v1.20.9 to v1.20.10
  • observability-bundle from v2.3.2 to v2.5.0
  • Added priority-classes v0.3.0
  • security-bundle from v1.15.0 to v1.16.1

  azure-cloud-controller-manager v1.32.7-1…v2.0.0

  Changed

  • Chart: Update to upstream v1.34.3. (#132)

  azure-cloud-node-manager v1.32.7…v2.0.0

  Changed

  • Chart: Update to upstream v1.34.3. (#118)

  azuredisk-csi-driver v1.32.9…v2.1.0

  Changed

  • Chart: Update to upstream v1.34.0. (#118)
  • Chart: Update to upstream v1.33.7. (#114)

  azurefile-csi-driver v1.32.5…v2.0.0

  Changed

  • Chart: Update to upstream v1.34.2. (#71)

  cert-exporter v2.9.14…v2.9.15

  Changed

  • Go: Update dependencies.

  cilium v1.3.2…v1.3.4

  Changed

  • Upgrade Cilium to v1.18.6.
  • Upgrade Cilium to v1.18.5.

  coredns v1.28.3…v1.29.1

  Changed

  • Update coredns image to 1.14.1.
  • Update coredns image to 1.14.0.

  etcd-k8s-res-count-exporter v1.10.11…v1.10.12

  Changed

  • Go: Update dependencies.

  external-dns v3.2.0…v3.4.0

  Changed

  • Sync to upstream helm chart 1.20.0.
    • Add option to set annotationPrefix.
    • Fixed the missing schema for .provider.webhook.serviceMonitor configs.
    • Fixed incorrect indentation of selector labels under spec.template.spec.topologySpreadConstraints when topologySpreadConstraints is set.
  • Use kubectl-apply-job when installing CRDs.
  • Upgrade external-dns to v0.20.0.
  • Update DNSEndpoints CRD.
  • Sync to upstream helm chart 1.19.0.
    • Grant discovery.k8s.io/endpointslices permission only when using service source.
    • Update RBAC for Service source to support EndpointSlices.
    • Allow extraArgs to also be a map enabling overrides of individual values.
    • Set defaults for automountServiceAccountToken and serviceAccount.automountServiceAccountToken to true in Helm chart values.
    • Correctly handle txtPrefix and txtSuffix arguments when both are provided.
    • Add ability to generate schema with helm plugin schema.
    • Regenerate JSON schema with `helm-values-schema-json’ plugin.
    • Added ability to configure imagePullSecrets via helm global value.
    • Added options to configure labelFilter and managedRecordTypes via dedicated helm values.
    • Allow templating serviceaccount.annotations keys and values, by rendering them using the tpl built-in function.
    • Added support for extraContainers argument.
    • Added support for setting excludeDomains argument.
    • Added support for setting dnsConfig.
    • Added support for webhook providers.
  • Restrict managed record types to A and CNAME.

  k8s-audit-metrics v0.10.10…v0.10.11

  Changed

  • Go: Update dependencies.

  network-policies v0.1.1…v0.1.3

  Added

  • Add support for Kamaji.

  Fixed

  • Fixed broken templating.

  node-exporter v1.20.9…v1.20.10

  Removed

  • Repository: Remove integration tests.

  observability-bundle v2.3.2…v2.5.0

  Added

  • Add KSM metrics kube_servicemonitor_info and kube_podmonitor_info for ServiceMonitor and PodMonitor resources
  • Add KSM metrics kube_podlog_info for PodLog resource

  Changed

  • Upgrade kube-prometheus-stack-app to 19.0.0
  • Update alloy-app to 0.16.0
    • Bumps alloy to 1.12.0

  Fixed

  • Fixed KSM metrics for endpoints

  priority-classes v0.3.0

  Changed

  • Label now uses chart version instead of app version.

  Removed

  • Removed appVersion (only version is used now).

  security-bundle v1.15.0…v1.16.1

  Changed

  • Add missing dependency to all apps.
  • Allow to set multiple dependencies on the depends-on annotation.
  • Rename edgedb to gel.
  • Update cloudnative-pg (app) to v0.0.12.
  • Update gel (app) to v1.0.1.
• Dec 16, 2025 CAPZ releases releases azure-33.1.1

  This patch release fixes an issue with the installation of the Teleport Kube Agent app.

  Changes compared to v33.1.0

  Apps

  • coredns from v1.28.2 to v1.28.3

  coredns v1.28.2…v1.28.3

  Changed

  • Update coredns image to 1.13.2.
• Nov 2, 2025 CAPZ releases releases azure-32.1.0

  This release updates Flatcar to v4230.2.4 and includes several app updates and improvements.

  Changes compared to v32.0.0

  Components

  • Flatcar from v4230.2.2 to v4230.2.4
  • os-tooling from v1.26.1 to v1.26.2

  Apps

  • capi-node-labeler from v1.1.3 to v1.1.5
  • cert-exporter from v2.9.9 to v2.9.13
  • cert-manager from v3.9.2 to v3.9.4
  • cilium from v1.3.0 to v1.3.1
  • coredns from v1.27.0 to v1.28.2
  • etcd-defrag from v1.0.8 to v1.2.2
  • etcd-k8s-res-count-exporter from v1.10.7 to v1.10.10
  • k8s-audit-metrics from v0.10.6 to v0.10.9
  • node-exporter from v1.20.5 to v1.20.8
  • observability-bundle from v2.2.2 to v2.3.2
  • security-bundle from v1.12.0 to v1.14.0
  • vertical-pod-autoscaler from v6.0.1 to v6.1.1
  • vertical-pod-autoscaler-crd from v4.0.1 to v4.1.1

  capi-node-labeler v1.1.3…v1.1.5

  Changed

  • Go: Update dependencies.
  • Go: Update dependencies.

  cert-exporter v2.9.9…v2.9.13

  Changed

  • Go: Update dependencies.
  • Go: Update dependencies.
  • Chart: Add value to toggle creation of Daemonset resources.
  • Go: Update dependencies.

  cert-manager v3.9.2…v3.9.4

  Added

  • Add E2E tests using apptest-framework for automated PR testing across multiple providers (CAPA, CAPV, CAPZ, CAPVCD).
    • Basic test suite: Validates fresh installations
    • Upgrade test suite: Tests upgrade scenarios and certificate reconciliation
  • Add certificate issuance integration test to cluster-test-suites.

  Changed

  • Upgrade cert-manager to v1.18.2.
  • Fix missing targetPort in cainjector-service

  cilium v1.3.0…v1.3.1

  Changed

  • Upgrade Cilium to v1.18.2.

  coredns v1.27.0…v1.28.2

  Changed

  • Update coredns image to 1.13.1.
  • Add value to toggle creation of controlplane deployment.
  • Update coredns image to 1.13.0.

  etcd-defrag v1.0.8…v1.2.2

  Changed

  • Chart: Update dependency ahrtr/etcd-defrag to v0.35.0. (#64)
  • Chart: Update dependency ahrtr/etcd-defrag to v0.34.0. (#62)
  • Chart: Update dependency ahrtr/etcd-defrag to v0.33.0. (#60)
  • Update Kyverno API to v2 for policy exceptions
  • Chart: Update dependency ahrtr/etcd-defrag to v0.32.0. (#57)

  etcd-k8s-res-count-exporter v1.10.7…v1.10.10

  Changed

  • Go: Update dependencies.
  • Go: Update dependencies.
  • Update Kyverno API to v2 for policy exceptions
  • Go: Update dependencies.

  k8s-audit-metrics v0.10.6…v0.10.9

  Changed

  • Go: Update dependencies.
  • Go: Update dependencies.
  • Update Kyverno API to v2 for policy exceptions
  • Go: Update dependencies.

  node-exporter v1.20.5…v1.20.8

  Changed

  • Go: Update dependencies.
  • Go: Update dependencies.
  • Update Kyverno API to v2 for policy exceptions
  • Go: Update dependencies.

  observability-bundle v2.2.2…v2.3.2

  Added

  • Add KSM metrics for cloudnative-pg Cluster objects

  Changed

  • Update alloy-app to 0.15.0
    • Bumps alloy to 1.11.0

  Fixed

  • Update alloy-app to 0.15.1
    • Bumps alloy to 1.11.2

  security-bundle v1.12.0…v1.14.0

  Changed

  • Update kyverno (app) to v0.20.1.
  • Update kyverno-crds (app) to v1.14.0.
  • Update kyverno-policies (app) to v0.24.0.
  • Update reports-server (app) to v0.0.3.
  • Revert previous kyverno update (#536, #531, #538).
  • Update kyverno-policy-operator (app) to v0.1.6.
  • Update kyverno (app) to v0.20.0.
  • Update kyverno-crds (app) to v1.14.0.
  • Update kyverno-policies (app) to v0.24.0.
  • Update kyverno-policy-operator (app) to v0.1.5.
  • Update trivy-operator (app) to v0.12.1.
  • Update trivy (app) to v0.14.1.
  • Update falco (app) to v0.11.0.

  vertical-pod-autoscaler v6.0.1…v6.1.1

  Changed

  • Chart: Update Helm release vertical-pod-autoscaler to v11.1.1. (#375)
  • Chart: Update Helm release vertical-pod-autoscaler to v11.1.0. (#372)

  vertical-pod-autoscaler-crd v4.0.1…v4.1.1

  Changed

  • Chart: Sync to upstream. (#166)
  • Chart: Sync to upstream. (#164)
• Oct 21, 2025 CAPZ releases releases azure-33.0.1

  Changes compared to v33.0.0

  Apps

  • security-bundle from v1.12.0 to v1.13.1

  security-bundle v1.12.0…v1.13.1

  Changed

  • Revert previous kyverno update (#536, #531, #538).
  • Update kyverno-policy-operator (app) to v0.1.6.
  • Update kyverno (app) to v0.20.0.
  • Update kyverno-crds (app) to v1.14.0.
  • Update kyverno-policies (app) to v0.24.0.
  • Update kyverno-policy-operator (app) to v0.1.5.
  • Update trivy-operator (app) to v0.12.1.
  • Update trivy (app) to v0.14.1.
  • Update falco (app) to v0.11.0.
• Sep 10, 2025 CAPZ releases releases azure-31.1.2

  This release fixes a permission issue with the Azure Cloud Controller Manager.

  Changes compared to v31.1.1

  Apps

  • azure-cloud-controller-manager from v1.31.8-gs1 to v1.31.8-gs2

  azure-cloud-controller-manager v1.31.8-gs1…v1.31.8-gs2

  Changed

  • Chart: Update RBAC. (#122)