適用於 Azure Kubernetes Service 的 Azure 應用程式組態 擴充功能 （預覽版）

Azure 應用程式組態服務可集中管理應用程式設定和功能旗標。 Azure 應用程式組態 Kubernetes Provider 是 Kubernetes 操作員，可從 Azure 應用程式組態 取得索引鍵/值、金鑰保存庫 參考和功能旗標，並將其建置至 Kubernetes ConfigMaps 和秘密。 Azure Kubernetes Service （AKS） 的 Azure 應用程式組態 擴充功能可讓您透過 Azure Resource Manager （ARM） 在 AKS 叢集上安裝和管理 Azure 應用程式組態 Kubernetes Provider。

必要條件

• Azure 訂用帳戶。 沒有嗎？ 建立免費帳戶。
• 安裝最新版的 Azure CLI。
• 如果您還沒有 AKS 叢集，則必須建立 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 Provider。

例如，透過 AKS 叢集上的 Azure 應用程式組態 擴充功能，安裝最新版的 Azure 應用程式組態 Kubernetes Provider：

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 Provider，或復原回舊版。 將 設定為 ，並將 --version 設定--auto-upgrade-minor-versionfalse為您想要安裝的 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 Provider：

• 2.0.0-preview

地區

Azure 應用程式組態 延伸模組可在下列區域中使用：

美國東部 2 EUAP、加拿大中部、美國中西部、印度中部、美國東部、美國東部 2、北歐、英國南部、澳大利亞東部、美國中部、西歐、美國西部 2、美國西部 3

針對擴充功能安裝錯誤進行疑難解答

如果擴充功能無法建立或更新，請嘗試 Azure 應用程式組態 擴充功能疑難解答指南中的建議和解決方案。

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

透過疑難解答指南 Azure 應用程式組態 Kubernetes 提供者錯誤進行疑難解答。

刪除延伸模組

如果您需要刪除擴充功能，並從 AKS 叢集中移除 Azure 應用程式組態 Kubernetes Provider，您可以使用下列命令：

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

後續步驟

• 深入瞭解您可以在 Azure 應用程式組態 延伸模組上設定的額外設定和喜好設定。
• 成功在 AKS 叢集中安裝 Azure 應用程式組態 擴充功能後，請嘗試快速入門以瞭解如何使用它。
• 請參閱 Azure 應用程式組態 Kubernetes Provider 的所有支援功能。