مشاركة عبر

التشغيل السريع: إنشاء مخزن Azure App Configuration باستخدام Bicep

  • مقالة

يصف هذا التشغيل السريع كيف يمكنك استخدام Bicep من أجل:

  • توزيع مخزن App Configuration.
  • إنشاء قيم أساسية في مخزن App Configuration.
  • قراءة القيم الأساسية في مخزن App Configuration.

Bicep هي لغة المجال المخصصة (DSL) التي تستخدم بناء الجملة التعريفي لتوزيع موارد Azure. توفر بناء جملة مختصر، وسلامة موثوقة من النوع، ودعمًا لإعادة استخدام التعليمة البرمجية. تقدم Bicep أفضل تجربة تأليف لحلول البنية الأساسية باعتبارها تعليمة برمجية في Azure.

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

في حال لم يكن لديك اشتراك Azure، فأنشئ حساباً مجانيّاً قبل البدء.

التصريح

تتطلب إدارة مورد Azure App Configuration باستخدام ملف Bicep دور Azure Resource Manager، مثل المساهم أو المالك. يتطلب الوصول إلى بيانات Azure App Configuration (قيم المفاتيح واللقطات) دور Azure Resource Manager ودور وحدة بيانات Azure App Configuration إضافية عند تعيين وضع مصادقة ARM لمخزن التكوين على وضع مصادقة ARM التمريري.

هام

يتطلب تكوين وضع مصادقة ARM إصدار واجهة برمجة تطبيقات مستوى التحكم في تكوين التطبيق أو إصدار 2023-08-01-preview أحدث.

مراجعة ملف Bicep

ملف Bicep المستخدم في هذا التشغيل السريع مأخوذ من قوالب التشغيل السريع لـ Azure.

إشعار

تستخدم ملفات Bicep نفس المحرك الأساسي مثل قوالب ARM. تنطبق هنا جميع النصائح والملاحظات والمعلومات المهمة الموجودة في قالب ARM تشغيل سريع. يوصى بالرجوع إلى هذه المعلومات عند العمل مع ملفات Bicep.

@description('Specifies the name of the App Configuration store.')
param configStoreName string

@description('Specifies the Azure location where the app configuration store should be created.')
param location string = resourceGroup().location

@description('Specifies the names of the key-value resources. The name is a combination of key and label with $ as delimiter. The label is optional.')
param keyValueNames array = [
  'myKey'
  'myKey$myLabel'
]

@description('Specifies the values of the key-value resources. It\'s optional')
param keyValueValues array = [
  'Key-value without label'
  'Key-value with label'
]

@description('Specifies the content type of the key-value resources. For feature flag, the value should be application/vnd.microsoft.appconfig.ff+json;charset=utf-8. For Key Value reference, the value should be application/vnd.microsoft.appconfig.keyvaultref+json;charset=utf-8. Otherwise, it\'s optional.')
param contentType string = 'the-content-type'

@description('Adds tags for the key-value resources. It\'s optional')
param tags object = {
  tag1: 'tag-value-1'
  tag2: 'tag-value-2'
}

resource configStore 'Microsoft.AppConfiguration/configurationStores@2021-10-01-preview' = {
  name: configStoreName
  location: location
  sku: {
    name: 'standard'
  }
}

resource configStoreKeyValue 'Microsoft.AppConfiguration/configurationStores/keyValues@2021-10-01-preview' = [for (item, i) in keyValueNames: {
  parent: configStore
  name: item
  properties: {
    value: keyValueValues[i]
    contentType: contentType
    tags: tags
  }
}]

output reference_key_value_value string = configStoreKeyValue[0].properties.value
output reference_key_value_object object = {
  name: configStoreKeyValue[1].name
  properties: configStoreKeyValue[1].properties
}

تم تحديد موردين Azure في ملف Bicep:

باستخدام ملف Bicep هذا، نقوم بإنشاء مفتاح واحد بقيمتين مختلفتين، إحداهما لها تسمية فريدة.

نشر ملف Bicep

  1. احفظ ملف Bicep بالاسم main.bicep على الكمبيوتر المحلي الخاص بك.

  2. بادر بتوزيع ملف Bicep باستخدام Azure CLI أو Azure PowerShell.

    az group create --name exampleRG --location eastus
az deployment group create --resource-group exampleRG --template-file main.bicep --parameters configStoreName=<store-name>

    إشعار

    استبدل <store-name> باسم مخزن App Configuration.

    عند الانتهاء من عملية النشر، يجب أن ترى رسالة تشير إلى نجاح عملية النشر.

مراجعة الموارد الموزعة

استخدم Azure CLI أو Azure PowerShell لسرد الموارد المنشورة في مجموعة الموارد.

az resource list --resource-group exampleRG

يمكنك أيضاً استخدام مدخل Microsoft Azure لسرد الموارد:

  1. قم بتسجيل الدخول إلى بوابة Azure.
  2. في مربع البحث، أدخل App Configuration، ثم حدد App Configuration من القائمة.
  3. حدد مورد"App Configuration" الذي تم إنشاؤه حديثاً.
  4. ضمن Operations، حدد Configuration explorer.
  5. تحقق من وجود قيمتين أساسيتين.

تنظيف الموارد

عندما لم تعد هناك حاجة، استخدم Azure CLI أو Azure PowerShell لحذف مجموعة الموارد ومواردها.

az group delete --name exampleRG

يمكنك أيضاً استخدام مدخل Microsoft Azure لحذف مجموعة الموارد:

  1. انتقل إلى مجموعة الموارد.
  2. حدد Delete resource group.
  3. ستظهر علامة تبويب. أدخل اسم مجموعة الموارد، ثم قم بتحديد Delete.

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

لمعرفة المزيد حول إضافة علامة الميزة ومرجع Key Vault إلى مخزن App Configuration، تحقق من أمثلة نماذج ARM.