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

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

توفر هذه المقالة دليلا لاستيراد البيانات وتصديرها باستخدام مدخل Microsoft Azure أو Azure CLI. إذا كنت قد اعتمدت التكوين كرمز وقمت بإدارة التكوينات الخاصة بك في GitHub أو Azure Devops، يمكنك إعداد استيراد ملف التكوين المستمر باستخدام إجراءات GitHub أو استخدام مهمة دفع البنية الأساسية لبرنامج ربط العمليات التجارية Azure.

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

الاستيراد يجلب بيانات التكوين إلى مخزن App Configuration من مصدر موجود. استخدم دالة الاستيراد لترحيل البيانات إلى مخزن App Configuration، أو تجميع البيانات من مصادر متعددة.

يوضح هذا الدليل كيفية استيراد بيانات تكوين التطبيق:

• من ملف تكوين في Json أو Yaml أو Properties
• من مخزن تكوين التطبيق
• من خدمة التطبيق من Azure

استيراد البيانات من ملف التكوين

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

إشعار

استيراد علامات الميزات من ملف غير معتمد. إذا كان ملف التكوين يحتوي على علامات الميزات، فسيتم استيرادها كقيم مفاتيح عادية تلقائيا.

بوابة

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

1. استعرض للوصول إلى مخزن App Configuration، وحدد Import/export من قائمة Operations.

   

2. في علامة التبويب Import، حدد Configuration file ضمن Source service.

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

   المعلمة	‏‏الوصف‬	مثال
   للغة	اختر لغة الملف الذي تقوم باستيراده بين .NET وJava (Spring) وOther.	NET.
   نوع الملف	حدد نوع الملف الذي تستورده بين Yaml وخصائص وJson.	Json

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

   إشعار

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

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

   المعلمة	‏‏الوصف‬	مثال
   فاصل	الفاصل هو الحرف الذي تم تحليله في ملف التكوين المستورد لفصل قيم المفاتيح التي ستتم إضافتها إلى مخزن التكوين الخاص بك. حدد أحد الخيارات التالية: .، ،، :، ؛ ، /، -_، —.	;
   البادئة	اختياري. بادئة المفتاح هي الجزء الأول من خاصية "المفتاح" لقيمة المفتاح. يمكن استخدام البادئات لإدارة مجموعات من قيم المفاتيح في مخزن التكوين. سيتم إلحاق البادئة المدخلة بخاصية "المفتاح" الأمامية لكل قيمة مفتاح تقوم باستيرادها من هذا الملف.	TestApp:
   Label	اختياري. حدد تسمية موجودة أو أدخل تسمية جديدة سيتم تعيينها إلى قيم المفاتيح المستوردة.	همز
   نوع المحتوى	اختياري. الإشارة إلى ما إذا كنت تقوم باستيراد ملف JSON أو مراجع Key Vault. لمزيد من المعلومات حول مراجع Key Vault، انتقل إلى Use Key Vault references in an ASP.NET Core app.	JSON (application/json)

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

لقد قمت باستيراد قيم المفاتيح من ملف JSON، وقمت بتعيين التسمية لهم "prod" والبادئة "TestApp". يتم استخدام الفاصل ":" ويتم تعيين نوع المحتوى لكافة قيم المفاتيح التي قمت باستيرادها على أنها "JSON".

Azure CLI

من Azure CLI، اتبع الخطوات أدناه. إذا لم يكن Azure CLI مثبتاً لديك بالفعل، يمكنك، اختيارياً، استخدام Azure Cloud Shell.

1. أدخل أمر الاستيراد az appconfig kv import وأضف المعلمات التالية:

   المعلمة	‏‏الوصف‬	مثال
   --name	أدخل اسم مخزن تكوين التطبيق الذي تريد استيراد البيانات إليه.	my-app-config-store
   --source	أدخل file للإشارة إلى أنك تقوم باستيراد بيانات تكوين التطبيق من ملف.	file
   --path	أدخل المسار المحلي إلى الملف الذي يحتوي على البيانات التي تريد استيرادها.	C:/Users/john/Downloads/data.json
   --format	أدخل yaml أو الخصائص أو json للإشارة إلى تنسيق الملف الذي تستورده.	json

2. إضافة المعلمات التالية اختياريا أيضا:

   المعلمة	‏‏الوصف‬	مثال
   --separator	اختياري. الفاصل هو المحدد لتسطيح قيم المفاتيح إلى Json/Yaml. وهو مطلوب لتصدير البنية الهرمية وسيتم تجاهله لملفات الخصائص وعلامات الميزات. اختر أحد الخيارات التالية: .، ,، :، ;، /، -، _، —.	;
   --prefix	اختياري. بادئة المفتاح هي الجزء الأول من المفتاح. يمكن استخدام البادئات لإدارة مجموعات من قيم المفاتيح في مخزن التكوين. سيتم إلحاق هذه البادئة بواجهة خاصية "المفتاح" لكل قيمة مفتاح مستوردة.	TestApp:
   --label	اختياري. أدخل تسمية سيتم تعيينها إلى قيم المفاتيح المستوردة.	prod
   --content-type	اختياري. أدخل appconfig/kvset أو application/json لذكر أن المحتوى المستورد يتكون من مرجع Key Vault أو ملف JSON.	application/json

   مثال: استيراد كافة قيم المفاتيح وعلامات الميزات من ملف JSON، وتطبيق التسمية "prod"، وإلحاق البادئة "TestApp". أضف نوع المحتوى "application/json".

   az appconfig kv import --name my-app-config-store --source file --path D:/abc.json --format json --separator ; --prefix TestApp: --label prod --content-type application/json
   

3. يعرض سطر الأوامر قائمة بالتغييرات القادمة. تأكد من الاستيراد عن طريق تحديد y.

   

قمت باستيراد قيم المفاتيح من ملف JSON، وقمت بتعيين التسمية لهم "prod" والبادئة "TestApp:". يتم استخدام الفاصل ";" ويتم تعيين نوع المحتوى لكافة قيم المفاتيح التي قمت باستيرادها على أنها "JSON".

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

استيراد البيانات من مخزن تكوين التطبيق

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

اتبع الخطوات أدناه لاستيراد قيم المفاتيح وعلامات الميزات من مخزن تكوين التطبيق من Azure.

بوابة

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

1. استعرض للوصول إلى مخزن App Configuration، وحدد Import/export من قائمة Operations.

   

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

3. حدد حدد مورد، واملأ النموذج بالمعلمات التالية، وحدد تطبيق:

   المعلمة	‏‏الوصف‬	مثال
   الاشتراك	يتم تحديد اشتراكك الحالي بشكل افتراضي.	اشتراكي
   مجموعة الموارد	حدد مجموعة موارد تحتوي على مخزن تكوين التطبيق مع تكوين للاستيراد. يتم تحديد مجموعة الموارد الحالية الخاصة بك بشكل افتراضي.	my-resource-group
   Resource	حدد مخزن تكوين التطبيق الذي يحتوي على التكوين الذي تريد استيراده.	my-other-app-config-store

   إشعار

   تشير الرسالة "تم إحضار مفاتيح الوصول بنجاح" إلى نجاح الاتصال بمخزن تكوين التطبيق."

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

   المعلمة	‏‏الوصف‬	مثال
   من التسمية	حدد تسمية واحدة على الأقل لاستيراد القيم باستخدام التسميات المقابلة. حدد كافة استيراد قيم المفاتيح مع أي تسمية، و (بلا تسمية) يقيد الاستيراد إلى قيم المفاتيح بدون تسمية.	همز
   في وقت محدد	اختياري. املأ لاستيراد قيم المفاتيح من نقطة زمنية محددة. هذه هي النقطة الزمنية لقيم المفاتيح في مخزن التكوين المحدد. التنسيق: "YYYY-MM-DDThh:mm:ssZ". يتم تعيين هذا الحقل افتراضيا إلى النقطة الزمنية الحالية لقيم المفاتيح عند تركها فارغة.	07/28/2022 12:00:00 صباحًا
   تجاوز تسميات قيمة المفتاح الافتراضية	اختياري. بشكل افتراضي، تستخدم العناصر المستوردة التسمية الحالية الخاصة بها. حدد المربع وأدخل تسمية لتجاوز هذه الإعدادات الافتراضية باستخدام تسمية مخصصة.	جديد
   تجاوز نوع المحتوى الافتراضي لقيمة المفتاح	اختياري. بشكل افتراضي، تستخدم العناصر المستوردة نوع المحتوى الحالي الخاص بها. حدد المربع وحدد مرجع Key Vault أو JSON (تطبيق/json) ضمن نوع المحتوى للإشارة إلى أن المحتوى المستورد يتكون من مرجع Key Vault أو ملف JSON. يمكن تجاوز نوع المحتوى فقط لقيم المفاتيح المستوردة. نوع المحتوى الافتراضي لعلامات الميزات هو "application/vnd.microsoft.appconfig.ff+json؛charset=utf-8" ولا يتم تحديثه بواسطة هذه المعلمة.	JSON (application/json)

5. حدد Apply لمتابعة الاستيراد.

لقد قمت باستيراد قيم المفاتيح وعلامات الميزات مع تسمية "prod" من متجر App Configuration في 28 يناير 2021 في الساعة 12 صباحا، وقمت بتعيين التسمية "جديد". تم تعيين نوع المحتوى لكافة قيم المفاتيح التي قمت باستيرادها على أنها "JSON".

Azure CLI

من Azure CLI، اتبع الخطوات أدناه. إذا لم يكن Azure CLI مثبتاً لديك بالفعل، يمكنك، اختيارياً، استخدام Azure Cloud Shell.

1. أدخل أمر الاستيراد az appconfig kv import وأدخل المعلمات التالية:

   المعلمة	‏‏الوصف‬	مثال
   --name	أدخل اسم مخزن تكوين التطبيق الذي تريد استيراد البيانات إليه	my-app-config-store
   --source	أدخل appconfig للإشارة إلى أنك تقوم باستيراد البيانات من مخزن تكوين التطبيق.	appconfig
   --src-name	أدخل اسم مخزن تكوين التطبيق الذي تريد استيراد البيانات منه.	my-source-app-config
   --src-label	قم بتقييد الاستيراد إلى قيم المفاتيح باستخدام تسمية معينة. إذا لم تستخدم هذه المعلمة، استيراد قيم المفاتيح ذات التسمية الخالية فقط. يدعم علامة النجمة كعامل تصفية: أدخل * لجميع التسميات؛ abc* لجميع التسميات مع abc كبادئة.	prod

2. إضافة المعلمات التالية اختياريا:

   المعلمة	‏‏الوصف‬	مثال
   --label	اختياري. أدخل تسمية سيتم تعيينها إلى قيم المفاتيح المستوردة.	new
   --content-type	اختياري. أدخل appconfig/kvset أو application/json لذكر أن المحتوى المستورد يتكون من مرجع Key Vault أو ملف JSON. يمكن تجاوز نوع المحتوى فقط لقيم المفاتيح المستوردة. نوع المحتوى الافتراضي لعلامات الميزات هو "application/vnd.microsoft.appconfig.ff+json؛charset=utf-8' بشكل افتراضي ولا يتم تحديثه بواسطة هذه المعلمة.	application/json

   مثال: استيراد قيم المفاتيح وعلامات الميزات مع التسمية "prod" من تكوين تطبيق آخر، وتعيين التسمية "جديد". أضف نوع المحتوى "application/json".

   az appconfig kv import --name my-app-config-store --source appconfig --src-name my-source-app-config --src-label prod --label new --content-type application/json
   

3. يعرض سطر الأوامر قائمة بالتغييرات القادمة. تأكد من الاستيراد عن طريق تحديد y.

   

قمت باستيراد قيم المفاتيح مع التسمية "prod" من متجر App Configuration، وتعيين التسمية "new". تم تعيين نوع المحتوى لكافة قيم المفاتيح التي قمت باستيرادها على أنها "JSON".

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

استيراد البيانات من خدمة التطبيق من Azure

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

إشعار

لا تدعم خدمة التطبيق حاليا علامات الميزات. يتم تحويل جميع علامات الميزات المستوردة إلى خدمة التطبيق إلى قيم المفاتيح تلقائيا. يمكن أن تحتوي موارد خدمة التطبيق على قيم مفاتيح فقط.

بوابة

من مدخل Azure:

1. استعرض للوصول إلى مخزن App Configuration، وحدد Import/export من قائمة Operations.

   

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

3. حدد حدد مورد، واملأ النموذج بالمعلمات التالية، وحدد تطبيق:

   المعلمة	‏‏الوصف‬	مثال
   الاشتراك	يتم تحديد اشتراكك الحالي بشكل افتراضي.	اشتراكي
   مجموعة الموارد	حدد مجموعة موارد تحتوي على خدمة التطبيق مع تكوين للاستيراد.	my-resource-group
   Resource	حدد خدمة التطبيق التي تحتوي على التكوين الذي تريد استيراده.	my-app-service

   إشعار

   يتم عرض رسالة تشير إلى عدد قيم المفاتيح التي تم جلبها بنجاح من مورد App Service المصدر.

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

   المعلمة	‏‏الوصف‬	مثال
   البادئة	اختياري. بادئة المفتاح هي الجزء الأول من خاصية "المفتاح" لقيم المفاتيح. يمكن استخدام البادئات لإدارة مجموعات من قيم المفاتيح في مخزن التكوين. يتم إلحاق هذه البادئة بواجهة خاصية "المفتاح" لكل قيمة مفتاح مستوردة.	TestApp:
   Label	اختياري. حدد تسمية موجودة أو أدخل تسمية جديدة سيتم تعيينها إلى قيم المفاتيح المستوردة.	همز
   نوع المحتوى	اختياري. تشير إلى ما إذا كان الملف الذي تستورده مرجع Key Vault أو ملف JSON. لمزيد من المعلومات حول مراجع Key Vault، انتقل إلى Use Key Vault references in an ASP.NET Core app.	JSON (application/json)

5. حدد Apply لمتابعة الاستيراد.

قمت باستيراد جميع إعدادات التطبيق من App Service كقيم رئيسية، وتعيين التسمية "prod" والبادئة "TestApp". تم تعيين نوع المحتوى لكافة قيم المفاتيح التي قمت باستيرادها على أنها "JSON".

Azure CLI

من Azure CLI، اتبع الخطوات أدناه. إذا لم يكن Azure CLI مثبتاً لديك بالفعل، يمكنك، اختيارياً، استخدام Azure Cloud Shell.

1. أدخل أمر الاستيراد az appconfig kv import وأضف المعلمات التالية:

   المعلمة	‏‏الوصف‬	مثال
   --name	أدخل اسم مخزن تكوين التطبيق الذي تريد استيراد البيانات إليه.	my-app-config-store
   --source	أدخل appservice للإشارة إلى أنك تقوم باستيراد بيانات تكوين التطبيق من خدمة التطبيق من Azure.	appservice
   --appservice-account	لاستخدام معرف ARM لـ AppService أو استخدام اسم AppService، على افتراض أنه في نفس الاشتراك ومجموعة الموارد مثل تكوين التطبيق.	/subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/my-app-service أو my-app-service

2. إضافة المعلمات التالية اختياريا أيضا:

   المعلمة	‏‏الوصف‬	مثال
   --prefix	اختياري. بادئة المفتاح هي الجزء الأول من خاصية "المفتاح" لقيمة المفتاح. يمكن استخدام البادئات لإدارة مجموعات من قيم المفاتيح في مخزن التكوين. سيتم إلحاق هذه البادئة بواجهة خاصية "المفتاح" لكل قيمة مفتاح مستوردة.	TestApp:
   --label	اختياري. أدخل تسمية سيتم تعيينها إلى قيم المفاتيح المستوردة. إذا لم تحدد تسمية، فسيتم تعيين التسمية الخالية إلى قيم المفاتيح الخاصة بك.	prod
   --content-type	اختياري. أدخل appconfig/kvset أو application/json للإشارة إلى أن المحتوى المستورد يتكون من مرجع Key Vault أو ملف JSON.	application/json

   للحصول على قيمة --appservice-account، استخدم الأمرaz webapp show --resource-group <resource-group> --name <resource-name>.

   مثال: استيراد جميع إعدادات التطبيق من خدمة التطبيق كقيم رئيسية مع التسمية "prod"، إلى مخزن تكوين التطبيق الخاص بك، وإضافة بادئة "TestApp:".

   az appconfig kv import --name my-app-config-store --source appservice --appservice-account /subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/my-app-service --label prod --prefix TestApp:
   

3. يعرض سطر الأوامر قائمة بالتغييرات القادمة. تأكد من الاستيراد عن طريق تحديد y.

   

لقد قمت باستيراد جميع إعدادات التطبيق من App Service كقيم مفاتيح، وتعيين التسمية لهم "prod"، وإضافة بادئة "TestApp:". تم تعيين نوع المحتوى لكافة قيم المفاتيح التي قمت باستيرادها على أنها "JSON".

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

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

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

يوضح هذا الدليل كيفية تصدير بيانات تكوين التطبيق:

• إلى ملف تكوين في Json أو Yaml أو Properties
• إلى مخزن تكوين التطبيق
• إلى مورد خدمة التطبيق من Azure

تصدير البيانات إلى ملف تكوين

اتبع الخطوات أدناه لتصدير بيانات التكوين من متجر تكوين التطبيق إلى ملف Json أو Yaml أو Properties.

إشعار

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

بوابة

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

1. استعرض للوصول إلى مخزن App Configuration، وحدد Import/export.

   

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

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

   المعلمة	‏‏الوصف‬	مثال
   البادئة	اختياري. سيتم اقتطاع هذه البادئة من خاصية "المفتاح" لكل قيمة مفتاح. بادئة المفتاح هي الجزء الأول من المفتاح. يمكن استخدام البادئات لإدارة مجموعات من قيم المفاتيح في مخزن التكوين.	TestApp:
   من التسمية	حدد تسمية موجودة لتقييد التصدير إلى قيم المفاتيح باستخدام تسمية معينة. إذا لم تحدد تسمية، فسيتم تصدير قيم المفاتيح التي تحمل التسمية "بلا تسمية" بشكل افتراضي. راجع الملاحظة أدناه.	همز
   في وقت محدد	اختياري. املأ لاستيراد قيم المفاتيح من نقطة زمنية محددة. هذه هي النقطة الزمنية لقيم المفاتيح في مخزن التكوين المحدد. التنسيق: "YYYY-MM-DDThh:mm:ssZ". يتم تعيين هذا الحقل افتراضيا إلى النقطة الزمنية الحالية لقيم المفاتيح عند تركها فارغة.	07/28/2022 12:00:00 صباحًا
   نوع الملف	حدد نوع الملف الذي تقوم بتصديره بين Yaml أو Properties أو Json.	JSON
   فاصل	الفاصل هو المحدد لتسطيح قيم المفاتيح إلى Json/Yaml. وهو يدعم البنية الهرمية للتكوين ولا ينطبق على ملفات الخصائص وعلامات الميزات. حدد أحد الخيارات التالية: .أو ، :، ؛ ، /، -_، —، (بلا فاصل).	;

   هام

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

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

لقد قمت بتصدير قيم المفاتيح التي تحتوي على تسمية "prod" من ملف تكوين، في حالتها من 07/28/2021 12:00:00 ص، وقمت باقتطاع البادئة "TestApp". يتم فصل القيم بـ "،" في الملف.

Azure CLI

من Azure CLI، اتبع الخطوات أدناه. إذا لم يكن Azure CLI مثبتاً لديك بالفعل، يمكنك، اختيارياً، استخدام Azure Cloud Shell.

1. أدخل أمر التصدير az appconfig kv export وأضف المعلمات التالية:

   المعلمة	‏‏الوصف‬	مثال
   --name	أدخل اسم مخزن تكوين التطبيق الذي يحتوي على قيم المفاتيح التي تريد تصديرها.	my-app-config-store
   --destination	أدخل file للإشارة إلى أنك تقوم بتصدير البيانات إلى ملف.	file
   --path	أدخل المسار الذي تريد حفظ الملف فيه.	C:/Users/john/Downloads/data.json
   --format	أدخل yaml، properties أو json للإشارة إلى تنسيق الملف الذي تريد تصديره.	json
   --label	أدخل تسمية لتصدير قيم المفاتيح وعلامات الميزات باستخدام هذه التسمية. إذا لم تحدد تسمية، بشكل افتراضي، فإنك تقوم فقط بتصدير قيم المفاتيح وعلامات الميزات بدون تسمية. يمكنك إدخال تسمية واحدة، أو إدخال عدة تسميات عن طريق فصلها ب ,، أو استخدامها * لأخذ جميع التسميات في الاعتبار.	prod

   هام

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

2. إضافة المعلمات التالية اختياريا أيضا:

   المعلمة	‏‏الوصف‬	مثال
   --separator	اختياري. الفاصل هو المحدد لتسطيح قيم المفاتيح إلى Json/Yaml. وهو مطلوب لتصدير البنية الهرمية وسيتم تجاهله لملفات الخصائص وعلامات الميزات. اختر أحد الخيارات التالية: .، ,، :، ;، /، -، _، —.	;
   --prefix	اختياري. البادئة المراد اقتطاعها من خاصية "المفتاح" لكل قيمة مفتاح. بادئة المفتاح هي الجزء الأول من المفتاح. يمكن استخدام البادئات لإدارة مجموعات من قيم المفاتيح في مخزن التكوين. سيتم تجاهل البادئة لعلامات الميزة.	TestApp:

   مثال: تصدير كافة قيم المفاتيح وعلامات الميزات ذات التسمية "prod" إلى ملف JSON.

   az appconfig kv export --name my-app-config-store --label prod --destination file --path D:/abc.json --format json --separator ; --prefix TestApp:
   

3. يعرض سطر الأوامر قائمة بالقيم الرئيسية التي يتم تصديرها إلى الملف. قم بتأكيد التصدير عن طريق تحديد y.

   

لقد قمت بتصدير قيم المفاتيح وعلامات الميزات التي تحتوي على تسمية "prod" إلى ملف تكوين، وقمت باقتطاع البادئة "TestApp". يتم فصل القيم بـ "،" في الملف.

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

تصدير بيانات إلى مخزن تكوين التطبيقات

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

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

بوابة

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

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

   

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

3. حدد حدد مورد، واملأ النموذج بالمعلمات التالية، وحدد تطبيق:

   المعلمة	‏‏الوصف‬	مثال
   الاشتراك	يتم تحديد اشتراكك الحالي بشكل افتراضي.	اشتراكي
   مجموعة الموارد	حدد مجموعة موارد تحتوي على مخزن تكوين التطبيق مع تكوين للاستيراد.	my-resource-group
   Resource	حدد مخزن تكوين التطبيق الذي يحتوي على التكوين الذي تريد استيراده.	my-app-config-store

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

   إشعار

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

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

   المعلمة	‏‏الوصف‬	مثال
   من التسمية	حدد تسمية واحدة على الأقل لتصدير القيم باستخدام التسميات المقابلة. سيؤدي تحديد الكل إلى تصدير قيم المفاتيح مع أي تسمية، و (بلا تسمية) سيقيد التصدير إلى قيم المفاتيح بدون تسمية.	همز
   في وقت محدد	اختياري. املأ لاستيراد قيم المفاتيح من نقطة زمنية محددة. هذه هي النقطة الزمنية لقيم المفاتيح في مخزن التكوين المحدد. التنسيق: "YYYY-MM-DDThh:mm:ssZ". يتم تعيين هذا الحقل افتراضيا إلى النقطة الزمنية الحالية لقيم المفاتيح عند تركها فارغة.	07/28/2022 12:00:00 صباحًا
   تجاوز تسميات قيمة المفتاح الافتراضية	اختياري. بشكل افتراضي، تستخدم العناصر المستوردة التسمية الحالية الخاصة بها. حدد المربع وأدخل تسمية لتجاوز هذه الإعدادات الافتراضية باستخدام تسمية مخصصة.	جديد

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

لقد قمت بتصدير قيم المفاتيح وعلامات الميزات التي تحتوي على التسمية "prod" من متجر App Configuration، في حالتها من 07/28/2022 12:00:00 ص، وقمت بتعيين التسمية "جديد".

Azure CLI

من Azure CLI، اتبع الخطوات أدناه. إذا لم يكن Azure CLI مثبتاً لديك بالفعل، يمكنك، اختيارياً، استخدام Azure Cloud Shell.

1. أدخل أمر التصدير az appconfig kv export وأدخل المعلمات التالية:

   المعلمة	‏‏الوصف‬	مثال
   --name	أدخل اسم مخزن تكوين التطبيق الذي يحتوي على قيم المفاتيح التي تريد تصديرها.	my-app-config-store
   --destination	أدخل appconfig للإشارة إلى أنك تقوم بتصدير البيانات إلى مخزن تكوين التطبيق.	appconfig
   --dest-name	أدخل اسم مخزن تكوين التطبيق الذي تريد تصدير البيانات إليه.	my-other-app-config-store
   --label	أدخل تسمية لتصدير قيم المفاتيح وعلامات الميزات باستخدام هذه التسمية. إذا لم تحدد تسمية، بشكل افتراضي، فلن تقوم إلا بتصدير قيم المفاتيح وعلامات الميزات بدون تسمية. يمكنك إدخال تسمية واحدة، أو إدخال عدة تسميات عن طريق فصلها مع ,، أو استخدام * لأخذ جميع التسميات في الاعتبار.	prod

   هام

   إذا كانت قيم المفاتيح التي تريد تصديرها تحتوي على تسميات، فيجب عليك استخدام الأمر --label وإدخال التسميات المقابلة. إذا لم تحدد تسمية، تصدير قيم المفاتيح التي لا تحتوي على تسميات فقط. استخدم علامة فاصلة (,) لتحديد عدة تسميات أو استخدم * لتضمين كافة التسميات، بما في ذلك التسمية الخالية (بدون تسمية).

2. إضافة المعلمة التالية اختياريا أيضا:

   المعلمة	‏‏الوصف‬	مثال
   --dest-label	اختياري. أدخل تسمية الوجهة، لتعيين هذه التسمية إلى قيم المفاتيح المصدرة.	new

   مثال: تصدير قيم المفاتيح وعلامات الميزات مع التسمية "prod" إلى متجر App Configuration آخر وإضافة التسمية الوجهة "جديد".

   az appconfig kv export --name my-app-config-store --destination appconfig --dest-name my-other-app-config-store --dest-label new --label prod
   

3. يعرض سطر الأوامر قائمة بالقيم الرئيسية التي يتم تصديرها إلى الملفات. قم بتأكيد التصدير عن طريق تحديد y.

   

لقد قمت بتصدير قيم المفاتيح وعلامات الميزات التي تحتوي على التسمية "prod" من متجر App Configuration وتعيين التسمية "جديد".

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

تصدير البيانات إلى خدمة التطبيق من Azure

اتبع الخطوات أدناه لتصدير قيم المفاتيح إلى خدمة التطبيق من Azure.

إشعار

تصدير علامات الميزات إلى خدمة التطبيق غير مدعوم حاليا.

بوابة

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

1. استعرض للوصول إلى مخزن App Configuration، وحدد Import/export من قائمة Operations.

   

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

3. حدد حدد مورد، واملأ النموذج بالمعلمات التالية، وحدد تطبيق:

   المعلمة	‏‏الوصف‬	مثال
   الاشتراك	يتم تحديد اشتراكك الحالي بشكل افتراضي.	اشتراكي
   مجموعة الموارد	حدد مجموعة موارد تحتوي على خدمة التطبيق مع تكوين للتصدير.	my-resource-group
   Resource	حدد خدمة التطبيق التي تحتوي على التكوين الذي تريد تصديره.	my-app-service

4. تعرض الصفحة الآن خدمة الهدف المحددة ومعرف المورد. يتيح لك إجراء تحديد المورد التبديل إلى مورد App Service هدف آخر.

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

   المعلمة	‏‏الوصف‬	مثال
   البادئة	اختياري. سيتم اقتطاع هذه البادئة من كل خاصية "مفتاح" قيمة مفتاح تم تصديرها. بادئة المفتاح هي الجزء الأول من المفتاح. يمكن استخدام البادئات لإدارة مجموعات من قيم المفاتيح في مخزن التكوين. سيتم تجاهل البادئة لعلامات الميزة.	TestApp:
   التصدير كمرجع	اختياري. تحقق لتصدير قيم المفاتيح إلى App Service كمراجع تكوين التطبيق. معرفة المزيد
   في وقت محدد	اختياري. املأ لتصدير قيم المفاتيح من نقطة زمنية معينة. هذه هي النقطة الزمنية لقيم المفاتيح في مخزن التكوين المحدد. التنسيق: "YYYY-MM-DDThh:mm:ssZ". يتم تعيين هذا الحقل افتراضيا إلى النقطة الزمنية الحالية لقيم المفاتيح عند تركها فارغة.	07/28/2022 12:00:00 صباحًا
   من التسمية	اختياري. حدد تسمية موجودة لتقييد التصدير إلى قيم المفاتيح باستخدام تسمية معينة. إذا لم تحدد تسمية، فسيتم تصدير قيم المفاتيح التي تحمل التسمية "بلا تسمية".	همز

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

لقد قمت بتصدير قيم المفاتيح التي تحتوي على تسمية "prod" من مورد خدمة التطبيق، في حالتها من 07/28/2021 12:00:00 ص، وقمت باقتطاع البادئة "TestApp". تم تصدير قيم المفاتيح بنوع محتوى بتنسيق JSON.

إذا حددت المربع لتصدير قيم المفاتيح كمراجع، تتم الإشارة إلى قيم المفاتيح المصدرة كمراجع تكوين التطبيق في العمود "المصدر" لإعدادات تكوين موارد App Service.

Azure CLI

من Azure CLI، اتبع الخطوات أدناه. إذا لم يكن Azure CLI مثبتاً لديك بالفعل، يمكنك، اختيارياً، استخدام Azure Cloud Shell.

1. أدخل أمر التصدير az appconfig kv export وأدخل المعلمات التالية:

   المعلمة	‏‏الوصف‬	مثال
   --name	أدخل اسم مخزن تكوين التطبيق الذي يحتوي على قيم المفاتيح التي تريد تصديرها.	my-app-config-store
   --destination	أدخل appservice للإشارة إلى أنك تقوم بتصدير البيانات إلى خدمة التطبيق.	appservice
   --appservice-account	لاستخدام معرف ARM لـ AppService أو استخدام اسم AppService، على افتراض أنه في نفس الاشتراك ومجموعة الموارد مثل تكوين التطبيق.	/subscriptions/123/resourceGroups/my-as-resource-group/providers/Microsoft.Web/sites/my-app-service أو my-app-service
   --label	اختياري. أدخل تسمية لتصدير قيم المفاتيح وعلامات الميزات باستخدام هذه التسمية. إذا لم تحدد تسمية، بشكل افتراضي، فسوف تقوم فقط بتصدير قيم المفاتيح وعلامات الميزات بدون تسمية.	prod

   للحصول على قيمة --appservice-account، استخدم الأمرaz webapp show --resource-group <resource-group> --name <resource-name>.

2. إضافة بادئة اختياريا أيضا:

   المعلمة	‏‏الوصف‬	مثال
   --prefix	اختياري. البادئة التي سيتم اقتطاعها من خاصية "المفتاح" لقيمة المفتاح المصدرة. بادئة المفتاح هي الجزء الأول من المفتاح. يمكن استخدام البادئات لإدارة مجموعات من قيم المفاتيح في مخزن التكوين.	TestApp:

   مثال: تصدير كافة قيم المفاتيح باستخدام التسمية "prod" إلى تطبيق خدمة التطبيق واقتطاع البادئة "TestApp".

   az appconfig kv export --name my-app-config-store --destination appservice --appservice-account /subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/my-app-service/config/web --label prod --prefix TestApp:
   

   يعرض سطر الأوامر قائمة بالقيم الرئيسية التي يتم تصديرها إلى مورد App Service. قم بتأكيد التصدير عن طريق تحديد y.

   

   لقد قمت بتصدير كافة قيم المفاتيح مع التسمية "prod" إلى مورد Azure App Service، وقمت باقتطاع البادئة "TestApp:".

3. حدد اختياريا علامة للتصدير كمرجع تكوين التطبيق.

   المعلمة	‏‏الوصف‬
   --export-as-reference -r	اختياري. حدد ما إذا كان يتم تصدير قيم المفاتيح إلى App Service كمراجع تكوين التطبيق. اعرف المزيد.

   مثال: تصدير كافة قيم المفاتيح مع التسمية "prod" كمراجع تكوين التطبيق إلى تطبيق App Service.

   az appconfig kv export --name my-app-config-store --destination appservice --appservice-account "/subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/my-app-service" --label prod --export-as-reference
   

   يعرض سطر الأوامر قائمة بالقيم الرئيسية التي يتم تصديرها كمراجع تكوين التطبيق إلى مورد App Service. قم بتأكيد التصدير عن طريق تحديد y.

   

   لقد قمت بتصدير جميع قيم المفاتيح مع التسمية "prod" كمراجع لتكوين التطبيق إلى مورد Azure App Service. في مورد App Service، ستتم الإشارة إلى قيم المفاتيح المستوردة كمراجع تكوين التطبيق في العمود "المصدر".

   

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

رسائل خطأ

قد تواجه رسائل الخطأ التالية عند استيراد قيم مفتاح تكوين التطبيق أو تصديرها:

• يجب أن يتراوح حجم الملف المحدد بين 1 و 2097152 بايت.: الملف كبير جدا. حدد ملفا أصغر.
• تم تعطيل الوصول العام لمخزنك أو أنك تقوم بالوصول من نقطة نهاية خاصة غير موجودة في تكوينات نقطة النهاية الخاصة بالمخزن. لاستيراد قيم المفاتيح من متجر App Configuration، تحتاج إلى الوصول إلى هذا المتجر. إذا لزم الأمر، فمكن الوصول العام للمخزن المصدر أو الوصول إليه من نقطة نهاية خاصة معتمدة. إذا قمت بتمكين الوصول العام للتو، فانتظر حتى 5 دقائق حتى يتم تحديث ذاكرة التخزين المؤقت.

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

التكامل مع البنية الأساسية لبرنامج ربط العمليات التجارية CI/CD