تمديد Notebook Runtime

يتضمن ArcGIS Notebook Server وقتي تشغيل Notebook Runtime (مجموعات من وحدات Python). يتم توفير أوقات التشغيل هذه لمستخدمي دفاتر الملاحظات من خلال صور الحاوية، التي يتم تطبيقها على كل حاوية يتم تشغيلها في موقع الخادم.

يتضمن كل من وقتي تشغيل Standard وAdvanced ArcGIS API for Python ومجموعة متنوعة من وحدات Python التي يمكن استخدامها لعلوم البيانات والتحليل المكاني وإدارة المحتوى والإدارة. يتضمن Advanced Runtime أيضًا ArcPy.

راجع قائمة مكتبات Python المتاحة

في بعض الحالات، قد يحتاج مؤلفو دفاتر الملاحظات إلى وحدات أو إصدارات محددة من الوحدات غير المضمنة في وقتي التشغيل هذين. يمكنك الوصول إلى وحدات Python في ArcGIS Notebook Server بالطرق التالية:

• قم بتثبيت وحدة Python نمطية أثناء جلسة Notebook. هذا يجعل الوحدة متاحة للاستخدام في Notebook هذا.
• قم بتمديد صورة حاوية Esri لتضمين مكتبات Python إضافية في وقت تشغيل مخصص. ستوفر صورة الحاوية التي تنشئها وقت التشغيل الممتد لجميع مؤلفي Notebook في موقعك.

تثبيت الوحدات النمطية أثناء جلسة

يمكن لمؤلفي Notebook إجراء وحدات Python أو إصدارات الوحدات، غير المضمنة سواء في وقت التشغيل المتاح للاستخدام خلال جلسة Notebook باستخدام أنظمة إدارة حزمة conda. يوصى باستخدام conda، لأن ArcGIS Notebook Server يستخدمه لإدارة الوحدات.

يثبت هذا النهج الوحدة المطلوبة لمدة جلسة Notebook. بمجرد إغلاق Notebook أو إنهاء الحاوية التي تنتمي إلى المستخدم، فلن تصبح الوحدة متوفرة. لتثبيت الوحدات باستخدام هذه الطريقة، يجب أن يكون لديك اتصال بالإنترنت لقناة conda.

ملاحظة:‏

يتم تضمين conda في نوعين من وقت تشغيل Notebook. لا حاجة لتثبيته.

لتثبيت حزمة scrapy أثناء جلسة، على سبيل المثال، قم بتشغيل خلية Notebook باستخدام أحد الأوامر التالية، على أساس نظام إدارة الحزمة الذي تستخدمه:

استخدام نظام إدارة حزمة conda

!conda install --yes scrapy

لاستخدام إصدار مختلف من وحدة Python في Notebook Runtime الذي تعمل عليه، فحدد رقم الإصدار في الأمر.

يجب أن تعيد تشغيل kernel بعد تشغيل أمر condaلكي تتوفر حزمتك الجديدة.

على سبيل المثال، تتوفر حزمة معينة في كلا Notebook Runtime في الإصدار 1.5، لكنك تريد استخدام أداة مقدمة في الإصدار 1.6. لتوفير الإصدار 1.6 من الحزمة أثناء جلسة دفتر الملاحظات، قم بتشغيل خلية دفتر ملاحظات باستخدام أحد الأوامر التالية، على أساس نظام إدارة الحزمة الذي تستخدمه:

استخدام نظام إدارة حزمة conda

!conda install --yes <package name>==1.6

بناء صورة حاوية مخصصة

لإجراء تغييرات دائمة على Notebook Runtime، يمكنك إنشاء صورة حاوية مخصصة للاستخدام في موقع. ينشئ سير العمل التالي، الذي يتطلب امتيازات إدارية، صورة مخصصة ويكوِّن ArcGIS Notebook Server لاستخدامه.

استخدم أيًا من Notebook Runtime (Standard أو Advanced) كنقطة بداية. بمجرد إنشاء وقت التشغيل المخصص، يمكنك تسجيله باعتباره وقت تشغيل جديد في موقعك.

1. تثبيت وتكوين ArcGIS Notebook Server.
2. سجل الدخول إلى دليل مسؤول ArcGIS Notebook Server كمسؤول.

   يتم تنسيق عنوان URL كـ https://notebookserver.domain.com:11443/arcgis/admin/.

3. انقر على Notebook > Runtime، ثم حدد Notebook Runtime الذي تريد تمديده لصورتك المخصصة.

   في صفحة مورد وقت التشغيل، لاحظ قيمة imageId لوقت التشغيل هذا. ستقوم بتضمين هذه القيمة في الخطوة التالية.

4. أنشئ Dockerfile الذي يضيف وحدات Python المطلوبة إلى الصورة المخصصة.

   Dockerfile عبارة عن ملف نصي بسيط من التعليمات لبناء صورة حاوية Docker. اتبع مستندات Dockerfile للحصول على المعلومات وأفضل الممارسات.

   في هذا المثال، ستضيف حزمة Python لتصور البيانات graphviz إلى Advanced Notebook Runtime. تعمل كتلة التعليمة البرمجية التالية في Dockerfile على توجيه Docker للوصول إلى Advanced Runtime باستخدام اسم repository الخاص به وtag، ولتثبيت graphviz في نطاق وقت التشغيل. يمكنك الحصول على اسم repository وtag باستخدام الأمر docker images على جهاز مثبت عليه ArcGIS Notebook Server وقت التشغيل هذا. يُوصى باستخدام الأمر conda clean لتقليل حجم الملف.

   استخدم الأمر docker images للحصول على اسم الصورة (المستودع) وعلامة لوقت تشغيل دفتر ملاحظات موجود.

   
   docker images
   
   REPOSITORY                        TAG                 IMAGE ID            CREATED             SIZE
   arcgis-notebook-python-advanced   10.8.1.14362        e46a81f69ea0        12 months ago       12.4GB
   arcgis-notebook-python-standard   10.8.1.14362        106a660a4d0b        12 months ago       7.51GB

   أنشئ وقت تشغيل مخصص عن طريق إضافة حزمة Python لتصور البيانات graphviz إلى وقت تشغيل دفتر الملاحظات المتقدم.

   # Specify the existing notebook runtime imageId as FROM
   FROM arcgis-notebook-python-advanced:10.8.1.14362
   
   # Use RUN to issue a command to install, then clean
   RUN conda install graphviz \
     && conda clean -y -a

5. احفظ Dockerfile الخاص بك على الجهاز، في مجلد جديد يحتوي فقط على Dockerfile.
6. أنشئ صورة حاوية مخصصة باستخدام الأمر Docker.

   سوف تحتوي هذه الصورة على وقت تشغيل جديد كما هو محدد في Dockerfile. افتح نافذة موجه الأوامر وشغّل أمر باستخدام بناء الجملة التالي:

   cd C:\DockerfileDir
   docker build -t arcgis-notebook-python-advanced-custom:10.8.1.14362 -f Dockerfile .

   ملاحظة:‏

   تأكد من تضمين النقطة في نهاية الأمر.

   عند تشغيل الأمر، سيقوم Docker ببناء صورة الحاوية الجديدة. سيكون السطر الأخير في إخراج الأمر Successfully built <imageId> مع قيمة معرف مختصر للصورة الجديدة. يجب إمداد موقع ArcGIS Notebook Server الخاص بك بقيمة imageId الكاملة.

7. شغّل الأمر التالي في نافذة موجه الأوامر للحصول على قيمة معرف الصورة:

   docker inspect <imageId>

   إذا كان لديك موقع Notebook Server لجهاز واحد، فيمكنك تخطي الخطوات من 8 إلى 10. إذا كان لديك موقع Notebook Server لأجهزة متعددة، فأكمل الخطوات من 8 إلى 10.

8. احفظ صورة Docker المخصصة كملف *.tar باستخدام docker save.

   افتح نافذة أوامر على جهاز Notebook Server حيث تم تثبيت صورة وقت التشغيل المخصصة وشغّل الأمر التالي لحفظ صورة وقت التشغيل المخصصة كملف *.tar.

    docker save arcgis-notebook-python-advanced-custom:10.8.1.14362 > arcgis-notebook-python-advanced-custom.tar

9. على كل جهاز مثبت عليه Notebook Server، قم بتحميل صورة وقت التشغيل المخصصة باستخدام أداة ArcGIS Notebook Server المساعدة لما بعد التثبيت.
   1. افتح موجه الأوامر كمسؤول.
   2. غيّر الدلائل إلى مجلد الأداة المساعدة لما قبل التثبيت ArcGIS Notebook Server.

      المسار الافتراضي هو C:\Program Files\ArcGIS\NotebookServer\tools\postInstallUtility

   3. قم بتثبيت صورة Docker المخصصة من خلال تحديد مسار ملفها.

       PostInstallUtility.bat -l <path of .tar Custom Docker image>

10. كرر الخطوة 9 في كل جهاز مشارك في موقع ArcGIS Notebook Server.

صورتك المخصصة مبنية الآن ولديك قيمتها imageId الكاملة، والتي سوف تستخدمها لتسجيلها مع موقع ArcGIS Notebook Server في القسم التالي.

تسجيل وقت تشغيل جديد في Manager

بدءًا من 10.8، يمكنك استخدام مدير ArcGIS Notebook Server لتسجيل وقت تشغيل مخصص قمت بإنشائه.

1. سجّل الدخول إلى بوابة ArcGIS Enterprise الإلكترونية كمسؤول وافتح ArcGIS Notebook Server Manager.
2. افتح صفحة الإعدادات وانقر على أوقات التشغيل.
3. انقر فوق تسجيل وقت التشغيل لفتح مربع حوار التسجيل.
4. حدد القيم المناسبة لإكمال التسجيل.

   المعلمة	التفاصيل
   الاسم	سلسلة لتمثيل وقت التشغيل الجديد، مثل "Notebook Custom Runtime Python 3".
   نوع الحاوية	القيمة الصالحة الوحيدة هي docker.
   الحد الأقصى لوحدة المعالجة المركزية	الحد الأقصى لعدد وحدات وحدة المعالجة المركزية المراد استخدامها لكل حاوية.
   مطلوب امتيازات متقدمة	قم بتشغيل زر التبديل إذا كان وقت التشغيل يتطلب امتياز دفاتر الملاحظات المتقدمة.
   مُعرّف الصورة	معرف كامل (غير مقتطع) لصورة Docker الجديدة، عند إنشائه.
   وقت تشغيل Docker	تنطبق فقط على أوقات تشغيل GPU في بيئات Linux.
   الحد الأقصى للذاكرة	الحد الأقصى لحجم الذاكرة المراد استخدامها لكل حاوية.
   وحدة الحد الأقصى للذاكرة	الوحدة المحددة بواسطة معلمة maxMemory.
   الحد الأقصى لذاكرة التبديل	الحد الأقصى لمقدار ذاكرة التبديل المتوفرة لكل حاوية إذا وصلت إلى حد maxMemory.
   وحدة الحد الأقصى لذاكرة التبديل	الوحدة المحددة بواسطة معلمة maxSwapMemory.
   ذاكرة مشتركة	مقدار الذاكرة المشارَكة المتوفرة لكل حاوية.
   وحدة الذاكرة المشتركة	الوحدة المحددة بواسطة معلمة sharedMemory.
   بيان المكتبة	ملف *.json (بترميز UTF-8 أو ANSI) يحتوي على قائمة مكتبات Python في وقت التشغيل.

   ملاحظة:‏

   لإنشاء ملف manifest.json، افتح نافذة PowerShell على جهاز ArcGIS Notebook Server الذي تم عليه تثبيت صورة وقت تشغيل دفتر الملاحظات المخصص وقم بتشغيل أحد الأوامر التالية، اعتمادًا على ما إذا كنت تستخدم حاويات Windows أو Linux.

   في حاويات Windows، استخدم الأمر التالي:

   $ID = docker run -d -it <custom_runtime_image_ID> cmd; docker exec -it $ID powershell "conda list --json >> C:\arcgis\home\manifest.json"; docker cp $ID/:C:\arcgis\home\manifest.json <existing_folder_path>; docker kill $ID; docker rm -f $ID;

   في حاويات Linux، استخدم الأمر التالي:

   $ID = docker container run -d --rm -it -v /:/host <custom_runtime_image_ID> /bin/bash; docker exec -it $ID /opt/conda/bin/conda list --json >> ~\Desktop\manifest.json; docker kill $ID

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

إنشاء صورة وقت تشغيل مخصصة باستخدام الحزمة الأساسية للتعلم الشامل الخاصة بـ ArcGIS

يدعم ArcGIS API for Python إمكانية توجيه نماذج التعلم الشامل المتعددة التي يدعم كل منها نماذج الأساس الخاصة بها (العناصر الأساسية). توفر حزمة التعريف arcgis_dl_backbones conda الدعم للمستخدمين غير المتصلين عن طريق وضع العناصر الأساسية تلقائيًا في المواقع الضرورية، مما يلغي الحاجة إلى تنزيل العناصر الأساسية من الإنترنت عند تجربة نماذج التعلم الشامل باستخدام ArcGIS. اتبع الخطوات التالية لإنشاء صورة تشغيل مخصصة تتضمن حزمة تعريف arcgis_dl_backbones conda.

1. أنشئ مجلدًا جديدًا على جهاز ArcGIS Notebook Server.

   يُعد /data/custom مثالاً على الموقع

2. قم بتنزيل حزمة arcgis_dl_backbones.

   راجع موضوع التثبيت الإضافي للبيئة غير المتصلة للحصول على المزيد من المعلومات.

3. استخرج حزمة arcgis_dl_backbones-2.0.1-py_0.tar.bz2 إلى المجلد الذي أنشأته.
4. أنشئ ملف Docker باستخدام المحتوى التالي في المجلد الذي أنشأته.
   FROM arcgis-notebook-python-standard:11.1.0.42869
   USER root
   RUN mkdir -p /home/user/DUMP/arcgis_dl_backbones-2.0.1
   USER $NB_UID
   WORKDIR /home/user/DUMP/arcgis_dl_backbones-2.0.1
   COPY arcgis_dl_backbones-2.0.1-py_0.tar.bz2 /home/user/DUMP/arcgis_dl_backbones-2.0.1
   RUN conda install --offline arcgis_dl_backbones-2.0.1-py_0.tar.bz2 -y
   RUN conda clean -y -a
   WORKDIR $HOME

5. انتقل إلى المجلد الذي أنشأته وأنشئ صورة حاوية مخصصة باستخدام أمر Docker التالي.
   docker build -t arcgis-notebook-python-standard-custom:11.1.0.42869 -f /data/custom/Dockerfile .

6. اتبع الخطوات من 7 إلى 10 في قسم تسجيل وقت تشغيل جديد في Manager بالأعلى لتثبيت صورة وقت التشغيل هذه في أجهزة Notebook Server لديك.

تحديث وقت التشغيل المخصص بعد ترقية ArcGIS Notebook Server

اتبع الخطوات الموضحة أدناه لتحديث وقت التشغيل المخصص بعد ترقية ArcGIS Notebook Server.

1. أنشئ صورة لوقت التشغيل المخصص باستخدام الإصدار الجديد من صورة وقت تشغيل دفتر الملاحظات.
2. استخدم الأداة المساعدة لما بعد تثبيت خادم دفتر الملاحظات لتثبيت صورة وقت التشغيل الجديدة على كل أجهزة خادم دفتر الملاحظات.
3. سجِّل وقت التشغيل الجديد باستخدام مدير ArcGIS Notebook Server.
4. في صفحة تفاصيل العناصر الخاصة بكل دفتر ملاحظات يستخدم وقت التشغيل المخصص، انقر فوق الإعدادات.
5. تحقق من وقت التشغيل وقم بتحديثه إلى وقت التشغيل المخصص المسجّل حديثًا لكل جهاز يستخدم وقت التشغيل المخصص.
6. بمجرد التأكد من أن صورة وقت التشغيل الجديدة تعمل، تجاهل الإصدار السابق من وقت التشغيل المخصص عن طريق إلغاء تسجيل وقت التشغيل وإزالة صورة وقت التشغيل من كل جهاز من أجهزة خادم دفتر الملاحظات.

لإعادة أوقات التشغيل في موقع ArcGIS Notebook Server إلى الإعدادات الأصلية، استخدم عملية استعادة أوقات تشغيل المصنع في دليل المسؤول. يتوفر هذا على https://notebookserver.domain.com:11443/arcgis/admin/notebooks/runtimes/restore، وسيستعيد فقط أوقات تشغيل المصنع للإصدار الحالي لموقعك.