Установка расширения для конфигурации приложений Azure на AKS

Конфигурация приложений Azure — это служба для централизованного управления параметрами приложения и флагами функций. Поставщик конфигурации приложений Azure для Kubernetes — это оператор Kubernetes, который получает ключ-значения, ссылки на Key Vault и флаги функций из Конфигурации приложений Azure и преобразует их в ConfigMaps и Секреты Kubernetes. расширение Azure App Configuration для Azure Kubernetes Service (AKS) позволяет устанавливать и управлять поставщиком Kubernetes Azure App Configuration в вашем кластере AKS через Azure Resource Manager (ARM).

Предварительные условия

Подписка Azure. Создайте бесплатную учетную запись.
Последняя версия Azure CLI.
Кластер Службы Azure Kubernetes (AKS). Создание кластера AKS.
Разрешение с ролью администратора службы Azure Kubernetes 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», которое устанавливает поставщик Kubernetes для Конфигурации приложений Azure в АКС.

Например, установите самую новую версию поставщика Kubernetes для Azure App Configuration с помощью расширения Azure App Configuration в вашем кластере AKS.

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

Разверните шаблон Bicep с помощью az deployment group команды.

az deployment group create \
  --resource-group myResourceGroup \
  --template-file ./my-bicep-file-path.bicep \
  --parameters clusterName=myAKSCluster

Это важно

Расширение конфигурации приложений Azure AKS по умолчанию устанавливается в пространство имен azappconfig-system. Если у вас есть назначения политик Azure, которые проверяют или изменяют спецификации подов (например, встроенная политика "Кластеры Kubernetes должны отключать автоматическое подключение учетных данных API", что обеспечивается automountServiceAccountToken: false), исключите пространство имен azappconfig-system из этих политик, добавив его в список исключений пространств имен, чтобы расширение могло работать правильно. Не исключается, что модули pod расширения могут завершать проверку или отображаться несоответствующими требованиям.

Настройка автоматических обновлений

Если вы создаете расширение Конфигурация приложений Azure без указания версии, оно автоматически включается и настраивается для автоматического обновления своей минорной версии при новых релизах.

Вы можете отключить автоматическое обновление, указав --auto-upgrade-minor-version параметр и задав значение false.

Azure CLI
Bicep

--auto-upgrade-minor-version false

properties {
  autoUpgradeMinorVersion: false
}

Нацеливание на определенную версию

Тот же аргумент командной строки используется для установки определенной версии поставщика Kubernetes для Azure App Configuration или отката к предыдущей версии. Установите для --auto-upgrade-minor-version значение false, а для --version укажите версию поставщика Kubernetes для Конфигурации приложений Azure, которую вы хотите установить. 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.1.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.1.0'
  }
}

Разверните шаблон Bicep с помощью az deployment group команды.

az deployment group create \
  --resource-group myResourceGroup \
  --template-file ./my-bicep-file-path.bicep \
  --parameters clusterName=myAKSCluster

Версии расширения

Расширение Azure App Configuration поддерживает следующую версию поставщика Kubernetes для конфигурации приложений Azure:

2.1.0
2.0.0

Устранение неполадок при установке расширения

Если расширение не удается создать или обновить, попробуйте использовать предложения и решения в руководстве по устранению неполадок с расширением Конфигурация приложений Azure.

Устранение неполадок с провайдером Kubernetes в Azure App Configuration

Устраняйте неполадки Azure App Configuration в провайдере Kubernetes с помощью руководства по устранению неполадок.

Удаление расширения

Если необходимо удалить расширение и удалить поставщика Kubernetes Конфигураций приложений Azure из кластера AKS, можно использовать следующую команду:

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

Дальнейшие шаги

Дополнительные сведения о дополнительных параметрах и предпочтениях можно задать в расширении Конфигурация приложений Azure.
После успешной установки расширения Конфигурация приложений Azure в кластере AKS воспользуйтесь кратким руководством, чтобы узнать, как его использовать.
Посмотрите все поддерживаемые функции Провайдера конфигурации приложений Azure для Kubernetes.

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2025-10-30