從 Dapr OSS 移轉至適用於 Azure Kubernetes Service (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 版本名稱和命名空間 (從 helm list -A)：

   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 只允許針對 StatefulSets 中的有限欄位進行修補。 如果設定任何 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 和其使用方式。