適用於 Azure Kubernetes Service 的 Azure 應用程式組態 擴充功能

Azure 應用程式組態服務可集中管理應用程式設定和功能旗標。 Azure 應用程式組態 Kubernetes 提供者是 Kubernetes 操作員，可從 Azure 應用程式組態取得金鑰值、Key Vault 參考和功能旗標，並將其建置到 Kubernetes ConfigMaps 和秘密。 適用於 Azure Kubernetes Service (AKS) 的 Azure 應用程式組態延伸模組可讓您透過 Azure Resource Manager (ARM) 在 AKS 叢集上安裝和管理 Azure 應用程式組態 Kubernetes 提供者。

必要條件

• Azure 訂用帳戶。 如果沒有網路怎麼辦？ 建立免費帳戶。
• 安裝最新版的 Azure CLI。
• 如果您還沒有叢集，則必須建立 AKS 叢集。
• 確定您有 Azure Kubernetes Service RBAC 管理員角色 (部分機器翻譯)

設定叢集延伸模組的 Azure CLI 延伸模組

執行下列命令來安裝 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 "[?namespace=='Microsoft.KubernetesConfiguration']" -o table

Microsoft.KubernetesConfiguration 提供者應該回報為 Registered，如下列範例輸出所示：

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

如果提供者顯示為 NotRegistered，請使用 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

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'
  }
}

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

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'
    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 提供者的所有支援功能。