إعداد نظام مجموعة Linux Service Fabric عبر WSL2 على جهاز مطور Windows لديك
يغطي هذا المستند كيفية إعداد نظام مجموعة Linux Service Fabric محلية عبر WSL2 على جهاز تطوير Windows. يعد إعداد نظام مجموعة Linux محلي مفيداً لاختبار التطبيقات المستهدفة لأنظمة مجموعات Linux بسرعة ولكن يتم تطويرها على جهاز Windows.
المتطلبات الأساسية
لا تعمل أنظمة مجموعات Service Fabric المستندة إلى Linux مباشرة على Windows، ولكن لتمكين النماذج الأولية عبر الأنظمة الأساسية، قمنا بتوفير طريقة لنشر نظام مجموعة Service Fabric داخل توزيع Linux عبر WSL2 (نظام Windows الفرعي لـ Linux) لنظام التشغيل Windows.
قبل البدء، ستحتاج إلى:
- إعداد WSL2 في Windows وضمان توفر WSL 2 كإصدار افتراضي
- إعداد توزيع Ubuntu 18.04 Linux من Microsoft Store أثناء إعداد WSL2
تلميح
لتثبيت WSL2 على جهاز Windows، اتبع الخطوات الواردة في وثائق WSL. بعد التثبيت، يرجى التأكد من تثبيت Ubuntu-18.04، وجعله توزيعك الافتراضي ويجب أن يكون قيد التشغيل.
إعداد Service Fabric SDK داخل توزيع Linux
لا يمكن إجراء Service Fabric في توزيع WSL2 Linux بالطريقة التي يتم بها ذلك في نظام التشغيل Linux القياسي. نظرًا لأن systemd بالشكل PID1 لا يعمل داخل الجهاز الظاهري وsystemd بالشكل PID1 هو شرط أساسي ليعمل SF SDK بنجاح. لتمكين systemd بالشكل PID1، يتم استخدام systemd-genie كحل بديل. يمكن العثور على مزيد من التفاصيل حول systemd-genie في تثبيت البرنامج النصي إعداد systemd genie وتغطي خطوات التثبيت اليدوي تثبيت systemd-genie وservice fabric sdk على حد سواء.
تثبيت البرنامج النصي
للراحة، يتم توفير برنامج نصي لتثبيت حزمة SDK الشائعة لـ Service Fabric جنبًا إلى جنب مع سطر الأوامر sfctl. يفترض تشغيل البرنامج النصي موافقتك على تراخيص جميع البرامج التي يتم تثبيتها. بدلاً من ذلك، يمكنك تشغيل خطوات التثبيت اليدوي في القسم التالي، والتي ستقدم التراخيص المقترنة والمكونات التي يتم تثبيتها.
بعد تشغيل البرنامج النصي بنجاح، يمكنك التخطي إلى إعداد نظام مجموعة محلية.
sudo curl -s https://raw.githubusercontent.com/Azure/service-fabric-scripts-and-templates/master/scripts/SetupServiceFabric/SetupServiceFabric.sh | sudo bash
تثبيت يدوي
للتثبيت اليدوي لوقت تشغيل Service Fabric ووحدة SDK الشائعة، اتبع بقية هذا الدليل.
افتح terminal.
سجل الدخول إلى توزيع WSL2 Linux
بادر بإعداد systemd-genie كما هو مذكور في إعداد systemd genie (إذا تم بالفعل إعداد systemd-genie، يمكنك الانتقال إلى الخطوة التالية)
ادخل إلى مساحة اسم genie باستخدام genie -s
داخل مساحة اسم genie، يمكن أيضًا تثبيت SF SDK كما هو مذكور ضمن خطوات تثبيت البرنامج النصي أو التثبيت اليدوي في إعداد نظام مجموعة محلية من linux
قم بتوفير امتيازات sudo للمستخدم الحالي عن طريق إدخال
<USERNAME\> ALL = (ALL) NOPASSWD:ALL
في /etc/sudoers
إعداد نظام مجموعة محلية
يوصى بإدارة Service Fabric داخل جهاز WSL2 الظاهري من windows المضيف
تثبيت Service Fabric SDK (الإصدار 6.0 أو أعلى) في مضيف Windows
في Windows، يمكن إدارة نظام المجموعة باستخدام أداة ServiceFabricLocalClusterManager المتوفرة كجزء من SF SDK
يتم تمكين خيار إدارة نظام مجموعة Linux المحلية فقط عندما يكون أ- جهاز WSL2 الظاهري قيد التشغيل، ب- يتم تثبيت حِزم Systemd-genie وservicefabricruntime وservicefabricsdkcommon بشكل صحيح داخل الجهاز الظاهري وج- Systemd-genie في حالة التشغيل. يمكنك إعداد نظام مجموعة Linux المحلية أو التبديل إليها من هذه الأداة.
هناك طريقة أخرى لإعداد نظام مجموعة Linux وهي النشر باستخدام البرامج النصية لإعداد نظام المجموعة المقدمة كجزء من SF SDK.
افتح مستعرض ويب وانتقل إلى Service Fabric Explorer
http://localhost:19080
. عند بدء تشغيل نظام المجموعة، سترى لوحة معلومات Service Fabric Explorer. قد يستغرق إعداد نظام المجموعة عدة دقائق. إذا فشل المستعرض في فتح عنوان URL أو لم يعرض Service Fabric Explorer نظام المجموعة، فانتظر لبضع دقائق وأعِد المحاولة. يمكنك أيضًا رؤية نظام المجموعة في ServiceFabricExplorer المتوفر في SF SDK.بمجرد تشغيل نظام المجموعة، يمكنك الاتصال بنظام المجموعة المحلية في PowerShell Visual Studio.
التثبيت اليدوي باستخدام ServiceFabric المخصص وحزمة ServieFabricSdkCommon Debian
لتثبيت Service Fabric يدويًا من حِزم debian المخصصة أو التي تم تنزيلها، اتبع بقية هذا الدليل.
افتح terminal.
سجل الدخول إلى توزيع WSL2 Linux
استنسخ ملف الإعداد
sudo curl -s https://raw.githubusercontent.com/Azure/service-fabric-scripts-and-templates/master/scripts/SetupServiceFabric/SetupServiceFabric.sh > SetupServiceFabric.sh
- اجعل الملف قابلاً للتنفيذ
sudo chmod +x SetupServiceFabric.sh
- شغل البرنامج النصي للإعداد مع مسار حِزم debian المحلية. تأكد من أن المسارات المتوفرة صالحة. وفيما يلي مثال على ذلك:
sudo ./SetupServiceFabric.sh --servicefabricruntime=/mnt/c/Users/testuser/Downloads/servicefabric.deb --servicefabricsdk=/mnt/c/Users/testuser/Downloads/servicefabric_sdkcommon.deb
القيود المعروفة
فيما يلي القيود المعروفة لنظام المجموعة المحلية التي تعمل في توزيع Linux:
- حاليًا يتم دعم توزيع Ubuntu-18.04 فقط.
- للحصول على تجربة سلسة مع إدارة نظام المجموعة المحلية وVisual Studio، يوصى بإدارة نظام المجموعة من البرامج النصية PowerShell أو LocalClusterManager في مضيف Windows.
الأسئلة المتداولة
ما هي توزيعات linux المدعومة لإعداد نظام مجموعة SF المحلية؟
حاليًا، يتم دعم Ubuntu-18.04 فقط لنظام مجموعة linux المحلية.هل يمكن تشغيل نظام مجموعة Windows وLinux SF بالتوازي مع إعداد WSL2؟
لا، في وقت واحد يمكن تشغيل نظام مجموعة محلية واحدة فقط إما في المضيف أو في الجهاز الظاهري للضيف.كيف يتم نشر عقدة واحدة لنظام مجموعة linux محلية؟
يمكن نشر عقدة واحدة أو نظام مجموعة linux محلية من خمس عُقد من إدارة نظام المجموعة المحلية من خيارات القائمة. أثناء النشر من البرنامج النصي للإعداد، يتم توزيع نظام مجموعة من خمس عُقد بشكل افتراضي ويجب تمرير نظام مجموعة من عقدة واحدة CreateOneNodeCluster.كيف يتم الاتصال بنظام مجموعة Linux المحلية في PowerShell وVisual Studio؟
إذا كانت مجموعة Linux المحلية قيد التشغيل، فيجب أن يتصل cmdlet لـ connect-servicefabriccluster تلقائيًا بنظام المجموعة هذا. ستكتشف Visual Studio المماثلة نظام المجموعة المحلية هذا تلقائيًا. يمكن أيضًا توصيل هذه المجموعة من خلال توفير نقطة نهاية المجموعة في PowerShell أو visual studio.أين توجد بيانات نظام مجموعة SF لنظام مجموعة linux المحلية؟
في حالة استخدام توزيع Ubuntu-18.04، توجد بيانات SF في \wsl$\Ubuntu-18.04\home\sfuser\sfdevcluster من مضيف Windows.
الخطوات التالية
- تعرف على خيارات دعم Service Fabric