расширение Конфигурация приложений Azure для Служба Azure Kubernetes

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

Необходимые компоненты

• Подписка Azure. У меня нет? Создайте бесплатную учетную запись.
• Установите последнюю версию Azure CLI.
• Создайте кластер AKS, если у вас еще нет его.
• Убедитесь, что у вас есть роль администратора RBAC Служба Azure Kubernetes

Настройка расширения 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, которое устанавливает Конфигурация приложений Azure поставщик Kubernetes в AKS.

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

az k8s-extension create --cluster-type managedClusters \
    --cluster-name myAKSCluster \
    --resource-group myResourceGroup \
    --name appconfigurationkubernetesprovider \
    --extension-type Microsoft.AppConfiguration

@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 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.

--auto-upgrade-minor-version false

properties {
  autoUpgradeMinorVersion: false
}

Назначение определенной версии

Тот же аргумент командной строки используется для установки определенной версии Конфигурация приложений Azure поставщика Kubernetes или отката к предыдущей версии. false Установите и --version установите --auto-upgrade-minor-version версию Конфигурация приложений Azure поставщика Kubernetes, который вы хотите установить. version Если параметр опущен, расширение устанавливает последнюю версию.

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

@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 create \
  --resource-group myResourceGroup \
  --template-file ./my-bicep-file-path.bicep \
  --parameters clusterName=myAKSCluster

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

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

• 2.1.0
• 2.0.0

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

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

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

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

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

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

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

Next Steps

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