تثبيت Docker لـ ArcGIS Notebook Server

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

إصدارات Docker

يتوفر Docker في إصدارين. Docker Desktop و Mirantis Container Runtime (Docker Engine-Enterprise سابقًا).

نظام التشغيل	إصدارDocker	نوع الصورة لوقت تشغيل Notebook (حاوية)	متطلبات إضافية
Windows Server 2019 Standard وDatacenter Windows Server 2022 Standard وDatacenter	Docker Desktop على Windows الإصدار 4.4.4 أو الإصدار الأحدث	Linux	Hyper-V مطلوب
Windows Server 2022 Standard وDatacenter	Mirantis Container Runtime الإصدار 20.10 أو الإصدار الأحدث	Windows إصدار تجريبي	Hyper-V اختياري. توجد قيود على الحد الأقصى لعدد الحاويات التي يمكن تشغيلها Hyper-V بمعزل عن Windows Server 2022 القياسي. راجع Windows FAQ للحصول على مزيد من المعلومات.

في ArcGIS Notebook Server 11.0، يكون Docker Desktop هو الإصدار المناسب للاستخدام مع Windows. يتيح لك هذا البرنامج بتشغيل ArcGIS Notebook Server.

ملاحظة:‏

في الإصدار ArcGIS Notebook Server 11.0، ArcGIS Notebook Server يدعم Mirantis Container Runtime لـ Windows Server باعتباره إصدار تجريبي. بالنسبة لهذا الإصدار، يوصى باستخدام ArcGIS Notebook Server مع Mirantis Container Runtime لأغراض الاختبار فقط.

لمزيد من المعلومات حول استخدام Mirantis Container Runtime مع ArcGIS Notebook Server في الإصدار 11.0، راجع Docker و ArcGIS Notebook Server.

ملاحظة:‏

Docker و Mirantis Container Runtime هما مكونات برامج تابعة لجهة أخرى، وقد لا يوفر هذا الموضوع العملية الكاملة لتثبيتها. راجع Docker ومواقع Mirantis Container Runtime للحصول على مزيد من المعلومات حول عمليات التثبيت.

تثبيت Docker Desktop

أكمل الخطوات التالية لتثبيت Docker Desktop:

1. تحقق من تثبيت Hyper-V على جهاز Windows الخاص بك عن طريق البحث عن تطبيق مدير Hyper-V. إذا لم يكن مثبتًا على الجهاز، فقم بتثبيته قبل المتابعة. راجع وثائق Microsoft التالية للتعرف على الخطوات:
   • إذا كان نظام التشغيل الخاص بك هو Windows Server 2022 أو Windows Server 2019، فراجع موضوع تثبيت دور Hyper-V على Windows Server.
   • إذا كان نظام التشغيل الخاص بك هو Windows 10، فراجع موضوع تثبيت Hyper-V على Windows 10.

   ArcGIS Notebook Server يتطلب تطبيق سطح المكتب Docker لـ Windows (الإصدار 4.4.4 أو الإصدار الأحدث).

2. في أحد المستعرضات، انتقل إلى صفحة تنزيل Docker Desktop (Windows) في متجر Hub الخاص بـ Docker.
3. سجّل الدخول إلى حساب Hub Docker الحالي، أو قم بالتسجيل للحصول على حساب جديد.
4. قم بتنزيل برنامج سطح المكتب Docker.
5. انقر نقرًا مزدوجًا فوق Docker for Windows Installer لتشغيله.
6. من على مربع حوار التكوين الخاص بالمُثبت، قم بإلغاء التأشير على استخدام WSL2 بدلاً من Hyper-V.
7. أغلق المُثبت عند انتهاء عمله.
8. انقر فوق زر Docker Desktop في قائمة البدء لبدء تشغيل Docker.
9. تحقق من بدء تشغيل Docker، باستخدام إحدى الطرق التالية:
   • تحقق من حالة أيقونة Docker في أدوات نظام Windows (الموجودة عادةً في الجانب الأيمن السفلي من شاشتك).
   • افتح نافذة مُوجه الأوامر وقم بتشغيل الأوامر التالية:
     docker version
     docker run hello-world

     يوفر الأمر الأول إصدار Docker على جهازك؛ بينما يتحقق الأمر الثاني من قدرة Docker على الوصول إلى صور الحاويات وتشغيلها.

تكوين إعدادات Docker

بعد تثبيت Docker على جهازك، قم بتعديل الإعدادات الموضحة أدناه.

تعديل الإعدادات العامة

ستستخدم واجهة Docker لبرمجة التطبيقات عن بُعد، والتي تتطلب استخدام المنفذ 2375. سيتم استخدام هذا المنفذ داخليًا فقط بواسطة ArcGIS Notebook Server وتجب حمايته من الاستخدام الخارجي.

1. انقر بزر الماوس الأيمن فوق زر Docker الموجود في أدوات نظام Windows، ثم انقر فوق الإعدادات.
2. في الصفحة العامة، حدد عرض البرنامج الخفي على tcp://localhost:2375 دون TLS.

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

3. قم بإلغاء التأشير على استخدام محرك يستند إلى WSL2 في حالة إذا كان محددًا

إعداد مشاركة الملف

يجب أن يتاح لحاوية Docker حق الوصول إلى محرك الأقراص المحلي الذي سيتم تكوينه كدليل مساحة العمل أو إلى دليل بيانات مخصص لخادم دفتر الملاحظات. نفّذ الخطوات الموضحة أدناه أثناء التثبيت الأولي، وكررها كلما تغيرت بيانات اعتماد حساب تشغيل كـ، أو إذا تغير حساب تشغيل كـ نفسه. إذا كنت قد أنشأت حسابًا أثناء تثبيت ArcGIS Notebook Server، فستتم إعادتك مرة أخرى إلى هذه الخطوة.

1. انقر بزر الماوس الأيمن فوق زر Docker الموجود في أدوات نظام Windows، ثم انقر فوق الإعدادات.
2. من قائمة الإعدادات، انقر فوق موارد > مشاركة ملف.
3. أضف مسار محرك الأقراص أو الدليل الذي سيُستخدَم لمساحة عمل ArcGIS Notebook Server أو لدليل البيانات المخصص.

   ملاحظة:‏

   إذا لم يكن دليل مساحة العمل أو دليل البيانات المخصصة موجودًا حاليًا - على سبيل المثال، C:\arcgisnotebookserver - فأنشئ موقع ArcGIS Notebook Server أو سجّل دليل بيانات قبل تنفيذ هذه الخطوة.

   ملاحظة:‏

   يدعم Docker لـ Windows فقط الدلائل المحلية على Windows التي ستتم مشاركتها مع حاويات Linux.

موارد متقدمة محدودة

يمكنك استخدام لوحة إعدادات Docker Desktop لتقييد الموارد المتوفرة لـ ArcGIS Notebook Server والحاويات التي تعمل على موقع الخادم الخاص بك.

1. انقر بزر الماوس الأيمن فوق زر Docker الموجود في أدوات نظام Windows، ثم انقر فوق الإعدادات. من قائمة الإعدادات، انقر فوق موارد > متقدمة.
2. اختياريًا، قم بتغيير الإعدادات التالية:
   • وحدات المعالجة المركزية (CPU)—عدد أنوية وحدة المعالجة المركزية المتوفرة للحاويات الموجودة على جهازك. افتراضيًا، يتم تعيين هذا على معالجين. يمكنك تحديث هذه القيمة بناءً على الموارد المتاحة على الجهاز وحدود وحدة المعالجة المركزية (CPU) التي تم تعيينها لأوقات تشغيل دفتر الملاحظات.
   • الذاكرة—حجم الذاكرة المتوفرة للحاويات الموجودة على جهازك. تم تعيين هذه القيمة افتراضيًا على 2 جيجابايت. ارفع هذه القيمة إلى 6 جيجابايت بحد أدنى. قد ترغب في زيادة هذه القيمة، بناءً على الموارد المتاحة على الجهاز وحدود الذاكرة التي تم تعيينها لأوقات تشغيل دفتر الملاحظات.
   • الذاكرة الظاهرية—يمكن استخدام مقدار مساحة القرص التي تستخدمها الحاويات للذاكرة في حالة الوصول إلى الحد المذكور أعلاه.
   • حجم صورة القرص—حجم صورة القرص. راجع هذه القيمة وحدثها حسب الحاجة في حالة تثبيت صور حاوية Docker للحصول على نتائج Notebooks تفيد بحدوث خطأ بسبب نفاد مساحة القرص.
   • موقع صورة القرص— الدليل الذي تُخزن فيه الحاويات والصور.

   ملاحظة:‏

   كرر هذه الخطوة في أي وقت تُجري فيه تحديث على وحدة المعالجة المركزية أو من موارد الذاكرة التي تم تكوينها لأوقات تشغيل دفتر الملاحظات.

3. عندما تكون راضيًا عن حدود الموارد التي قمت بتعيينها، انقر على تطبيق.

تثبيت Mirantis Container Runtime على Windows

تنبيه:

Mirantis Container Runtime على Windows يكون مدعوم باعتباره إصدار تجريبي لـ ArcGIS Notebook Server على Windows Server 2022. أثناء الاستخدام التجريبي، قد يكون لهذه الخصائص مشكلات معروفة في الأداء أو الجودة ولن تكون مدعومة بواسطة الدعم الفني لـ Esri. لا تقم بتمكين Hyper-V، إذ يعد غير مطلوب لتثبيت Mirantis Container Runtime على Windows Server 2022. لا تقم بتمكين ميزة الحاويات على الخادم المحلي قبل تثبيت Mirantis Container Runtime.

1. قم بإلغاء تثبيت أي إصدار سابق من Docker على جهازك.
2. اتبع الخطوات الموضحة في وثائق تثبيت MCR على Windows Server المقدمة من Mirantis.
3. تحقق من أنه تم تثبيت Mirantis Container Runtime بشكل صحيح وأنه قد تم تشغيله عن طريق استخدام الأمر التالي:

   docker run hello-world:nanoserver

4. وبمجرد الانتهاء، اتبع الخطوات التالية لتكوين Mirantis Container Runtime.

تكوين Mirantis Container Runtime

اتبع الخطوات التالية لتكوين Mirantis Container Runtime على جهازك.

1. قم بتمكين المنفذ 2375 لتتمكن من استخدام Docker واجهة برمجة التطبيقات عن بُعد.

   سيتم استخدام هذا المنفذ داخليًا فقط بواسطة ArcGIS Notebook Server وتجب حمايته من الاستخدام الخارجي.

   بصفتك مسؤولاً، افتح موجه الأوامر وأدخل الأمر التالي:

   sc config docker binpath= "\"C:\Program Files\docker\dockerd.exe\" --run-service -H tcp://0.0.0.0:2375 -H npipe://"

2. بصفتك مسؤولاً، افتح نافذة PowerShell وأدخل الأمر التالي:
   Restart-Service docker

بمجرد تثبيت مكون Docker، أعد تشغيل جهازك. يجب إعادة تشغيل الجهاز في كل مرة تقوم فيها بتثبيت مكون Docker أو ترقيته.

أنت الآن جاهز لتثبيت ArcGIS Notebook Server على جهازك.