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

适用于 Azure Kubernetes 服务的 Azure 应用程序配置扩展

项目
10/01/2024

Azure 应用程序配置提供一个服务用于集中管理应用程序设置和功能标志。 Azure 应用程序配置 Kubernetes 提供程序是一个 Kubernetes 运算符，它从 Azure 应用程序配置获取键值、密钥保管库引用和功能标志，并将其构建到 Kubernetes ConfigMaps 和机密中。 Azure Kubernetes 服务 (AKS) 的 Azure 应用配置扩展允许通过 Azure 资源管理器 (ARM) 在 AKS 群集上安装和管理 Azure 应用程序配置 Kubernetes 提供程序。

先决条件

Azure 订阅。没有帐户？创建免费帐户。
安装最新版本的 Azure CLI。
如果没有，则需要创建一个 AKS 群集。
确保具有 Azure Kubernetes 服务 RBAC 管理员角色

设置适用于群集扩展的 Azure CLI 扩展

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

az extension add --name k8s-extension

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

az extension update --name k8s-extension

注册 `KubernetesConfiguration` 资源提供程序

如果以前没有使用过群集扩展，则可能需要在订阅中注册资源提供程序。你可以使用 az provider list 命令检查提供程序注册的状态，如下面的示例所示：

az provider list --query "[?namespace=='Microsoft.KubernetesConfiguration']" -o table

Microsoft.KubernetesConfiguration 提供程序应报告为“已注册”，如下面的示例输出所示：

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

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

az provider register --namespace Microsoft.KubernetesConfiguration

在 AKS 群集上安装扩展

创建 Azure 应用程序配置扩展，该扩展在 AKS 上安装 Azure 应用程序配置 Kubernetes 提供程序。

例如，通过 AKS 群集上的 Azure应用程序配置扩展安装最新版本的 Azure 应用程序配置 Kubernetes 提供程序：

Azure CLI
Bicep

az k8s-extension create --cluster-type managedClusters \
    --cluster-name myAKSCluster \
    --resource-group myResourceGroup \
    --name appconfigurationkubernetesprovider \
    --extension-type Microsoft.AppConfiguration

使用以下示例创建 Bicep 模板。

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

resource existingManagedCluster 'Microsoft.ContainerService/managedClusters@2024-02-01' existing = {
  name: clusterName
}

resource appConfigExtension 'Microsoft.KubernetesConfiguration/extensions@2022-11-01' = {
  name: 'appconfigurationkubernetesprovider'
  scope: existingManagedCluster
  properties: {
    autoUpgradeMinorVersion: true
    configurationSettings: {
      'global.clusterType': 'managedclusters'
    }
    extensionType: 'microsoft.appconfiguration'
  }
}

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

az deployment group create \
  --resource-group myResourceGroup \
  --template-file ./my-bicep-file-path.bicep \
  --parameters clusterName=myAKSCluster

配置自动更新

如果在未指定版本的情况下创建 Azure 应用程序配置扩展，--auto-upgrade-minor-version 会自动启用，并将 Azure 应用程序配置扩展配置为当有新版本可用时自动更新其次要版本。

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

Azure CLI
Bicep

--auto-upgrade-minor-version false

properties {
  autoUpgradeMinorVersion: false
}

面向特定版本

可使用相同的命令行参数安装特定版本的 Azure 应用程序配置 Kubernetes 提供程序或回滚到以前的版本。将 --auto-upgrade-minor-version 设置为 false，并将 --version 设置为要安装的 Azure 应用程序配置 Kubernetes 提供程序的版本。如果省略了 version 参数，则扩展将安装最新版本。

Azure CLI
Bicep

az k8s-extension create --cluster-type managedClusters \
    --cluster-name myAKSCluster \
    --resource-group myResourceGroup \
    --name appconfigurationkubernetesprovider \
    --extension-type Microsoft.AppConfiguration \
    --auto-upgrade-minor-version false
    --version 2.1.0

使用以下示例创建 Bicep 模板。

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

resource existingManagedCluster 'Microsoft.ContainerService/managedClusters@2024-02-01' existing = {
  name: clusterName
}

resource appConfigExtension 'Microsoft.KubernetesConfiguration/extensions@2022-11-01' = {
  name: 'appconfigurationkubernetesprovider'
  scope: existingManagedCluster
  properties: {
    autoUpgradeMinorVersion: false
    configurationSettings: {
      'global.clusterType': 'managedclusters'
    }
    extensionType: 'microsoft.appconfiguration'
    version: '2.1.0'
  }
}

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

az deployment group create \
  --resource-group myResourceGroup \
  --template-file ./my-bicep-file-path.bicep \
  --parameters clusterName=myAKSCluster

扩展版本

Azure 应用程序配置扩展支持以下版本的 Azure 应用程序配置 Kubernetes 提供程序：

2.1.0
2.0.0

排查扩展安装错误

如果扩展无法进行创建或更新，请尝试 Azure 应用程序配置扩展故障排除指南中的建议和解决方案。

排查 Azure 应用程序配置 Kubernetes 提供程序错误

通过故障排除指南排查 Azure 应用程序配置 Kubernetes 提供程序错误。

删除扩展

如果需要删除扩展并从 AKS 群集中删除 Azure 应用程序配置 Kubernetes 提供程序，可以使用以下命令：

az k8s-extension delete --resource-group myResourceGroup --cluster-name myAKSCluster --cluster-type managedClusters --name appconfigurationkubernetesprovider

后续步骤

详细了解可以在 Azure 应用程序配置扩展上设置的其他设置和首选项。
在 AKS 群集中成功安装 Azure 应用程序配置扩展后，请尝试通过快速入门了解如何使用它。
请参阅 Azure 应用程序配置 Kubernetes 提供程序的所有受支持功能。

通过