اللقطات
اللقطة هي مجموعة فرعية مسماة وغير قابلة للتغيير لقيم مفاتيح متجر App Configuration. يتم اختيار قيم المفاتيح التي تشكل لقطة أثناء وقت الإنشاء من خلال استخدام عوامل تصفية المفتاح والتسمية. بمجرد إنشاء لقطة، يتم ضمان بقاء قيم المفاتيح داخل دون تغيير.
تتوفر نظرة عامة موجزة في هذا الفيديو، مع تمييز ثلاثة أسباب تجعل اللقطات مفيدة لك.
النشر بأمان باستخدام اللقطات
تم تصميم اللقطات لنشر تغييرات التكوين بأمان. يمكن أن يؤدي نشر تغييرات التكوين الخاطئة في بيئة قيد التشغيل إلى حدوث مشكلات مثل تعطيل الخدمة وفقدان البيانات. لتجنب مثل هذه المشكلات، من المهم أن تكون قادرا على فحص تغييرات التكوين قبل الانتقال إلى بيئات الإنتاج. إذا حدثت مثل هذه المشكلة، فمن المهم أن تكون قادرا على التراجع عن أي تغييرات في التكوين الخاطئ من أجل استعادة الخدمة. يتم إنشاء لقطات لإدارة هذه السيناريوهات.
يجب نشر تغييرات التكوين بطريقة متناسقة ومتحكم فيها. يمكن للمطورين استخدام اللقطات لتنفيذ الإطلاق المتحكم به. التغيير الوحيد المطلوب في تطبيق لبدء الإطلاق المتحكم به هو تحديث اسم اللقطة التي يشير إليها التطبيق. مع انتقال التطبيق إلى الإنتاج، هناك ضمان بأن التكوين في اللقطة المشار إليها يظل دون تغيير. يحمي هذا الضمان ضد أي تغيير في اللقطة من الإعدادات غير المتوقعة التي تشق طريقها إلى الإنتاج. تجعل عدم قابلية تغيير اللقطات وسهولة الرجوع إليها أمرا بسيطا لضمان طرح المجموعة الصحيحة من تغييرات التكوين بأمان.
سيناريوهات استخدام اللقطات
الإطلاق المتحكم به: اللقطات مناسبة تماما لدعم الإطلاق المتحكم فيه نظرا لطبيعتها غير القابلة للتغيير. عندما يستخدم المطورون اللقطات للتكوين، يمكنهم أن يكونوا واثقين من أن التكوين يظل دون تغيير مع تقدم الإصدار خلال مراحل مختلفة من الإطلاق.
تكوين Last Known Good (LKG): يمكن استخدام اللقطات لدعم ممارسات النشر الآمنة للتكوين. باستخدام اللقطات، يمكن للمطورين التأكد من توفر تكوين Last Known Good (LKG) للرجوع إلى الحالة السابقة إذا كانت هناك أي مشكلة أثناء النشر.
تعيين إصدار التكوين: يمكن استخدام اللقطات لإنشاء محفوظات إصدار لإعدادات التكوين للمزامنة مع إصدارات الإصدار. يمكن مقارنة الإعدادات التي تم التقاطها في كل لقطة لتحديد التغييرات بين الإصدارات.
التدقيق: يمكن استخدام اللقطات لأغراض التدقيق والتوافق. يمكن للمطورين الاحتفاظ بسجل تغييرات التكوين بين الإصدارات باستخدام اللقطات للإصدارات.
بيئات الاختبار والتقسيم المرحلي: يمكن استخدام اللقطات لإنشاء بيئات اختبار وتقسيم مرحلي متسقة. يمكن للمطورين التأكد من استخدام نفس التكوين عبر بيئات مختلفة، باستخدام نفس اللقطة، والتي يمكن أن تساعد في تصحيح الأخطاء والاختبار.
تكوين تكوين العميل المبسط: عادة ما يحتاج عملاء App Configuration إلى مجموعة فرعية من قيم المفاتيح من مثيل App Configuration. للحصول على مجموعة من قيم المفاتيح المطلوبة، تحتاج إلى منطق الاستعلام مكتوب في التعليمات البرمجية. نظرا لأن اللقطات تدعم توفير عوامل التصفية أثناء وقت الإنشاء، فإنه يساعد على تبسيط تكوين العميل لأن العملاء يمكنهم الآن الرجوع إلى مجموعة قيم المفاتيح التي يحتاجونها بالاسم.
عمليات اللقطة
نظرا لأن اللقطات هي كيانات غير قابلة للتغيير، يمكن إنشاء اللقطات وأرشفةها فقط. لا يمكن الحذف أو الإزالة أو التحرير.
إنشاء لقطة: يمكن إنشاء اللقطات عن طريق تحديد عوامل تصفية المفتاح والتسمية لالتقاط قيم المفاتيح المطلوبة من مثيل App Configuration. يتم تخزين قيم المفاتيح التي تمت تصفيتها كقطة بالاسم المقدم أثناء الإنشاء.
لقطة الأرشيف: أرشفة لقطة يضعها في حالة مؤرشفة. أثناء أرشفة اللقطة، فإنها لا تزال تعمل بكامل طاقتها. عند أرشفة اللقطة، يتم تعيين وقت انتهاء الصلاحية استنادا إلى فترة الاستبقاء التي تم تكوينها أثناء إنشاء اللقطة. إذا بقيت اللقطة في الحالة المؤرشفة حتى وقت انتهاء الصلاحية، فستختفي تلقائيا من النظام عند مرور وقت انتهاء الصلاحية. يتم استخدام الأرشفة للتخلص التدريجي من اللقطات التي لم تعد قيد الاستخدام.
استرداد اللقطة: يؤدي استرداد لقطة إلى إعادتها في حالة نشطة. في هذه المرحلة، لم تعد اللقطة خاضعة لانتهاء الصلاحية بناء على فترة الاستبقاء المكونة لها. الاسترداد ممكن فقط في فترة الاستبقاء بعد الأرشفة.
إشعار
يمكن تعيين فترة الاستبقاء فقط أثناء إنشاء لقطة. القيمة الافتراضية لفترة الاستبقاء هي 30 يوما للمتاجر القياسية و7 أيام للمتاجر المجانية.
متطلبات عمليات اللقطة
توضح الأقسام التالية بالتفصيل الأذونات المطلوبة لتنفيذ العمليات المتعلقة باللقطة باستخدام معرف Microsoft Entra ومصادقة HMAC.
إنشاء لقطة
لإنشاء لقطة في المتاجر باستخدام مصادقة Microsoft Entra، يلزم توفر الأذونات التالية. يحتوي دور مالك بيانات تكوين التطبيق بالفعل على هذه الأذونات.
Microsoft.AppConfiguration/configurationStores/keyvalues/readMicrosoft.AppConfiguration/configurationStores/snapshots/write
لإنشاء لقطة باستخدام مصادقة HMAC، يجب استخدام مفتاح وصول للقراءة والكتابة.
أرشفة لقطة واستردادها
لأرشفة و/أو استرداد لقطة باستخدام مصادقة Microsoft Entra، يلزم الحصول على الإذن التالي. دور مالك بيانات تكوين التطبيق لديه هذا الإذن بالفعل.
Microsoft.AppConfiguration/configurationStores/snapshots/archive/action
لأرشفة و/أو استرداد لقطة باستخدام مصادقة HMAC، يجب استخدام مفتاح وصول للقراءة والكتابة.
قراءة اللقطات وإدراجها
لسرد جميع اللقطات، أو الحصول على جميع قيم المفاتيح في لقطة فردية بالاسم، يلزم الإذن التالي للمتاجر التي تستخدم مصادقة Microsoft Entra. أدوار مالك البيانات وقارئ البيانات المضمنة لديها هذا الإذن بالفعل.
Microsoft.AppConfiguration/configurationStores/snapshots/read
بالنسبة للمتاجر التي تستخدم مصادقة HMAC، يمكن تنفيذ كل من عملية "قراءة اللقطة" (لقراءة قيم المفاتيح من لقطة) وتشغيل "لقطات القائمة" باستخدام مفاتيح الوصول للقراءة والكتابة أو مفاتيح الوصول للقراءة فقط.
اعتبارات وحدود الفوترة
يحتوي تكوين التطبيق على مستويين، مجاني وقياسي. تحقق من التفاصيل التالية للحصول على حصص اللقطة في كل مستوى.
المستوى المجاني: تحتوي هذه الطبقة على حصة تخزين لقطة تبلغ 10 ميغابايت. يمكن للمرء إنشاء أكبر عدد ممكن من اللقطات طالما أن إجمالي حجم التخزين لكافة اللقطات النشطة والمرشفة أقل من 10 ميغابايت.
المستوى القياسي: تحتوي هذه الطبقة على حصة تخزين لقطة تبلغ 1 غيغابايت. يمكن للمرء إنشاء أكبر عدد ممكن من اللقطات طالما أن إجمالي حجم التخزين لجميع اللقطات النشطة والمحفوظة أقل من 1 غيغابايت.
الحد الأقصى لحجم اللقطة هو 1 ميغابايت.