运行以下命令安装 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 提供程序应报告为“已注册”,如下面的示例输出所示:
Namespace RegistrationState RegistrationPolicy
--------------------------------- ------------------- --------------------
Microsoft.KubernetesConfiguration Registered RegistrationRequired
如果提供程序显示为“未注册”,请使用 az provider register 注册提供程序,如下面的示例所示:
az provider register --namespace Microsoft.KubernetesConfiguration
将 ExtenstionTypes
功能注册到 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
安装 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 <myAKSCluster> \
--resource-group <myResourceGroup> \
--name dapr \
--extension-type Microsoft.Dapr \
--auto-upgrade-minor-version false
基于你的环境(开发、测试或生产),你可以随时了解最新的稳定 Dapr 版本。
配置扩展时,可以选择从特定版本序列安装 Dapr。 指定两个版本序列值之一:
值 |
描述 |
stable |
默认。 |
dev |
早期版本,可能包含试验性功能。 不适合用于生产。 |
例如:
--release-train stable
如果在未指定版本的情况下安装 Dapr,--auto-upgrade-minor-version
会自动启用,并将 Dapr 控制平面配置为当有新版本可用时自动更新其次要版本。
可以通过指定 --auto-upgrade-minor-version
参数并将值设置为 false
来禁用自动更新。
Dapr 版本控制采用 MAJOR.MINOR.PATCH
格式,这意味着从 1.11.0
到 1.12.0
是次要版本升级。
--auto-upgrade-minor-version true
若要在生产环境中升级到最新的 Dapr 版本,需要手动升级。 首先查看你的托管 AKS 群集可用的稳定 Dapr 版本列表。 运行以下命令:
az k8s-extension extension-types list-versions-by-cluster --resource-group <myResourceGroup> --cluster-name <myCluster> --cluster-type managedClusters --extension-type microsoft.dapr --release-train stable
若要查看你的托管 AKS 群集可用的最新稳定 Dapr 版本,请运行以下命令:
az k8s-extension extension-types list-versions-by-cluster --resource-group <myResourceGroup> --cluster-name <myCluster> --cluster-type managedClusters --extension-type microsoft.dapr --release-train stable --show-latest
若要按位置查看可用的稳定 Dapr 版本的列表,请运行以下命令:
- 确保你已将
ExtenstionTypes
功能注册到你的 Azure 订阅。
- 运行以下命令。
az k8s-extension extension-types list-versions-by-location --location westus --extension-type microsoft.dapr
接下来,手动将 Dapr 更新为最新稳定版本。
备注
Dapr 支持滚动窗口,仅包括当前版本和以前版本。 你需要负责保证这些受支持版本的最新状态。 如果使用的是较旧版本的 Dapr,则可能需要进行中间升级才能获得受支持的版本。
可使用相同的命令行参数安装特定版本的 Dapr 或回滚到以前的版本。 将 --auto-upgrade-minor-version
设置为 false
并将 --version
设置为想要安装的 Dapr 版本。 如果省略了 version
参数,则扩展将安装最新版本的 Dapr。 例如,若要使用 Dapr 1.13.5,请执行以下操作:
az k8s-extension create --cluster-type managedClusters \
--cluster-name <myAKSCluster> \
--resource-group <myResourceGroup> \
--name dapr \
--extension-type Microsoft.Dapr \
--auto-upgrade-minor-version false \
--version 1.13.5
注册 KubernetesConfiguration
资源提供程序
如果你还没有使用过群集扩展,则可能需要在订阅中注册资源提供程序。 你可以使用 az provider list 命令检查提供程序注册的状态,如下面的示例所示:
az provider list --query "[?contains(namespace,'Microsoft.KubernetesConfiguration')]" -o table
Microsoft.KubernetesConfiguration 提供程序应报告为“已注册”,如下面的示例输出所示:
Namespace RegistrationState RegistrationPolicy
--------------------------------- ------------------- --------------------
Microsoft.KubernetesConfiguration Registered RegistrationRequired
如果提供程序显示为“未注册”,请使用 az provider register 注册提供程序,如下面的示例所示:
az provider register --namespace Microsoft.KubernetesConfiguration
将 ExtenstionTypes
功能注册到 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=<myResourceGroup>
MY_AKS_CLUSTER=<myAKSCluster>
使用 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 版本控制采用 MAJOR.MINOR.PATCH
格式,这意味着从 1.11.0
到 1.12.0
是次要版本升级。
properties {
autoUpgradeMinorVersion: true
}
备注
Dapr 支持滚动窗口,仅包括当前版本和以前版本。 你需要负责保证这些受支持版本的最新状态。 如果使用的是较旧版本的 Dapr,则可能需要进行中间升级才能获得受支持的版本。
将 autoUpgradeMinorVersion
设置为 false
并将 version
设置为想要安装的 Dapr 版本。 如果 autoUpgradeMinorVersion
参数设置为 true
,version
参数被省略,则扩展程序会安装最新版本的 Dapr。
例如,若要使用 Dapr 1.11.2,请执行以下操作:
properties: {
autoUpgradeMinorVersion: false
version: '1.11.2'
}
配置扩展时,可以选择从特定版本序列安装 Dapr。 指定两个版本序列值之一:
值 |
描述 |
stable |
默认。 |
dev |
早期版本,可能包含试验性功能。 不适合用于生产。 |
例如:
properties: {
releaseTrain: 'stable'
}