إدارة حاويات Fluid
الحاوية هي وحدة التخزين الذرية في خدمة Azure Fluid Relay وتمثل البيانات المخزنة من جلسة عمل Fluid، بما في ذلك العمليات واللقطات. يستخدم وقت تشغيل Fluid الحاوية لإعادة ترطيب حالة جلسة عمل Fluid عند انضمام المستخدم للمرة الأولى أو إعادة الانضمام بعد المغادرة.
عند إنشاء تطبيق باستخدام إطار عمل Fluid، هناك العديد من الأشياء التي تحتاج إلى حسابها فيما يتعلق بإنشاء الحاوية وإدارتها، كما هو ملخص في هذا الرسم التخطيطي.
المفاهيم الرئيسية
أذونات الحاوية
في معظم الحالات، سيرغب المطورون في إدارة مخزون الحاويات وأذونات الحاوية. وهذا يشمل معلومات حول من لديه حق الوصول إلى الحاويات بالإضافة إلى بيانات التعريف مثل الاسم المألوف للحاوية.
الوصول إلى الحاويات
تتم الإشارة إلى الحاويات بواسطة معرف الحاوية. قبل أن يتمكن المستخدم من إنشاء حاوية أو فتحها، يجب عليه طلب JWT الذي سيستخدمه وقت تشغيل Fluid عند الاتصال بخدمة Azure Fluid Relay. يمكن لأي عملية ذات JWT صالحة الوصول إلى حاوية. تقع على عاتق المطور مسؤولية إنشاء JWTs للوصول إلى الحاوية، ما يضعهم في التحكم في منطق العمل للتحكم في الوصول حسب الاقتضاء للسيناريو الخاص بهم. لا تعرف خدمة Azure Fluid Relay المستخدمين الذين يجب أن يكون لديهم حق الوصول إلى حاوية. لمزيد من المعلومات حول هذا الموضوع، راجع عقد الرمز المميز Azure Fluid Relay
إشعار
يتوافق معرف مستند الحقل JWT مع معرف حاوية Fluid.
تسمية الحاوية
تتم تسمية الحاويات بواسطة خدمة Azure Fluid Relay في وقت إنشاء الحاوية. يقوم الإجراء Create بإرجاع اسم حاوية في شكل GUID الذي يجب استخدامه لاحقا لفتح الحاوية. في معظم الحالات، سيرغب المطورون في تخزين معرف الحاوية GUID هذا، جنبا إلى جنب مع اسم مألوف، في مخزن البيانات الخاص بهم لتسهيل تدفقات اكتشاف الحاوية.
اكتشاف الحاوية
يتحمل المطورون مسؤولية أي خبرة ومنطق عمل يتعلق باكتشاف المستخدم للحاويات الموجودة. قد يتخذ هذا شكل قائمة قابلة للاستعراض من الحاويات استنادا إلى مشاركة المستخدم في جلسة عمل Fluid، أو المشاركة المباشرة للحاويات بين المستخدمين، أو التعيين البرمجي للحاويات إلى البيانات الاصطناعية أو العمليات الموجودة.
مثال على تدفق إنشاء الحاوية
في هذا المثال، يتم تحميل التطبيق/الصفحة ب JWT عام (غير مرتبط بحاوية معينة) سيستخدمه تطبيق العميل عندما يحين الوقت لإنشاء حاوية جديدة.
يستخدم التطبيق من جانب العميل واجهة برمجة تطبيقات إطار عمل Fluid لإنشاء حاوية جديدة في خدمة Azure Fluid Relay التي ينتج عنها كائن حاوية بمعرف حاوية معين حديثا. تتطلب التفاعلات الإضافية مع الحاوية JWT جديدا يحتوي على معرف الحاوية.
بمجرد إنشاء العميل للحاوية الجديدة، فإنه سيتم حفظ معرف الحاوية في بعض النظام الذي يعين الحاويات والمستخدمين لإدارة الأذونات. سيقود هذا النظام أي تجربة اكتشاف/استعراض للحاوية يريد المطور إنشاؤها لمستخدميه.
قبل التفاعل مع الحاوية، سيطلب العميل JWT خاص بحاوية سيتم استخدامه للمكالمات اللاحقة من وقت تشغيل إطار عمل Fluid إلى خدمة Azure Fluid Relay.
تصدير محتوى الحاوية
إذا كان أحد التطبيقات يخزن البيانات التي قد تحتاج إلى تصديرها من قبل المستخدمين النهائيين، يكون مطور التطبيق مسؤولا عن بناء وظيفة التصدير هذه إلى تطبيقه، باستخدام الحالة الحالية لحاوية Fluid كما هو ممثل في بنيات البيانات الموزعة المحددة في الحاوية. لمزيد من المعلومات حول الاتصال بالحاويات Fluid وفتحها، راجع: Containers (fluidframework.com). لمزيد من المعلومات حول سرد الحاويات وحذفها باستخدام واجهة برمجة تطبيقات مستوى التحكم، راجع: حذف حاويات Fluid في Microsoft Azure Fluid Relay Server.