Deprecation of Legacy Helm Charts in ACR

[toddysm]

Transition from Helm Repositories to OCI Artifacts for Storing Helm Charts

In November 2020, Helm v2 reached end of life. Starting March 30th, 2025, Azure Container Registry will no longer support Helm v2. Therefore, the legacy “Helm repositories” functionality will also be retired. After this date, Azure Container Registry will only support storing Helm charts as Open Container Initiative (OCI) Artifacts.

Open Container Initiative (OCI) Artifacts are container artifacts that utilize the OCI image specification. This allows you to store a Helm chart as an artifact inside your registry by running a helm push command and install a Helm chart by running a helm install command. You can check out a complete guide on working with Helm charts stored as an OCI Artifact here: Store Helm charts - Azure Container Registry | Microsoft Learn

How does this affect me?

• Starting January 21st, 2025, the CLI command [az acr helm push](https://learn.microsoft.com/en-us/cli/azure/acr/helm?view=azure-cli-latest#az-acr-helm-push) will be retired. This will prevent pushing new helm charts to legacy helm repositories.
• Starting March 30, 2025, the CLI command group [az acr helm](https://learn.microsoft.com/en-us/cli/azure/acr/helm?view=azure-cli-latest) will be retired. This will end all legacy helm repository capabilities in Azure Container Registry.
• All Helm charts not stored as an OCI Artifact will be deleted from Azure Container Registry March 30th, 2025.
  • Learn how to find all Helm Charts stored in a Helm repository here: az acr helm | Microsoft Learn. If the Helm Chart you are using is listed then it is stored in a legacy Helm repository and is at risk of deletion.

Required Action

• If you haven’t already, you must begin to migrate to Helm v3. You can find more detailed information in the Helm documentation: Helm | Migrating Helm v2 to v3
• Once you are using Helm v3, you can push your Helm charts as OCI Artifacts. You can read about how to do this in the Azure Container Registry documentation: Store Helm charts - Azure Container Registry | Microsoft Learn

[JXavierMSFT]

In-order to give customers more time to complete the transition, we've decided to postpone the retirement till September 15, 2025. Please see Push and pull a Helm Chart on Azure Container Registry for details.