|
| 1 | +--- |
| 2 | +title: Troubleshoot Dapr extension installation errors |
| 3 | +description: Troubleshoot errors you may encounter while installing the Dapr extension for AKS |
| 4 | +author: hhunter-ms |
| 5 | +ms.author: hannahhunter |
| 6 | +ms.reviewer: nigreenf |
| 7 | +ms.service: container-service |
| 8 | +ms.topic: article |
| 9 | +ms.date: 09/08/2022 |
| 10 | +ms.custom: devx-track-azurecli |
| 11 | +--- |
| 12 | + |
| 13 | +# Troubleshoot Dapr extension installation errors |
| 14 | + |
| 15 | +When you installing the Dapr extension for Azure Kubernetes Service (AKS) or Arc for Kubernetes, you might occasionally come across problems. This article details some common problems and troubleshooting steps. |
| 16 | + |
| 17 | +## Dapr version doesn't exist |
| 18 | + |
| 19 | +You're installing the Dapr extension and [targeting a specific version](./dapr.md#targeting-a-specific-dapr-version), but run into an error message saying the Dapr version doesn't exist. Try installing again, making sure to use a [supported version of Dapr](./dapr.md#dapr-versions). |
| 20 | + |
| 21 | +## Dapr version exists, but not in the mentioned region |
| 22 | + |
| 23 | +Some versions of Dapr are not available in all regions. If you receive this error message, try installing in an [available region](./dapr.md#cloudsregions) where your Dapr version is supported. |
| 24 | + |
| 25 | +## Dapr OSS already exists |
| 26 | + |
| 27 | +You've used Dapr before and would like to install the Dapr extension for AKS or Arc for Kubernetes, but you receive an error message indicating that Dapr already exists. You need to uninstall Dapr OSS before installing the Dapr extension for AKS and Azure Arc for Kubernetes. For more information, read [Migrate from Dapr OSS](./dapr-migration.md). |
| 28 | + |
| 29 | +## General extension install or update failure |
| 30 | + |
| 31 | +If the extension fails to create or update, you can inspect where the creation of the extension failed by running the `az k8s-extension list` command. For example, if a wrong key is used in the configuration-settings, such as `global.ha=false` instead of `global.ha.enabled=false`: |
| 32 | + |
| 33 | +```azure-cli-interactive |
| 34 | +az k8s-extension list --cluster-type managedClusters --cluster-name myAKSCluster --resource-group myResourceGroup |
| 35 | +``` |
| 36 | + |
| 37 | +The below JSON is returned, and the error message is captured in the `message` property. |
| 38 | + |
| 39 | +```json |
| 40 | +"statuses": [ |
| 41 | + { |
| 42 | + "code": "InstallationFailed", |
| 43 | + "displayStatus": null, |
| 44 | + "level": null, |
| 45 | + "message": "Error: {failed to install chart from path [] for release [dapr-1]: err [template: dapr/charts/dapr_sidecar_injector/templates/dapr_sidecar_injector_poddisruptionbudget.yaml:1:17: executing \"dapr/charts/dapr_sidecar_injector/templates/dapr_sidecar_injector_poddisruptionbudget.yaml\" at <.Values.global.ha.enabled>: can't evaluate field enabled in type interface {}]} occurred while doing the operation : {Installing the extension} on the config", |
| 46 | + "time": null |
| 47 | + } |
| 48 | +], |
| 49 | +``` |
| 50 | + |
| 51 | +## Solutions to common retry issues |
| 52 | + |
| 53 | +Some errors while installing Dapr need a simple nudge in the right direction. If you run into a general error with no specific message during Dapr extension install, try the following steps: |
| 54 | + |
| 55 | +- [Restart your AKS or Arc for Kubernetes cluster](./start-stop-cluster.md). |
| 56 | +- Make sure you've [registered the `KubernetesConfiguration` service provider](./dapr.md#register-the-kubernetesconfiguration-service-provider). |
| 57 | + |
| 58 | +# Next steps |
| 59 | + |
| 60 | +If you're still running into issues, explore the [AKS troubleshooting guide](./troubleshooting.md) and the [Dapr OSS troubleshooting guide](https://docs.dapr.io/operations/troubleshooting/common_issues/). |
0 commit comments