共用方式為

設定 Azure Kubernetes Service 的 Azure 應用程式組態 擴充功能

  • 發行項

一旦建立 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 應用程式組態延伸模組後，請嘗試快速入門以了解如何使用它。