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

为 Azure Kubernetes 服务配置 Azure 应用程序配置扩展

项目
09/10/2024

创建 Azure 应用程序配置扩展后，你可以使用各种配置选项对扩展进行配置，使其最适合你和你的项目，例如：

配置副本计数。
配置日志详细程度。
配置安装命名空间。

该扩展允许在 Azure CLI 中使用 --configuration-settings 参数配置 Azure 应用程序配置扩展设置。

提示

有关可用选项的列表，请参阅 Azure 应用程序配置 Kubernetes 提供程序 helm 值。

配置副本计数

默认副本计数为 1。创建具有自定义副本计数的 Azure 应用程序配置扩展：

az k8s-extension create --cluster-type managedClusters \
    --cluster-name myAKSCluster \
    --resource-group myResourceGroup \
    --name appconfigurationkubernetesprovider \
    --extension-type Microsoft.AppConfiguration \
    --auto-upgrade-minor-version true \
    --configuration-settings "replicaCount=3"

注意

如果配置设置是敏感的并且需要进行保护，例如证书相关的信息，请传递--configuration-protected-settings参数，将保护其值不会被读取。

配置日志详细程度

默认日志详细程度为 1。创建具有自定义日志详细程度的 Azure 应用程序配置扩展：

az k8s-extension create --cluster-type managedClusters \
    --cluster-name myAKSCluster \
    --resource-group myResourceGroup \
    --name appconfigurationkubernetesprovider \
    --extension-type Microsoft.AppConfiguration \
    --auto-upgrade-minor-version true \
    --configuration-settings "logVerbosity=3"

日志详细程度级别遵循 klog 约定：

0：仅限警告和错误。
1：信息，此为默认级别。
2：详细的稳定状态信息。
3：有关更改的扩展信息。
4：调试级别详细程度。
5：跟踪级别详细程度。

配置 Azure 应用程序配置扩展命名空间

默认情况下，Azure 应用程序配置扩展安装在 azappconfig-system 命名空间中。若要替代它，请使用 --release-namespace。包括群集 --scope 以重新定义命名空间。

az k8s-extension create --cluster-type managedClusters \
    --cluster-name myAKSCluster \
    --resource-group myResourceGroup \
    --name appconfigurationkubernetesprovider \
    --extension-type Microsoft.AppConfiguration \
    --auto-upgrade-minor-version true \
    --scope cluster \
    --release-namespace custom-namespace

显示当前配置设置

使用 az k8s-extension show 命令显示当前的 Azure 应用程序配置扩展设置：

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

更新配置设置

若要更新 Azure 应用程序配置扩展设置，请重新创建具有所需状态的扩展。例如，假设我们已使用以下配置安装了扩展：

az k8s-extension create --cluster-type managedClusters \
    --cluster-name myAKSCluster \
    --resource-group myResourceGroup \
    --name appconfigurationkubernetesprovider \
    --extension-type Microsoft.AppConfiguration \
    --auto-upgrade-minor-version true \  
    --configuration-settings "replicaCount=2"

若要将 replicaCount 从两个更新为三个，请使用以下命令：

az k8s-extension create --cluster-type managedClusters \
    --cluster-name myAKSCluster \
    --resource-group myResourceGroup \
    --name appconfigurationkubernetesprovider \
    --extension-type Microsoft.AppConfiguration \
    --auto-upgrade-minor-version true \
    --configuration-settings "replicaCount=3"

后续步骤

在 AKS 群集中成功安装 Azure 应用程序配置扩展后，请尝试通过快速入门了解如何使用它。

通过