diff --git a/docs/docs/reference/migration.md b/docs/docs/reference/migration.md index 36680eef6b4..9fa68768dc0 100644 --- a/docs/docs/reference/migration.md +++ b/docs/docs/reference/migration.md @@ -3,7 +3,19 @@ This document describes breaking changes and migrations between Constellation releases. Use [`constellation config migrate`](./cli.md#constellation-config-migrate) to automatically update an old config file to a new format. -## Migrating from Azure's service principal authentication to managed identity authentication + +## Migrations to v2.19.0 + +### Azure + +* To allow seamless upgrades on Azure when Kubernetes services of type `LoadBalancer` are deployed, we changed the target + load balancer in which the `cloud-controller-maanger` create the load balancing rules. Instead of using the load balancer we + create and maintain in the CLI's Terraform code, the `cloud-controller-mananger` now creates its own load balancer in Azure. + If inside your Constellation there are services of type `LoadBalancer`, please remove them before the upgrade and re-apply them + afterwards. + + +## Migrating from Azure's service principal authentication to managed identity authentication (during the upgrade to Constellation v2.8.0) - The `provider.azure.appClientID` and `provider.azure.appClientSecret` fields are no longer supported and should be removed. - To keep using an existing UAMI, add the `Owner` permission with the scope of your `resourceGroup`.