Azure Kubernetes Service için Azure Uygulaması Yapılandırma uzantısı

Azure Uygulaması Yapılandırması, uygulama ayarlarını ve özellik bayraklarını merkezi olarak yönetmek için bir hizmet sağlar. Azure Uygulaması Yapılandırması Kubernetes Sağlayıcısı, Azure Uygulaması Yapılandırmasından anahtar-değerleri, Key Vault başvurularını ve özellik bayraklarını alan ve bunları Kubernetes ConfigMaps ve Gizli Diziler içine derleyen bir Kubernetes operatörüdür. Azure Kubernetes Service (AKS) için Azure Uygulaması Yapılandırma uzantısı, Azure Resource Manager (ARM) aracılığıyla AKS kümenize Azure Uygulaması Yapılandırma Kubernetes Sağlayıcısı'nı yüklemenize ve yönetmenize olanak tanır.

Önkoşullar

• Azure aboneliği. Yok mu? Ücretsiz bir hesap oluşturun.
• Azure CLI'nın en son sürümünü yükleyin.
• Henüz bir kümeniz yoksa aks kümesi oluşturmanız gerekir.
• Azure Kubernetes Service RBAC Yönetici rolünüz olduğundan emin olun

Küme uzantıları için Azure CLI uzantısını ayarlama

k8s-extension Aşağıdaki komutları çalıştırarak Azure CLI uzantısını yükleyin:

az extension add --name k8s-extension

k8s-extension Uzantı zaten yüklüyse, aşağıdaki komutu kullanarak uzantıyı en son sürüme güncelleştirebilirsiniz:

az extension update --name k8s-extension

Kaynak sağlayıcısını KubernetesConfiguration kaydetme

Daha önce küme uzantılarını kullanmadıysanız kaynak sağlayıcısını aboneliğinize kaydetmeniz gerekebilir. Aşağıdaki örnekte gösterildiği gibi az provider list komutunu kullanarak sağlayıcı kaydının durumunu de kontrol edebilirsiniz:

az provider list --query "[?namespace=='Microsoft.KubernetesConfiguration']" -o table

Microsoft.KubernetesConfiguration sağlayıcısı, aşağıdaki örnek çıktıda gösterildiği gibi Kayıtlı olarak bildirmelidir:

Namespace                          RegistrationState    RegistrationPolicy
---------------------------------  -------------------  --------------------
Microsoft.KubernetesConfiguration  Registered           RegistrationRequired

Sağlayıcı NotRegistered olarak görünüyorsa, aşağıdaki örnekte gösterildiği gibi az provider register komutunu kullanarak sağlayıcıyı kaydedin:

az provider register --namespace Microsoft.KubernetesConfiguration

Uzantıyı AKS kümenize yükleme

AKS'nize Azure Uygulaması Yapılandırma Kubernetes Sağlayıcısı'nı yükleyen Azure Uygulaması Yapılandırma uzantısını oluşturun.

Örneğin, AKS kümenizdeki Azure Uygulaması Yapılandırma uzantısı aracılığıyla Azure Uygulaması Yapılandırma Kubernetes Sağlayıcısı'nın en son sürümünü yükleyin:

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

Otomatik güncelleştirmeleri yapılandırın

Azure Uygulaması Yapılandırma uzantısını bir sürüm belirtmeden oluşturursanız, --auto-upgrade-minor-version Azure Uygulaması Yapılandırma uzantısını yeni sürümlerde ikincil sürümünü otomatik olarak güncelleştirecek şekilde yapılandırarak otomatik olarak etkinleştirilir.

parametresini belirtip --auto-upgrade-minor-version değerini falseolarak ayarlayarak otomatik güncelleştirmeyi devre dışı bırakabilirsiniz.

--auto-upgrade-minor-version false

properties {
  autoUpgradeMinorVersion: false
}

Belirli bir sürümü hedefleme

Aynı komut satırı bağımsız değişkeni, Azure Uygulaması Yapılandırma Kubernetes Sağlayıcısı'nın belirli bir sürümünü yüklemek veya önceki bir sürüme geri dönmek için kullanılır. false yüklemek istediğiniz Azure Uygulaması Yapılandırma Kubernetes Sağlayıcısı'nın sürümüne ve --version sürümüne ayarlayın--auto-upgrade-minor-version. version Parametresi atlanırsa uzantı en son sürümü yükler.

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

Uzantı sürümleri

Azure Uygulaması Yapılandırma uzantısı, Azure Uygulaması Yapılandırma Kubernetes Sağlayıcısı'nın aşağıdaki sürümünü destekler:

• 2.1.0
• 2.0.0

Uzantı yükleme hatalarını giderme

Uzantı oluşturulamıyor veya güncelleştirilemiyorsa, Azure Uygulaması Yapılandırma uzantısı sorun giderme kılavuzunda önerileri ve çözümleri deneyin.

Azure Uygulaması Yapılandırması Kubernetes Sağlayıcısı sorunlarını giderme

Sorun giderme kılavuzu aracılığıyla Azure Uygulaması Yapılandırma Kubernetes Sağlayıcısı hatalarını giderin.

Uzantıyı silme

Uzantıyı silmeniz ve AKS kümenizden Azure Uygulaması Yapılandırma Kubernetes Sağlayıcısını kaldırmanız gerekiyorsa aşağıdaki komutu kullanabilirsiniz:

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

Sonraki Adımlar

• Azure Uygulaması Yapılandırma uzantısında ayarlayabileceğiniz ek ayarlar ve tercihler hakkında daha fazla bilgi edinin.
• AKS kümenize Azure Uygulaması Yapılandırma uzantısını başarıyla yükledikten sonra, nasıl kullanacağınızı öğrenmek için hızlı başlangıcı deneyin.
• Azure Uygulaması Yapılandırma Kubernetes Sağlayıcısı'nın tüm desteklenen özelliklerine bakın.