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

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

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

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

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

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

• من ملف تكوين في JSON أو YAML أو Properties
• من متجر App Configuration
• من Azure App Service
• من Azure Kubernetes Service ConfigMaps

استيراد البيانات من ملف ضبط

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

بوابة

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

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

   

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

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

   المعلمة	‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫الوَصف‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎	مثال
   نوع الملف	حدد نوع الملف للاستيراد: YAML أو Properties أو JSON.	JSON

4. انقر فوق الزر "استعراض" ، وحدد الملف المراد استيراده.

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

   المعلمة	‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫الوَصف‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎	مثال
   ملف تعريف محتوى الملف	حدد ملف تعريف محتوى: افتراضي أو KVSet. يشير ملف تعريف محتوى الملف الافتراضي إلى مخطط ملف التكوين التقليدي المعتمد على نطاق واسع بواسطة أطر أو أنظمة البرمجة الحالية ، ويدعم تنسيقات ملفات JSON أو YAML أو Properties. يشير ملف تعريف محتوى ملف KVSet إلى مخطط ملف يحتوي على جميع خصائص قيمة مفتاح تكوين التطبيق، بما في ذلك المفتاح والقيمة والتسمية ونوع المحتوى والعلامات.	افتراضي
   وضع الاستيراد	يتم استخدام وضع الاستيراد لتحديد ما إذا كان سيتم تجاهل قيم المفاتيح المتطابقة. باستخدام خيار تجاهل المطابقة ، يتم تجاهل أي قيم رئيسية في المتجر مماثلة لتلك الموجودة في ملف التكوين. باستخدام خيار الكل، يتم تحديث جميع القيم الرئيسية في ملف التكوين.	تجاهل المطابقة
   استبعاد علامة الميزة	إذا تم وضع علامة على هذا الخيار، فلن يتم استيراد علامات الميزات.	دون رادع
   صارم	إذا تم تحديد المربع، يتم حذف أي قيم رئيسية في المخزن تحتوي على البادئة والتسمية المحددة، والتي لم يتم تضمينها في ملف التكوين عند تعيين ملف تعريف محتوى الملف إلى افتراضي. عند تعيين ملف تعريف محتوى الملف إلى KVSet، يتم حذف أي قيم رئيسية في المخزن غير مضمنة في ملف التكوين. إذا تم إلغاء تحديد المربع، فلن يتم حذف أي قيم رئيسية في المتجر.	دون رادع
   فاصل	الفاصل هو المحدد المستخدم لتسطيح ملفات JSON أو YAML إلى قيمة مفتاح. سيتم تجاهله لملفات الخصائص وعلامات الميزات. تتضمن القيم المدعومة عدم وجود فاصل ، ونقطة (.) ، وفاصلة (،) ، وفاصلة منقوطة (;) ، ووصلة (-) ، وتسطير سفلي (_) ، وتسطير سفلي مزدوج (__) ، وشرطة مائلة (/) ، ونقطتين (:).	:
   عمق	اختياري. عمق تسطيح ملفات JSON أو YAML إلى أزواج من القيمة الرئيسية. بشكل افتراضي، يتم تسوية الملفات إلى أعمق مستوى إذا تم تحديد فاصل. لا ينطبق هذا الإعداد على ملفات الخصائص أو علامات الميزات.
   إضافة بادئة	اختياري. إذا تم تحديدها، ستتم إضافة بادئة إلى أسماء المفاتيح لجميع قيم المفاتيح المستوردة.	تطبيق الاختبار:
   إضافة تسمية	اختياري. إذا تم تحديده، تعيين التسمية المتوفرة لجميع قيم المفاتيح المستوردة.	همز
   إضافة نوع المحتوى	اختياري. إذا تم تحديده، ستتم إضافة نوع المحتوى المقدم إلى كافة قيم المفاتيح المستوردة.	JSON (تطبيق/JSON)
   إضافة علامات	اختياري. إذا تم تحديده، ستتم إضافة العلامات المقدمة إلى جميع قيم المفاتيح المستوردة.	{العلامة: TAG1}

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

لقد نجحت في استيراد قيم المفاتيح من ملف JSON. تم تسطيح الأسماء الرئيسية باستخدام : الفاصل ومسبوقة ب TestApp:. يتم تسمية جميع قيم المفاتيح المستوردة ك prod، مع نوع محتوى ، application/jsonويتم تمييزها ب tag: tag1.

Azure CLI

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

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

   المعلمة	‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫الوَصف‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎	مثال
   --name	أدخل اسم متجر App Configuration الذي تريد استيراد البيانات إليه.	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.

استيراد البيانات من متجر App Configuration

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

اتبع الخطوات أدناه لاستيراد القيم الرئيسية وعلامات الميزات من متجر Azure App Configuration.

بوابة

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

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

   

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

3. حدد متجر App Configuration لاستيراد البيانات منه، واملأ النموذج بالمعلمات التالية:

   المعلمة	‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫الوَصف‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎	مثال
   Subscription	يتم تحديد اشتراكك الحالي افتراضيا.	اشتراكي
   مجموعة الموارد	حدد مجموعة موارد تحتوي على مخزن تكوين التطبيقات مع التكوين المراد استيرادها. يتم تحديد مجموعة الموارد الحالية بشكل افتراضي.	مجموعة الموارد الخاصة بي
   Resource	حدد متجر App Configuration الذي يحتوي على التكوين الذي تريد استيراده.	متجر التطبيق الآخر

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

   المعلمة	‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫الوَصف‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎	مثال
   وضع التحديد	حدد ما إذا كنت تريد الاستيراد من قيم المفاتيح العادية، وهو الخيار الافتراضي، أو من لقطة.	افتراضي
   عامل تصفية المفتاح	تستخدم لتصفية قيم المفاتيح استنادا إلى اسم المفتاح للاستيراد. إذا لم يتم تحديد أي مفاتيح، فستكون جميع المفاتيح مؤهلة.	يبدأ بالاختبار
   في وقت محدد	اختياري. املأ هذا الحقل لاستيراد قيم المفاتيح من نقطة زمنية معينة في مخزن التكوين المحدد. إذا تركت فارغة ، تعيينها افتراضيا على النقطة الزمنية الحالية لقيم المفاتيح.	28/07/2022 12:00:00 ص
   من الملصق	حدد تسمية واحدة أو أكثر لاستيراد قيم المفاتيح المقترنة بهذه التسميات. إذا لم يتم تحديد أي تصنيف، تكون جميع التصنيفات مؤهلة.	همز
   استبعاد علامة الميزة	إذا تم وضع علامة على هذا الخيار، فلن يتم استيراد علامات الميزات.	دون رادع
   إضافة بادئة	اختياري. إذا تم تحديدها، ستتم إضافة بادئة إلى أسماء المفاتيح لجميع قيم المفاتيح المستوردة.	تطبيق الاختبار:
   تجاوز التصنيفات	اختياري. بشكل افتراضي، يتم الاحتفاظ بالتسميات الأصلية لقيم المفاتيح المصدر. لتجاوبها، ضع علامة في المربع وأدخل تسمية جديدة لقيم المفاتيح المستوردة.	الجديد
   تجاوز أنواع المحتويات	اختياري. بشكل افتراضي، يتم الاحتفاظ بأنواع المحتوى الأصلية لقيم المفاتيح المصدر. لتجاوزها، حدد المربع وأدخل نوع محتوى جديدا لقيم المفاتيح المستوردة. لاحظ أنه لا يمكن تجاوز نوع محتوى علامات الميزات.	JSON (تطبيق/JSON)

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

لقد استوردت قيم المفاتيح من متجر App Configuration اعتبارا من 28 يناير 2021، الساعة 12 صباحا، مع أسماء المفاتيح التي تبدأ ب test و label prod. كانت أسماء المفاتيح مسبوقة ب TestApp:. تم تعيين التسمية new ونوع application/jsonالمحتوى لجميع قيم المفاتيح المستوردة .

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

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

   المعلمة	‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫الوَصف‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎	مثال
   --name	أدخل اسم متجر App Configuration الذي تريد استيراد البيانات إليه	my-app-config-store
   --source	أدخل appconfig للإشارة إلى أنك تقوم باستيراد البيانات من متجر App Configuration.	appconfig
   --src-name	أدخل اسم متجر App Configuration الذي تريد استيراد البيانات منه.	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، وخصصت لها التسمية "جديد". تم تعيين نوع المحتوى على جميع القيم الرئيسية التي قمت باستيرادها على أنه "JSON".

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

استيراد البيانات من Azure App Service

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

إشعار

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

بوابة

من مدخل Azure:

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

   

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

3. حدد متجر App Configuration لاستيراد البيانات منه، واملأ النموذج بالمعلمات التالية:

   المعلمة	‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫الوَصف‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎	مثال
   Subscription	يتم تحديد اشتراكك الحالي افتراضيا.	اشتراكي
   مجموعة الموارد	حدد مجموعة موارد تحتوي على App Service مع التكوين المراد استيرادها.	مجموعة الموارد الخاصة بي
   Resource	حدد App Service التي تحتوي على التكوين الذي تريد استيراده.	خدمة التطبيق الخاص بي

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

   المعلمة	‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫الوَصف‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎	مثال
   تحديث الإعدادات للرجوع إليها	إذا تم تحديده، تحديث إعدادات التطبيق في App Service إلى مراجع تكوين التطبيق لقيم المفاتيح المستوردة. يتيح لك ذلك إدارة إعدادات التطبيق في تكوين التطبيق من الآن فصاعدا. ستقوم App Service تلقائيا بسحب القيمة الحالية من App Configuration. لمعرفة المزيد، راجع استخدام مراجع تكوين التطبيق لخدمة التطبيقات ووظائف Azure.	التحقق
   إضافة بادئة	اختياري. إذا تم تحديدها، ستتم إضافة بادئة إلى أسماء المفاتيح لجميع قيم المفاتيح المستوردة.	تطبيق الاختبار:
   إضافة تسمية	اختياري. إذا تم تحديده، تعيين التسمية المتوفرة لجميع قيم المفاتيح المستوردة.	همز
   إضافة نوع المحتوى	اختياري. إذا تم تحديده، ستتم إضافة نوع المحتوى المقدم إلى كافة قيم المفاتيح المستوردة.	JSON (تطبيق/JSON)

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

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

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

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

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

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

   المعلمة	‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫الوَصف‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎	مثال
   --prefix	اختياري. بادئة المفتاح هي الجزء الأول من خاصية "key" لقيمة المفتاح. يمكن استخدام البادئات لإدارة مجموعات القيم الرئيسية في مخزن التكوين. سيتم إلحاق هذه البادئة بالجزء الأمامي من خاصية "المفتاح" لكل قيمة مفتاح تم استيرادها.	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>.

   مثال: قم باستيراد جميع إعدادات التطبيق من App Service كقيم رئيسية مع التسمية "prod" ، إلى متجر App Configuration الخاص بك ، وأضف بادئة "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.

استيراد البيانات من Azure Kubernetes Service ConfigMaps

اتبع الخطوات أدناه لاستيراد قيم المفاتيح من Azure Kubernetes Service ConfigMaps. دعم المدخل لهذه الميزة قيد التطوير، يرجى استخدام Azure CLI للاستيراد من AKS.

بوابة

دعم مدخل Microsoft Azure لهذه الميزة قيد التطوير.

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

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

   المعلمة	‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫الوَصف‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎	مثال
   --name	أدخل اسم متجر App Configuration الذي تريد استيراد البيانات إليه.	my-app-config-store
   --source	أدخل aks للإشارة إلى أنك تقوم باستيراد بيانات تكوين التطبيق من خدمة Azure Kubernetes.	aks
   --aks-cluster	أدخل معرف ARM لخدمة Azure Kubernetes أو استخدم اسم خدمة Azure Kubernetes، إذا كانت في نفس الاشتراك ومجموعة الموارد مثل تكوين التطبيق.	/subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.ContainerService/managedClusters/my-aks-cluster أو my-aks-cluster
   --configmap-namespace	أدخل مساحة اسم ConfigMap التي تريد استيرادها.	default
   --configmap-name	أدخل اسم ConfigMap الذي تريد استيراده.	my-configmap

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

   المعلمة	‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫الوَصف‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎	مثال
   --prefix	اختياري. بادئة المفتاح هي الجزء الأول من خاصية "key" لقيمة المفتاح. يمكن استخدام البادئات لإدارة مجموعات القيم الرئيسية في مخزن التكوين. سيتم إلحاق هذه البادئة بالجزء الأمامي من خاصية "المفتاح" لكل قيمة مفتاح تم استيرادها.	TestApp:
   --label	اختياري. أدخل تصنيفا سيتم تعيينه لقيم المفاتيح التي تم استيرادها. إذا لم تحدد تسمية، تعيين التسمية الفارغة إلى القيم الرئيسية.	test
   --content-type	اختياري. أدخل appconfig/kvset أو application/json للإشارة إلى أن المحتوى الذي تم استيراده يتكون من مرجع Key Vault أو ملف JSON.	application/json
   --format	اختياري. أدخل yaml أو خصائص أو json للإشارة إلى تنسيق ConfigMap الذي تقوم باستيراده.	json
   --separator	اختياري. الفاصل هو المحدد لتسطيح القيم الرئيسية. إنه مطلوب لتصدير البنية الهرمية وسيتم تجاهله لملفات الخصائص وعلامات الميزات. حدد أحد الخيارات التالية: .، ,، :، ;، /، -، _، . —	;

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

   مثال: قم باستيراد جميع الإعدادات من AKS Configmap كقيم رئيسية مع التسمية "test" ، إلى متجر App Configuration الخاص بك ، وأضف بادئة "TestApp:".

   az appconfig kv import --name my-app-config-store --source aks --aks-cluster /subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.ContainerService/managedClusters/my-aks-cluster --configmap-namespace default --configmap-name my-configmap --label test --prefix TestApp:
   

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

   

لقد قمت باستيراد جميع الإعدادات من AKS ConfigMap كقيم رئيسية ، وخصصت لها التسمية "test" ، وأضفت بادئة "TestApp:".

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

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

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

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

• إلى ملف تكوين في JSON أو YAML أو Properties
• إلى متجر App Configuration
• إلى مورد Azure App Service

تصدير البيانات إلى ملف ضبط

اتبع هذه الخطوات لتصدير بيانات التكوين من متجر App Configuration إلى ملف JSON أو YAML أو Properties.

بوابة

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

1. انتقل إلى متجر App Configuration الخاص بك، وحدد استيراد/تصدير.

   

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

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

   المعلمة	‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫الوَصف‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎	مثال
   نوع الملف	حدد نوع الملف للتصدير: YAML أو Properties أو JSON.	JSON
   ملف تعريف محتوى الملف	حدد ملف تعريف محتوى: افتراضي أو KVSet. يشير ملف تعريف محتوى الملف الافتراضي إلى مخطط ملف التكوين التقليدي المعتمد على نطاق واسع بواسطة أطر أو أنظمة البرمجة الحالية ، ويدعم تنسيقات ملفات JSON أو YAML أو Properties. يشير ملف تعريف محتوى ملف KVSet إلى مخطط ملف يحتوي على جميع خصائص قيمة مفتاح تكوين التطبيق، بما في ذلك المفتاح والقيمة والتسمية ونوع المحتوى والعلامات.	افتراضي
   وضع التحديد	حدد ما إذا كنت تريد التصدير من قيم المفاتيح العادية، وهو الخيار الافتراضي، أو من لقطة.	افتراضي
   عامل تصفية المفتاح	تستخدم لتصفية قيم المفاتيح استنادا إلى اسم المفتاح للتصدير. إذا لم يتم تحديد أي مفاتيح، فستكون جميع المفاتيح مؤهلة.	يبدأ ب TestApp:
   في وقت محدد	اختياري. املأ هذا الحقل لتصدير قيم المفاتيح من نقطة زمنية محددة في مخزن التكوين المحدد. إذا تركت فارغة ، تعيينها افتراضيا على النقطة الزمنية الحالية لقيم المفاتيح.	28/07/2022 12:00:00 ص
   من الملصق	حدد التسمية لتصدير القيم الرئيسية المقترنة بهذه التسميات. إذا لم يتم تحديد أي تصنيف، تكون جميع التصنيفات مؤهلة. لاحظ أنه يمكنك تحديد تسمية واحدة فقط عند التصدير باستخدام ملف تعريف محتوى الملف Default . لتصدير قيم المفاتيح بأكثر من تسمية واحدة، استخدم KVSet ملف تعريف محتوى الملف.	همز
   إزالة البادئة	اختياري. إذا تم تحديدها، ستتم إزالة البادئة من أسماء المفاتيح لجميع قيم المفاتيح التي تم تصديرها والتي تحتوي عليها.	تطبيق الاختبار:
   فاصل	الفاصل هو المحدد المستخدم لتقسيم أسماء المفاتيح وإعادة بناء التكوينات الهرمية لملفات JSON أو YAML من قيم المفاتيح. سيتم تجاهله لملفات الخصائص وعلامات الميزات. تتضمن القيم المدعومة عدم وجود فاصل أو نقطة (.) أو فاصلة (،) أو فاصلة منقوطة (;) أو واصلة (-) أو شرطة سفلية (_) أو شرطة سفلية مزدوجة (__) أو شرطة مائلة (/) أو نقطتين (:).	:

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

لقد قمت بتصدير قيم المفاتيح من متجر App Configuration اعتبارا من 28 يوليو 2021، الساعة 12 صباحا، مع أسماء المفاتيح التي تبدأ بالتصنيف TestApp: والتسمية prod، إلى ملف JSON. تم اقتطاع البادئة TestApp: من الأسماء الرئيسية، وتم استخدام الفاصل : لتقسيم الأسماء الرئيسية وإعادة بناء تنسيق JSON الهرمي.

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

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

   المعلمة	‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫الوَصف‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎	مثال
   --name	أدخل اسم متجر App Configuration الذي يحتوي على قيم المفاتيح التي تريد تصديرها.	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.

   

يتم تصدير علامات الميزات المتغيرة إلى ملف باستخدام مخطط إدارة ميزات Microsoft، بينما يتم تصدير علامات الميزات الأخرى باستخدام مخطط إدارة ميزات .NET للتوافق. لتصدير علامات الميزات حصريا باستخدام مخطط إدارة ميزات Microsoft، قم بتعيين متغير البيئة AZURE_APPCONFIG_FM_COMPATIBLE إلى خطأ.

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

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

تصدير البيانات إلى متجر App Configuration

اتبع الخطوات أدناه لتصدير القيم الرئيسية وعلامات الميزات إلى متجر Azure App Configuration.

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

بوابة

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

1. انتقل إلى متجر App Configuration الذي يحتوي على البيانات التي تريد تصديرها، وحدد استيراد/تصدير من قائمة العمليات .

   

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

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

   المعلمة	‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫الوَصف‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎	مثال
   وضع التحديد	حدد ما إذا كنت تريد التصدير من قيم المفاتيح العادية، وهو الخيار الافتراضي، أو من لقطة.	افتراضي
   عامل تصفية المفتاح	تستخدم لتصفية قيم المفاتيح استنادا إلى اسم المفتاح للتصدير. إذا لم يتم تحديد أي مفاتيح، فستكون جميع المفاتيح مؤهلة.	يبدأ ب TestApp:
   في وقت محدد	اختياري. املأ هذا الحقل لتصدير قيم المفاتيح من نقطة زمنية محددة في مخزن التكوين المحدد. إذا تركت فارغة ، تعيينها افتراضيا على النقطة الزمنية الحالية لقيم المفاتيح.	28/07/2022 12:00:00 ص
   من الملصق	حدد تسمية واحدة أو أكثر لتصدير القيم الرئيسية المقترنة بهذه التسميات. إذا لم يتم تحديد أي تصنيف، تكون جميع التصنيفات مؤهلة.	همز
   استبعاد علامة الميزة	إذا تم تحديده، فلن يتم تصدير علامات الميزات.	دون رادع

4. حدد متجر الوجهة ، واملأ النموذج بالمعلمات التالية:

   المعلمة	‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫الوَصف‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎	مثال
   Subscription	يتم تحديد اشتراكك الحالي افتراضيا.	اشتراكي
   مجموعة الموارد	حدد مجموعة موارد تحتوي على مخزن تكوين التطبيق حيث تريد تصدير التكوين. يتم تحديد مجموعة الموارد الحالية بشكل افتراضي.	مجموعة الموارد الخاصة بي
   Resource	حدد متجر تكوين التطبيق حيث تريد تصدير التكوين.	متجر التطبيق الآخر

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

   المعلمة	‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫الوَصف‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎	مثال
   إزالة البادئة	اختياري. إذا تم تحديدها، ستتم إزالة البادئة من أسماء المفاتيح لجميع قيم المفاتيح التي تم تصديرها والتي تحتوي عليها.	تطبيق الاختبار:
   تجاوز التصنيفات	اختياري. بشكل افتراضي، يتم الاحتفاظ بالتسميات الأصلية لقيم المفاتيح المصدر. لتجاوبها، حدد المربع وأدخل تسمية جديدة لقيم المفاتيح التي تم تصديرها.	الجديد
   تجاوز أنواع المحتويات	اختياري. بشكل افتراضي، يتم الاحتفاظ بأنواع المحتوى الأصلية لقيم المفاتيح المصدر. لتجاوزها، حدد المربع وأدخل نوع محتوى جديدا لقيم المفاتيح التي تم تصديرها. لاحظ أنه لا يمكن تجاوز نوع محتوى علامات الميزات.	JSON (تطبيق/JSON)

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

لقد قمت بتصدير قيم المفاتيح من متجر App Configuration اعتبارا من 28 يوليو 2022، الساعة 12 صباحا، مع بدء TestApp: أسماء المفاتيح والتسمية prod، إلى متجر App Configuration آخر. تم اقتطاع جميع قيم المفاتيح التي تم تصديرها ببادئة TestApp:المفتاح ، وتعيين التسمية new ونوع application/jsonالمحتوى.

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

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

   المعلمة	‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫الوَصف‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎	مثال
   --name	أدخل اسم متجر App Configuration الذي يحتوي على قيم المفاتيح التي تريد تصديرها.	my-app-config-store
   --destination	أدخل appconfig للإشارة إلى أنك تقوم بتصدير البيانات إلى متجر App Configuration.	appconfig
   --dest-name	أدخل اسم متجر App Configuration الذي تريد تصدير البيانات إليه.	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 App Service

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

إشعار

تصدير علامات الميزات إلى App Service غير مدعوم.

بوابة

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

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

   

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

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

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

   المعلمة	‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫الوَصف‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎	مثال
   وضع التحديد	حدد ما إذا كنت تريد التصدير من قيم المفاتيح العادية، وهو الخيار الافتراضي، أو من لقطة.	افتراضي
   عامل تصفية المفتاح	تستخدم لتصفية قيم المفاتيح استنادا إلى اسم المفتاح للتصدير. إذا لم يتم تحديد أي مفاتيح، فستكون جميع المفاتيح مؤهلة.	يبدأ ب TestApp:
   في وقت محدد	اختياري. املأ هذا الحقل لتصدير قيم المفاتيح من نقطة زمنية محددة في مخزن التكوين المحدد. إذا تركت فارغة ، تعيينها افتراضيا على النقطة الزمنية الحالية لقيم المفاتيح.	28/07/2022 12:00:00 ص
   من الملصق	حدد تسمية واحدة لتصدير القيم الرئيسية المقترنة بهذه التسمية.	همز

5. حدد مخارا وجهة واملأ النموذج بالمعلمات التالية:

   المعلمة	‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫الوَصف‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎	مثال
   Subscription	يتم تحديد اشتراكك الحالي افتراضيا.	اشتراكي
   مجموعة الموارد	حدد مجموعة موارد تحتوي على App Service حيث تريد تصدير التكوين.	مجموعة الموارد الخاصة بي
   Resource	حدد App Service حيث تريد تصدير التكوين.	خدمة التطبيق الخاص بي

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

   المعلمة	‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫الوَصف‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎	مثال
   إزالة البادئة	اختياري. إذا تم تحديدها، ستتم إزالة البادئة من أسماء المفاتيح لجميع قيم المفاتيح التي تم تصديرها والتي تحتوي عليها.	تطبيق الاختبار:

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

لقد قمت بتصدير قيم المفاتيح من متجر App Configuration اعتبارا من 28 يوليو 2022، الساعة 12 صباحا، مع أسماء المفاتيح التي تبدأ ب TestApp: والتسمية prod، إلى إعدادات التطبيق لمورد App Service. تم اقتطاع البادئة TestApp: من أسماء المفاتيح التي تم تصديرها.

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

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

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

   المعلمة	‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫الوَصف‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎	مثال
   --name	أدخل اسم متجر App Configuration الذي يحتوي على قيم المفاتيح التي تريد تصديرها.	my-app-config-store
   --destination	أدخل appservice للإشارة إلى أنك تقوم بتصدير البيانات إلى App Service.	appservice
   --appservice-account	أدخل معرف ARM الخاص بخدمة التطبيقات أو استخدم اسم خدمة التطبيقات، إذا كان في نفس الاشتراك ومجموعة الموارد مثل تكوين التطبيق.	/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" إلى تطبيق App Service وقم بقص البادئة "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 export.

رسائل خطأ

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

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

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

التكامل مع مسار CI/CD