Troubleshoot AKS cluster extension deployment errors
mainWhen deploying cluster extensions for Azure Kubernetes Service (AKS), errors typically fall into two categories: Core extensions (like Azure Monitor) or Standard extensions/Kubernetes applications (deployed via Helm).
To troubleshoot, first identify which category your extension belongs to:
1. Core Extensions (e.g., Azure Monitor)
Common issues include:
- Provisioning state is
Failed: The extension failed to deploy. - Direct extension update is denied: You are unable to edit or update the monitoring extension directly.
- Resource locks: A lock is preventing you from disabling the monitoring add-on.
- Azure Policy: An Azure Policy is blocking the enablement of the monitoring add-on.
2. Standard Extensions or Kubernetes Applications (Helm-based)
Common issues include:
- Resource readiness timeout or
BackoffLimitExceeded. - Helm chart download failures from the repository URL.
- Helm chart rendering failures due to provided values.
- Resource conflicts: An existing Kubernetes resource already exists in the cluster.
- Concurrent operations: Another Helm operation is already in progress.