你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

从 Dapr OSS 迁移到适用于 Azure Kubernetes 服务 (AKS) 的 Dapr 扩展

本文介绍了如何从 Dapr OSS 迁移到适用于 AKS 的 Dapr 扩展。

可以使用以下两者之一将 Dapr 扩展配置为使用和管理 Dapr OSS 创建的 Kubernetes 资源：

• 通过 Azure CLI 提示符（默认方法）检查现有 Dapr 安装，或
• 使用 --configuration-settings 配置现有的 DAPR 安装。

有关详细信息，请参阅 AKS 的 Dapr 扩展概述。

检查现有 Dapr 安装

安装 Dapr 扩展时，该扩展会检查群集上的现有 Dapr 安装。 如果 Dapr 存在，该扩展将使用和管理 Dapr OSS 创建的 Kubernetes 资源。

1. 使用 helm list -A 命令列出当前 Dapr 安装的详细信息，并保存输出中的 Dapr 版本名称和命名空间。

   helm list -A
   

2. 出现以下问题提示时，输入来自 helm list -A 的 Helm 版本名称和命名空间：

   Enter the Helm release name for Dapr, or press Enter to use the default name [dapr]:
   Enter the namespace where Dapr is installed, or press Enter to use the default namespace [dapr-system]:
   

使用 --configuration-settings 配置现有的 DAPR 安装

创建 Dapr 扩展时，可以使用 --configuration-settings 标志将该扩展配置为使用和管理 Dapr OSS 创建的 Kubernetes 资源。

1. 使用 helm list -A 命令列出当前 Dapr 安装的详细信息，并保存输出中的 Dapr 版本名称和命名空间。

   helm list -A
   

2. 使用 az k8s-extension create 创建 Dapr 扩展，并使用 --configuration-settings 标志设置 Dapr 版本名称和命名空间。

   az k8s-extension create --cluster-type managedClusters \
   --cluster-name myAKSCluster \
   --resource-group myResourceGroup \
   --name dapr \
   --extension-type Microsoft.Dapr \
   --configuration-settings "existingDaprReleaseName=dapr" \
   --configuration-settings "existingDaprReleaseNamespace=dapr-system"
   

更新 HA 模式或放置服务设置

在现有 Dapr 安装的基础上安装 Dapr 扩展时，会收到以下消息：

The extension will be installed on your existing Dapr installation. Note, if you have updated the default values for global.ha.* or dapr_placement.* in your existing Dapr installation, you must provide them in the configuration settings. Failing to do so will result in an error, since Helm upgrade will try to modify the StatefulSet. See <link> for more information.

Kubernetes 仅允许对 StatefulSet 中的有限字段进行修补。 如果配置了任何 HA 模式或放置服务设置，升级将失败。 若要更新 HA 模式或放置服务设置，必须删除有状态集，然后更新 HA 模式。

1. 使用 kubectl delete 命令删除有状态集。

   kubectl delete statefulset.apps/dapr-placement-server -n dapr-system
   

2. 使用 az k8s-extension update 命令更新 HA 模式。

   az k8s-extension update --cluster-type managedClusters \
   --cluster-name myAKSCluster \
   --resource-group myResourceGroup \
   --name dapr \
   --extension-type Microsoft.Dapr \
   --auto-upgrade-minor-version true \  
   --configuration-settings "global.ha.enabled=true" \    
   

有关详细信息，请参阅 Dapr 生产指导。

后续步骤

详细了解 Dapr 以及如何使用。