Ekstensi Azure App Configuration untuk Azure Kubernetes Service

Azure App Configuration menyediakan layanan untuk mengelola pengaturan aplikasi dan bendera fitur secara terpusat. Penyedia Kubernetes Azure App Configuration adalah operator Kubernetes yang mendapatkan nilai kunci, referensi Key Vault, dan bendera fitur dari Azure App Configuration dan membangunnya ke dalam ConfigMaps dan Secrets Kubernetes. Ekstensi Azure App Configuration untuk Azure Kubernetes Service (AKS) memungkinkan Anda menginstal dan mengelola Penyedia Kubernetes Azure App Configuration pada kluster AKS melalui Azure Resource Manager (ARM).

Prasyarat

• Langganan Azure. Tidak punya satu? Buat akun gratis.
• Instal versi terbaru Azure CLI.
• Jika Anda belum memilikinya, Anda perlu membuat kluster AKS.
• Pastikan Anda memiliki peran Admin RBAC Azure Kubernetes Service

Menyiapkan ekstensi Azure CLI untuk ekstensi kluster

k8s-extension Instal ekstensi Azure CLI dengan menjalankan perintah berikut:

az extension add --name k8s-extension

Jika ekstensi k8s-extension sudah diinstal, Anda dapat memperbaruinya ke versi terbaru menggunakan perintah berikut:

az extension update --name k8s-extension

Mendaftarkan KubernetesConfiguration penyedia sumber daya

Jika sebelumnya Anda belum menggunakan ekstensi kluster, Anda mungkin perlu mendaftarkan penyedia sumber daya dengan langganan Anda. Anda dapat memeriksa status pendaftaran penyedia menggunakan perintah az provider list , seperti yang ditunjukkan dalam contoh berikut:

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

Penyedia Microsoft.KubernetesConfiguration harus dalam status Terdaftar, seperti yang ditunjukkan dalam contoh output berikut:

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

Jika penyedia menunjukkan sebagai TidakTerdaftar, daftarkan penyedia menggunakan register penyedia az seperti yang ditunjukkan dalam contoh berikut:

az provider register --namespace Microsoft.KubernetesConfiguration

Menginstal ekstensi pada kluster AKS Anda

Buat ekstensi Azure App Configuration, yang menginstal Penyedia Kubernetes Azure App Configuration di AKS Anda.

Misalnya, instal versi terbaru Penyedia Kubernetes Azure App Configuration melalui ekstensi Azure App Configuration pada kluster AKS Anda:

Azure CLI

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

Bicep

Buat templat Bicep menggunakan contoh berikut.

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

Sebarkan templat Bicep menggunakan az deployment group perintah .

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

Mengonfigurasi pembaruan otomatis

Jika Anda membuat ekstensi Azure App Configuration tanpa menentukan versi, --auto-upgrade-minor-version diaktifkan secara otomatis, mengonfigurasi ekstensi Azure App Configuration untuk memperbarui versi minornya secara otomatis pada rilis baru.

Anda dapat menonaktifkan pembaruan otomatis dengan menentukan --auto-upgrade-minor-version parameter dan mengatur nilai ke false.

Azure CLI

--auto-upgrade-minor-version false

Bicep

properties {
  autoUpgradeMinorVersion: false
}

Menargetkan versi tertentu

Argumen baris perintah yang sama digunakan untuk menginstal versi tertentu dari Penyedia Kubernetes Azure App Configuration atau digulirkan kembali ke versi sebelumnya. Atur --auto-upgrade-minor-version ke false dan --version ke versi Penyedia Kubernetes Azure App Configuration yang ingin Anda instal. Jika parameter dihilangkan version , ekstensi akan menginstal versi terbaru.

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

Bicep

Buat templat Bicep menggunakan contoh berikut.

@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.0.0'
  }
}

Sebarkan templat Bicep menggunakan az deployment group perintah .

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

Versi ekstensi

Ekstensi Azure App Configuration mendukung versi Penyedia Kubernetes Azure App Configuration berikut:

• 2.0.0

Memecahkan masalah kesalahan penginstalan ekstensi

Jika ekstensi gagal membuat atau memperbarui, coba saran dan solusi di panduan pemecahan masalah ekstensi Azure App Configuration.

Memecahkan masalah Penyedia Kubernetes Azure App Configuration

Memecahkan masalah kesalahan Penyedia Kubernetes Azure App Configuration melalui panduan pemecahan masalah.

Menghapus ekstensi

Jika Anda perlu menghapus ekstensi dan menghapus Penyedia Kubernetes Azure App Configuration dari kluster AKS, Anda dapat menggunakan perintah berikut:

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

Langkah berikutnya

• Pelajari selengkapnya tentang pengaturan dan preferensi tambahan yang dapat Anda atur pada ekstensi Azure App Configuration.
• Setelah Anda berhasil menginstal ekstensi Azure App Configuration di kluster AKS Anda, coba mulai cepat untuk mempelajari cara menggunakannya.
• Lihat semua fitur penyedia Azure App Configuration Kubernetes yang didukung.