ملحق Azure App Configuration لخدمة Azure Kubernetes

يوفر تكوين Azure App خدمة لإدارة إعدادات التطبيق وعلامات الميزات مركزياً. Azure App Configuration Kubernetes Provider هو عامل تشغيل Kubernetes يحصل على قيم المفاتيح ومراجع Key Vault وعلامات الميزات من تكوين تطبيق Azure وينشئها في Kubernetes ConfigMaps والأسرار. يسمح لك ملحق Azure App Configuration لخدمة Azure Kubernetes (AKS) بتثبيت موفر Kubernetes لتكوين تطبيقات Azure وإدارته على نظام مجموعة AKS عبر Azure Resource Manager (ARM).

المتطلبات الأساسية

• اشتراك Azure. ليس لديك واحد؟ يمكنك إنشاء حساب مجاني.
• قم بتثبيت أحدث إصدار من Azure CLI.
• إذا لم يكن لديك واحدة بالفعل، فإنك تحتاج إلى إنشاء مجموعة AKS.
• تأكد من أن لديك دور مسؤول Azure Kubernetes Service RBAC

إعداد ملحق البرنامج CLI Azure لملحقات مجموعة أجهزة كمبيوتر

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.ContainerInstance الإبلاغ على أنه مسجل، كما هو موضح في ناتج المثال التالي:

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

إذا ظهر الموفر كـ NotRegistered فقم بتسجيل الموفر باستخدام الأمر az provider register كما هو موضح في المثال التالي:

az provider register --namespace Microsoft.KubernetesConfiguration

تثبيت الملحق على نظام مجموعة AKS

إنشاء ملحق Azure App Configuration، الذي يقوم بتثبيت Azure App Configuration Kubernetes Provider على AKS الخاص بك.

على سبيل المثال، قم بتثبيت أحدث إصدار من Azure App Configuration Kubernetes Provider عبر ملحق Azure App Configuration على نظام مجموعة AKS:

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

انشر قالب Bicep باستخدام az deployment group الأمر .

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

انشر قالب Bicep باستخدام az deployment group الأمر .

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

استكشاف أخطاء تثبيت الملحق وإصلاحها

إذا فشل الملحق في الإنشاء أو التحديث، فجرب الاقتراحات والحلول في دليل استكشاف الأخطاء وإصلاحها لملحق Azure App Configuration.

استكشاف أخطاء موفر Kubernetes لتكوين تطبيق Azure وإصلاحها

استكشاف أخطاء موفر Kubernetes لتكوين تطبيق Azure وإصلاحها عبر دليل استكشاف الأخطاء وإصلاحها.

قم بحذف الملحق

إذا كنت بحاجة إلى حذف الملحق وإزالة Azure App Configuration Kubernetes Provider من نظام مجموعة AKS، يمكنك استخدام الأمر التالي:

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

الخطوات التالية

• تعرف على المزيد حول الإعدادات والتفضيلات الإضافية التي يمكنك تعيينها على ملحق Azure App Configuration.
• بمجرد تثبيت ملحق Azure App Configuration بنجاح في مجموعة AKS، حاول التشغيل السريع لمعرفة كيفية استخدامه.
• راجع جميع الميزات المدعومة لموفر Kubernetes لتكوين تطبيق Azure.