安装适用于 Azure Kubernetes 服务 (AKS) 和已启用 Arc 的 Kubernetes 的 Dapr 扩展

在您开始之前

添加适用于群集扩展的 Azure CLI 扩展

运行以下命令安装 k8s-extension Azure CLI 扩展：

az extension add --name k8s-extension

如果已安装 k8s-extension 扩展，你可使用以下命令将其更新到最新版本：

az extension update --name k8s-extension

注册 KubernetesConfiguration 资源提供程序

如果您尚未使用群集扩展，可能需要将资源提供者注册到您的订阅中。 你可以使用 az provider list 命令检查提供程序注册的状态，如下面的示例所示：

az provider list --query "[?contains(namespace,'Microsoft.KubernetesConfiguration')]" -o table

Microsoft.KubernetesConfiguration 提供程序应报告为 Registered，如以下示例输出中所示：

Namespace                          RegistrationState    RegistrationPolicy
---------------------------------  -------------------  --------------------
Microsoft.KubernetesConfiguration  Registered           RegistrationRequired

如果提供程序显示为“未注册”，请使用 az provider register 注册提供程序，如下面的示例所示：

az provider register --namespace Microsoft.KubernetesConfiguration

将 ExtensionTypes 功能注册到 Azure 订阅

需要将 ExtensionTypes 功能注册到 Azure 订阅。 在终端中，验证你是否在正确的订阅中：

az account set --subscription <your-azure-subscription-ID>

注册 ExtensionTypes 功能。

az feature registration create --namespace Microsoft.KubernetesConfiguration --name ExtensionTypes

功能注册可能需要一些时间。 几分钟后，使用以下命令检查注册状态：

az feature show --namespace Microsoft.KubernetesConfiguration --name ExtensionTypes

创建扩展并在 AKS 或已启用 Arc 的 Kubernetes 群集上安装 Dapr

安装 Dapr 扩展时，请使用与群集类型对应的标志值：

• AKS 群集： --cluster-type managedClusters
• 已启用 Arc 的 Kubernetes 群集： --cluster-type connectedClusters

创建 Dapr 扩展，该扩展在 AKS 或已启用 Arc 的 Kubernetes 群集上安装 Dapr。

例如，通过 AKS 群集上的 Dapr 扩展安装最新版本的 Dapr：

az k8s-extension create --cluster-type managedClusters \
--cluster-name <your-AKS-cluster> \
--resource-group <your-resource-group> \
--name dapr \
--extension-type Microsoft.Dapr \
--auto-upgrade-minor-version false

使托管 AKS 群集保持更新到最新版本

基于你的环境（开发、测试或生产），你可以随时了解最新的稳定 Dapr 版本。

选择发布列车

配置扩展时，可以选择从特定版本序列安装 Dapr。 指定两个版本序列值之一:

例如：

--release-train stable

配置 Dapr 控制平面的自动更新

如果在未指定版本的情况下安装 Dapr，--auto-upgrade-minor-version系统将自动启用，并将 Dapr 控制平面配置为在新版本发布时自动更新其小版本号。

可以通过指定 --auto-upgrade-minor-version 参数并将值设置为 false 来禁用自动更新。

Dapr 版本控制采用 格式的方式，这意味着属于次要版本升级。

--auto-upgrade-minor-version true

查看可用的最新稳定 Dapr 版本

若要在生产环境中升级到最新的 Dapr 版本，需要手动升级。 首先查看你的托管 AKS 群集可用的稳定 Dapr 版本列表。 运行下面的命令：

az k8s-extension extension-types list-versions-by-cluster --resource-group <your-resource-group> --cluster-name <your-AKS-cluster> --cluster-type managedClusters --extension-type microsoft.dapr --release-train stable

若要查看你的托管 AKS 群集可用的最新稳定 Dapr 版本，请运行以下命令：

az k8s-extension extension-types list-versions-by-cluster --resource-group <your-resource-group> --cluster-name <your-AKS-cluster> --cluster-type managedClusters --extension-type microsoft.dapr  --release-train stable --show-latest

若要按位置查看可用的稳定 Dapr 版本的列表，请运行以下命令：

1. 确保已将 该功能注册 ExtensionTypes 到 Azure 订阅。
2. 运行以下命令。

az k8s-extension extension-types list-versions-by-location --location chinanorth3 --extension-type microsoft.dapr

面向特定的 Dapr 版本

接下来，手动将 Dapr 更新为最新的稳定版本。

可使用相同的命令行参数安装特定版本的 Dapr 或回滚到以前的版本。 将 --auto-upgrade-minor-version 设置为 false 并将 --version 设置为想要安装的 Dapr 版本。 如果省略了 version 参数，则扩展将安装最新版本的 Dapr。 以下示例命令在 AKS 群集上安装 Dapr 版本 1.14.4-msft.10 ：

az k8s-extension create --cluster-type managedClusters \
--cluster-name <your-AKS-cluster> \
--resource-group <your-resource-group> \
--name dapr \
--extension-type Microsoft.Dapr \
--auto-upgrade-minor-version false \
--version 1.14.4-msft.10

在您开始之前

注册 KubernetesConfiguration 资源提供程序

如果您尚未使用群集扩展，可能需要将资源提供者注册到您的订阅中。 你可以使用 az provider list 命令检查提供程序注册的状态，如下面的示例所示：

az provider list --query "[?contains(namespace,'Microsoft.KubernetesConfiguration')]" -o table

Microsoft.KubernetesConfiguration 提供程序应报告为 Registered，如以下示例输出中所示：

Namespace                          RegistrationState    RegistrationPolicy
---------------------------------  -------------------  --------------------
Microsoft.KubernetesConfiguration  Registered           RegistrationRequired

如果提供程序显示为“未注册”，请使用 az provider register 注册提供程序，如下面的示例所示：

az provider register --namespace Microsoft.KubernetesConfiguration

将 ExtensionTypes 功能注册到 Azure 订阅

需要将 ExtensionTypes 功能注册到 Azure 订阅。 在终端中，验证你是否在正确的订阅中：

az account set --subscription <your-azure-subscription-ID>

注册 ExtenstionTypes 功能。

az feature registration create --namespace Microsoft.KubernetesConfiguration --name ExtensionTypes

功能注册可能需要一些时间。 几分钟后，使用以下命令检查注册状态：

az feature show --namespace Microsoft.KubernetesConfiguration --name ExtensionTypes

在已启用 AKS 或 Arc 的 Kubernetes 群集上部署 Dapr 扩展

创建与以下示例类似的 Bicep 模板，并将 Dapr 扩展部署到现有群集。

@description('The name of the Managed Cluster resource.')
param clusterName string

resource existingManagedClusters 'Microsoft.ContainerService/managedClusters@2023-05-02-preview' existing = {
  name: clusterName
}

resource daprExtension 'Microsoft.KubernetesConfiguration/extensions@2022-11-01' = {
  name: 'dapr'
  scope: existingManagedClusters
  identity: {
    type: 'SystemAssigned'
  }
  properties: {
    autoUpgradeMinorVersion: true
    configurationProtectedSettings: {}
    configurationSettings: {
      'global.clusterType': 'managedclusters'
    }
    extensionType: 'microsoft.dapr'
    releaseTrain: 'stable'
    scope: {
      cluster: {
        releaseNamespace: 'dapr-system'
      }
    }
    version: '1.11.2'
  }
}

设置以下变量，将以下值更改为你的实际资源组和群集名称。

MY_RESOURCE_GROUP=<your-resource-group>
MY_AKS_CLUSTER=<your-AKS-cluster>

使用 az deployment group 命令部署Bicep模板。

az deployment group create \
  --resource-group $MY_RESOURCE_GROUP \
  --template-file ./my-bicep-file-path.bicep \
  --parameters clusterName=$MY_AKS_CLUSTER

配置 Dapr 控制平面的自动更新

如果在未指定版本的情况下部署 Dapr，autoUpgradeMinorVersion将会自动启用，这会将 Dapr 控制平面配置为在有新版本发布时自动更新其次要版本。

可以通过指定 autoUpgradeMinorVersion 参数并将值设置为 false 来禁用自动更新。

Dapr 版本控制采用 格式的方式，这意味着属于次要版本升级。

properties {
  autoUpgradeMinorVersion: true
}

面向特定的 Dapr 版本

将 autoUpgradeMinorVersion 设置为 false 并将 version 设置为想要安装的 Dapr 版本。 如果 autoUpgradeMinorVersion 参数设置为 true，version 参数被省略，则扩展程序会安装最新版本的 Dapr。

例如，若要使用 Dapr 1.11.2，请执行以下操作：

properties: {
  autoUpgradeMinorVersion: false
  version: '1.11.2'
}

选择发布列车

配置扩展时，可以选择从特定版本序列安装 Dapr。 指定两个版本序列值之一:

例如：

properties: {
  releaseTrain: 'stable'
}