Skip to content

Commit 63c54d2

Browse files
committed
add error message, reformat
1 parent 0781cf3 commit 63c54d2

File tree

1 file changed

+21
-14
lines changed

1 file changed

+21
-14
lines changed

articles/aks/dapr-ext-troubleshooting.md

Lines changed: 21 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -16,20 +16,6 @@ When installing the Dapr extension for Azure Kubernetes Service (AKS) or Arc for
1616

1717
## Common error messages
1818

19-
### Dapr version doesn't exist
20-
21-
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).
22-
23-
### Dapr version exists, but not in the mentioned region
24-
25-
Some versions of Dapr aren't 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.
26-
27-
### Dapr OSS already exists
28-
29-
You're installing the Dapr extension for AKS or Arc for Kubernetes, but receive an error message indicating that Dapr already exists. You need to uninstall Dapr OSS before installing the Dapr extension. For more information, read [Migrate from Dapr OSS](./dapr-migration.md).
30-
31-
## Install or update failure
32-
3319
If the extension fails to create or update without an error message, 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`:
3420

3521
```azure-cli-interactive
@@ -55,6 +41,27 @@ If you run into a general error with no specific message during Dapr extension i
5541
- [Restart your AKS or Arc for Kubernetes cluster](./start-stop-cluster.md).
5642
- Make sure you've [registered the `KubernetesConfiguration` service provider](./dapr.md#register-the-kubernetesconfiguration-service-provider).
5743

44+
See below for examples of error messages you may encounter during Dapr extension install or update.
45+
46+
### Dapr version doesn't exist
47+
48+
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).
49+
50+
### Dapr version exists, but not in the mentioned region
51+
52+
Some versions of Dapr aren't 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.
53+
54+
### Dapr OSS already exists
55+
56+
You're installing the Dapr extension for AKS or Arc for Kubernetes, but receive an error message indicating that Dapr already exists. This error message may look like:
57+
58+
```json
59+
(ExtensionOperationFailed) The extension operation failed with the following error: Error: {failed to install chart from path [] for release [dapr-ext]: err [rendered manifests contain a resource that already exists. Unable to continue with install: ServiceAccount "dapr-operator" in namespace "dapr-system" exists and cannot be imported into the current release: invalid ownership metadata; annotation validation error: key "meta.helm.sh/release-name" must equal "dapr-ext": current value is "dapr"]} occurred while doing the operation : {Installing the extension} on the config
60+
```
61+
62+
You need to uninstall Dapr OSS before installing the Dapr extension. For more information, read [Migrate from Dapr OSS](./dapr-migration.md).
63+
64+
5865
## Next steps
5966

6067
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

Comments
 (0)