استيراد بيانات التكوين أو تصديرها

هل هذه الصفحة مفيدة؟

هل لديك ملاحظات إضافية؟

سيتم إرسال الملاحظات إلى Microsoft: بالضغط على الزر «إرسال»، سيتم استخدام ملاحظاتك لتحسين منتجات Microsoft وخدماتها. نهج الخصوصية.

يدعم تكوين تطبيق Azure عمليات استيراد البيانات وتصديرها. استخدم هذه العمليات للعمل مع بيانات التكوين بشكل مجمع وتبادل البيانات بين متجر تكوين التطبيقات ومشروع التعليمات البرمجية. على سبيل المثال، يمكنك إعداد متجر تكوين تطبيقات واحد للاختبار وآخر للإنتاج. يمكنك نسخ إعدادات التطبيق بينهما بحيث لا تضطر إلى إدخال البيانات مرتين.

توفر هذه المقالة دليلا لاستيراد البيانات وتصديرها باستخدام "تكوين التطبيق". إذا كنت ترغب في إعداد مزامنة مستمرة مع GitHub الريبو، فألق نظرة على مهام إجراءات GitHubوAzure Pipeline.

يمكنك استيراد البيانات أو تصديرها باستخدام مدخل Azure أو Azure CLI.

استيراد البيانات

يجلب الاستيراد بيانات التكوين إلى متجر تكوين التطبيقات من مصدر موجود. استخدم وظيفة الاستيراد لترحيل البيانات إلى مخزن تكوين التطبيق أو تجميع البيانات من مصادر متعددة. يدعم تكوين التطبيق الاستيراد من متجر آخر لتكوين التطبيقات أو مورد خدمة التطبيق أو ملف تكوين في JSON أو YAML أو .properties.

المدخل

من مدخل Azure، اتبع الخطوات التالية:

1. استعرض للوصول إلى متجر تكوين التطبيق، وحدد استيراد/تصدير من قائمة العمليات .

   

2. ضمن علامة التبويب استيراد ، حدد ملف التكوين ضمن خدمة المصدر. الخيارات الأخرى هي تكوين التطبيق وخدمات التطبيق.

3. املأ النموذج بالمعلمات التالية:

   المعلمة	الوصف	أمثلة
   للغة	اختر لغة الملف الذي تقوم باستيراده بين .NET وJava (الربيع) وأخرى.	.NET
   نوع الملف	حدد نوع الملف الذي تقوم باستيراده بين YAML أو الخصائص أو JSON.	JSON

4. حدد أيقونة المجلد ، واستعرض وصولا إلى الملف المراد استيراده.

5. املأ الجزء التالي من النموذج:

   المعلمة	الوصف	مثال
   فاصل	الفاصل هو الحرف الذي تم تحليله في ملف التكوين المستورد لفصل القيم الرئيسية التي ستتم إضافتها إلى مخزن التكوين الخاص بك. حدد أحد الخيارات التالية: ., ,, , , ;,/:-.	:
   بادئة	‏‏اختياري. بادئة المفتاح هي الجزء الأول من المفتاح. يمكن استخدام البادئات لإدارة مجموعات المفاتيح في مخزن التكوين.	TestApp:الإعدادات:لون الخلفية
   تسمية	‏‏اختياري. حدد تصنيفا موجودا أو أدخل تصنيفا جديدا سيتم تعيينه للقيم الرئيسية التي تم استيرادها.	همز
   نوع المحتوى	‏‏اختياري. حدد ما إذا كان الملف الذي تقوم باستيراده مرجعا Key Vault أو ملف JSON. لمزيد من المعلومات حول مراجع Key Vault، انتقل إلى استخدام مراجع Key Vault في تطبيق ASP.NET Core.	JSON (تطبيق/json)

6. حدد تطبيق لمتابعة الاستيراد.

Azure CLI

استخدم Azure CLI كما هو موضح أدناه لاستيراد بيانات تكوين التطبيق. إذا لم يكن لديك Azure CLI مثبتا محليا، فيمكنك اختياريا استخدام Azure Cloud Shell. حدد مصدر البيانات: appconfig، appservice أو file. اختياريا تحديد تسمية مصدر مع وتسمية لتطبيقها مع --src-label--label.

استيراد كافة المفاتيح وعلامات المعالم من ملف وتطبيق تسمية الاختبار.

az appconfig kv import --name <your-app-config-store-name> --label test --source file --path D:/abc.json --format json

استيراد كافة المفاتيح مع اختبار التسمية وتطبيق تسمية test2.

az appconfig kv import --name <your-app-config-store-name> --source appconfig --src-label test --label test2 --src-name <another-app-config-store-name>

استيراد جميع المفاتيح وتطبيق تسمية فارغة من تطبيق App Service.

لاستخدام --appservice-account معرف ARM ل AppService أو استخدام اسم AppService، على افتراض أنه في نفس مجموعة الاشتراك والموارد مثل تكوين التطبيق.

az appconfig kv import --name <your-app-config-store-name> --source appservice --appservice-account <your-app-service>

لمزيد من التفاصيل والأمثلة، انتقل إلى az appconfig kv import.

تصدير البيانات

تصدير بيانات تكوين عمليات الكتابة المخزنة في "تكوين التطبيق" إلى وجهة أخرى. استخدم وظيفة التصدير، على سبيل المثال، لحفظ البيانات من مخزن تكوين التطبيقات إلى ملف يمكن تضمينه في التعليمات البرمجية للتطبيق أثناء النشر. يمكنك تصدير البيانات من متجر تكوين التطبيقات أو مورد خدمة التطبيقات أو ملف تكوين في JSON أو YAML أو .properties.

المدخل

من مدخل Azure، اتبع الخطوات التالية:

1. استعرض للوصول إلى متجر تكوين التطبيقات، وحدد استيراد/تصدير.

2. في علامة التبويب تصدير، حدد ملفتكوين الخدمة> الهدف.

3. املأ النموذج بالمعلمات التالية:

   المعلمة	الوصف	مثال
   بادئة	‏‏اختياري. بادئة المفتاح هي الجزء الأول من المفتاح. أدخل بادئة لتقييد التصدير إلى القيم الرئيسية باستخدام البادئة المحددة.	TestApp:الإعدادات:لون الخلفية
   من التسمية	‏‏اختياري. حدد تصنيفا موجودا لتقييد التصدير إلى القيم الرئيسية باستخدام تصنيف معين. إذا لم تحدد تصنيفا، تصدير القيم الرئيسية التي لا تحتوي على تصنيف فقط. راجع الملاحظة أدناه.	همز
   في وقت محدد	‏‏اختياري. املأ لتصدير القيم الرئيسية من نقطة زمنية محددة.	28/01/2021 12:00:00 ص
   نوع الملف	حدد نوع الملف الذي تقوم باستيراده بين YAML أو الخصائص أو JSON.	JSON
   فاصل	الفاصل هو الحرف الذي سيتم استخدامه في ملف التكوين لفصل قيم المفاتيح المصدرة عن بعضها البعض. حدد أحد الخيارات التالية: ., ,, , , ;,/:-.	;

   هام

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

4. حدد تصدير لإنهاء التصدير.

   

Azure CLI

استخدم Azure CLI كما هو موضح أدناه لتصدير التكوينات من تكوين التطبيق إلى مكان آخر. إذا لم يكن لديك Azure CLI مثبتا محليا، فيمكنك اختياريا استخدام Azure Cloud Shell. حدد وجهة البيانات: appconfig، appservice أو file. حدد تسمية للبيانات التي تريد تصديرها باستخدام --label البيانات أو تصديرها بدون تسمية عن طريق عدم إدخال تصنيف.

هام

إذا كانت المفاتيح التي تريد تصديرها تحتوي على تسميات، فحدد التسميات المقابلة. إذا لم تحدد تصنيفا، تصدير المفاتيح التي لا تحتوي على تسميات فقط.

تصدير جميع المفاتيح وعلامات المعالم مع اختبار التسمية إلى ملف json.

az appconfig kv export --name <your-app-config-store-name> --label test --destination file --path D:/abc.json --format json

تصدير جميع المفاتيح ذات التسمية الخالية باستثناء علامات المعالم إلى ملف json.

az appconfig kv export --name <your-app-config-store-name> --destination file --path D:/abc.json --format json --skip-features

تصدير جميع المفاتيح وعلامات الميزات مع جميع التصنيفات إلى تكوين تطبيق آخر.

az appconfig kv export --name <your-app-config-store-name> --destination appconfig --dest-name <another-app-config-store-name> --key * --label * --preserve-labels

تصدير جميع المفاتيح وعلامات المعالم مع جميع التصنيفات إلى تكوين تطبيق آخر والكتابة فوق تسميات الوجهة.

az appconfig kv export --name <your-app-config-store-name> --destination appconfig --dest-name <another-app-config-store-name> --key * --label * --dest-label ExportedKeys

لمزيد من التفاصيل والأمثلة، انتقل إلى az appconfig kv export.

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

إنشاء تطبيق ويب الخاص بـ ASP.NET Core