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

适用于 Azure Kubernetes 服务的 Azure 应用程序配置扩展（预览版）

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

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

Bicep

使用以下示例创建 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'
    releaseTrain: 'preview'
  }
}

使用 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

--auto-upgrade-minor-version false

Bicep

properties {
  autoUpgradeMinorVersion: false
}

面向特定版本

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

Azure CLI

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

Bicep

使用以下示例创建 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'
    releaseTrain: 'preview'
    version: '2.0.0-preview'
  }
}

使用 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.0.0-preview

区域

Azure 应用程序配置扩展在以下区域中可用：

美国东部 2 EUAP、加拿大中部、美国中西部、印度中部、美国东部、美国东部 2、北欧、英国南部、澳大利亚东部、美国中部、西欧、美国西部 2、美国西部 3

排查扩展安装错误

如果扩展无法进行创建或更新，请尝试 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 提供程序的所有受支持功能。