расширение Конфигурация приложений 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:

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

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

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 или отката к предыдущей версии. false Установите и --version установите --auto-upgrade-minor-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 \
    --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'
  }
}

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

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

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

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

• 2.0.0-preview

Регионы

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

Восточная часть США 2 EUAP, Центральная Канада, западная часть США, центральная индия, восточная часть США, восточная часть США 2, Северная Европа, Южная Европа, Восточная Австралия, Центральная ЧАСТЬ США, Западная часть США 2, Западная часть США 2, Западная часть США 3

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

Если расширение не удается создать или обновить, попробуйте использовать предложения и решения в руководстве по устранению неполадок с расширением Конфигурация приложений 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.