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

發行項
09/27/2024

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

共用方式為

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

必要條件

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

註冊 `KubernetesConfiguration` 資源提供者

在 AKS 叢集上安裝延伸模組

設定自動更新

以特定版本為目標

延伸模組版本

針對延伸模組安裝錯誤進行疑難排解

針對 Azure 應用程式組態 Kubernetes 提供者進行疑難排解

刪除延伸模組

後續步驟

其他資源

共用方式為

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

必要條件

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

註冊 KubernetesConfiguration 資源提供者

在 AKS 叢集上安裝延伸模組

設定自動更新

以特定版本為目標

延伸模組版本

針對延伸模組安裝錯誤進行疑難排解

針對 Azure 應用程式組態 Kubernetes 提供者進行疑難排解

刪除延伸模組

後續步驟

其他資源

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

註冊 `KubernetesConfiguration` 資源提供者