Cloudera Docs

Azure workload and database instance type fallback

As part of Microsoft's retirement of Azure v1–v4 Virtual Machine (VM) families (effective July 31, 2026), Cloudera Data Engineering 1.26.1-H1 migrates AKS node pool and MySQL Flexible Server instance types to v5+ equivalents. Learn about the fallback mechanisms if a v5 VM SKU is not available in your specific Azure region or subscription.

For most Azure customers, the AKS node pool and MySQL Flexible Server instance types are migrated to v5+ equivalents transparently during the following in-place upgrade.

In some cases, a v5 VM SKU might not be available in your Azure region or subscription for one of the following reasons:

  • Regional capacity limits, the v5 families are not yet deployed in the selected region
  • Subscription quota is not yet allocated for the target SKU family
  • Azure Policy restrictions limit the VM SKU families allowed in the subscription

Before this feature, if a v5 SKU is unavailable in a region, an upgrade would fail destructively: the existing v4 node pool would be deleted, the replacement v5 pool would fail to provision, and the cluster would remain in a degraded state.

This feature introduces two tenant-level entitlements allowing you to lock a specific tenant to legacy (1.26.1-level) instance types for workloads, or the database, or both, until the v5 capacity situation is resolved. It also introduces a pre-flight SKU availability check that validates v5 SKU availability before any destructive operation is started.

Entitlements

Both entitlements are disabled by default and follow the DE_AZURE_* naming convention.

Both entitlements apply only to the Azure environment. Both entitlement checks are gated on the Azure cloud provider platform, so AWS and on premises are not affected by these entitlements.

The two entitlements are independent and can be enabled separately:

  • Database entitlement only: Retains the legacy database SKU, while node pools are migrated.
  • Workload entitlement only: Retains legacy node pools, while the database SKU is migrated.
  • Both the database and the workload entitlements: Retains both legacy node pools and the legacy database SKU.
Entitlement name Scope
DE_AZURE_LEGACY_WORKLOAD_INSTANCE_TYPE All AKS node pools: base, app, app2, comp, cmp2
DE_AZURE_LEGACY_DB_INSTANCE_TYPE Azure MySQL Flexible Server SKU