Azure Kubernetes Service에 대한 Azure 앱 구성 확장

Azure App Configuration은 애플리케이션 설정 및 기능 플래그를 중앙에서 관리할 수 있는 서비스를 제공합니다. Azure App Configuration Kubernetes Provider는 Azure App Configuration에서 키-값, Key Vault 참조 및 기능 플래그를 가져와 Kubernetes ConfigMap 및 Secret로 빌드하는 Kubernetes 연산자입니다. AKS(Azure Kubernetes Service)용 Azure App Configuration 확장을 사용하면 ARM(Azure Resource Manager)을 통해 AKS 클러스터에 Azure App Configuration Kubernetes Provider를 설치하고 관리할 수 있습니다.

필수 구성 요소

• 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 클러스터에 확장 설치

AKS에 Azure App Configuration Kubernetes Provider를 설치하는 Azure App Configuration 확장을 만듭니다.

예를 들어, AKS 클러스터의 Azure App Configuration 확장을 통해 최신 버전의 Azure App Configuration Kubernetes Provider를 설치합니다.

Azure CLI

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

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

az deployment group 명령을 사용하여 Bicep 템플릿을 배포합니다.

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

자동 업데이트 구성

버전을 지정하지 않고 Azure App Configuration 확장을 만들면 --auto-upgrade-minor-version이(가) 자동으로 사용하도록 설정되어 Azure App Configuration 확장이 새 릴리스에서 부 버전을 자동으로 업데이트하도록 구성됩니다.

--auto-upgrade-minor-version 매개 변수를 지정하고 값을 false로 설정하여 자동 업데이트를 사용하지 않도록 설정할 수 있습니다.

Azure CLI

--auto-upgrade-minor-version false

Bicep

properties {
  autoUpgradeMinorVersion: false
}

특정 버전 대상 지정

특정 버전의 Azure App Configuration Kubernetes Provider를 설치하거나 이전 버전으로 롤백하는 데 동일한 명령줄 인수가 사용됩니다. --auto-upgrade-minor-version을 false로 설정하고 --version을 설치하려는 Azure App Configuration Kubernetes Provider 버전으로 설정합니다. 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
    --version 2.1.0

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'
    version: '2.1.0'
  }
}

az deployment group 명령을 사용하여 Bicep 템플릿을 배포합니다.

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

확장 버전

Azure App Configuration 확장은 다음 버전의 Azure App Configuration Kubernetes Provider를 지원합니다.

• 2.1.0
• 2.0.0

확장 설치 오류 문제 해결

확장을 만들거나 업데이트하지 못한 경우 Azure App Configuration 확장 문제 해결 가이드의 제안 및 솔루션을 시도해 보세요.

Azure App Configuration Kubernetes 공급자 문제 해결

문제 해결 가이드를 통해 Azure App Configuration Kubernetes 공급자 오류를 해결합니다.

확장 삭제

확장을 삭제하고 AKS 클러스터에서 Azure App Configuration Kubernetes Provider를 제거해야 하는 경우 다음 명령을 사용할 수 있습니다.

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

다음 단계

• Azure App Configuration 확장에서 설정할 수 있는 추가 설정 및 기본 설정에 대해 자세히 알아봅니다.
• AKS 클러스터에 Azure App Configuration 확장을 성공적으로 설치한 후 빠른 시작을 시도하여 사용 방법을 알아봅니다.
• Azure App Configuration Kubernetes Provider에서 지원되는 모든 기능을 확인합니다.