Install Docker Engine from binaries (Windows containers)

Introduced at 11.3, ArcGIS Notebook Server with Windows containers supports installing Docker Engine from binaries.

Requirements

Installing Docker Engine from binaries has the following requirements:

Operating system	Docker edition	Notebook runtime (Container) image type	Additional requirements
Windows Server 2022 Standard and Datacenter	Docker Engine - Community version 25.0.0 or later	Windows	Optionally, you can install Hyper-V. ملاحظة:‏ There are limitations to the maximum number of containers that can run with Hyper-V isolation on Windows Server 2022 Standard. See the Windows FAQ for more information.

Install Docker Engine from binaries

Complete the following steps to install Docker Engine from binaries:

1. Uninstall any previous version of Docker on your machine.
2. Disable the Containers feature on your local server if it is enabled.

   See the Microsoft documentation for more information.

3. Enable the Windows Containers feature by running the following command in Windows PowerShell with administrative privileges:

   Add-WindowsFeature Containers

4. Follow the prompts to restart your machine.
5. Verify the installation of the Containers feature by running the following command:

   Get-WindowsFeature Containers

6. Follow the instructions in the Install server and client binaries on Windows section in the Docker documentation.

   ملاحظة:‏

   Docker Engine from binaries does not update automatically. You must manually update to newer versions of Docker. See the Install Docker Engine from binaries documentation for more information on the limitations of using Docker from binaries in a production environment. Although this page recommends using Docker Desktop, ArcGIS Notebook Server with Windows Containers does not support Docker Desktop on Windows as a container engine.

7. Add the docker directory path, for example, C:\Program Files\docker, to the environment path variables.
8. Verify your installation and Docker daemon running status by running the following command:

   docker version

Configure Docker Engine

Complete the following steps to configure Docker Engine:

1. إذا لم يكن الحساب المستخدم لتثبيت ArcGIS Notebook Server جزءًا من مجموعة المسؤولين، قم باتباع الخطوات التالية:
   1. من قائمة ابدأ على جهاز Windows، افتح تطبيق إدارة الكمبيوتر.
   2. على الشريط الجانبي الأيسر، قم بتوسيع العنصر المستخدمون المحليون والمجموعات المحلية، وافتح مجلد المجموعات.
   3. اختر المجموعة مستخدمو docker من قائمة المجموعات وانقر فوقها نقرًا مزدوجًا.

      إذا لم تكن مجموعة docker-users موجودة بالفعل، قم بإنشائها.

   4. انقر على زر إضافة، وابحث عن الحساب الذي استخدمته لتثبيت ArcGIS Notebook Server، ثم اختره. انقر فوق موافق للتأكيد.
   5. انقر فوق موافق لإغلاق مربع حوار المجموعة.
   6. أنشئ ملف تكوين في المسار C:\ProgramData\docker\config\daemon.json لتعيين مجموعة أمان لـ Docker.
   7. قم بتحرير الملف C:\ProgramData\docker\config\daemon.json لإضافة مجموعة docker-users.

        
      {
        "group" : "docker-users"
      }

2. قم بتمكين المنفذ 2375 لتتمكن من استخدام واجهة برمجة التطبيقات عن بُعد لـ Docker. سيتم استخدام هذا المنفذ داخليًا فقط بواسطة ArcGIS Notebook Server وتجب حمايته من الاستخدام الخارجي. لتمكين المنفذ، افتح موجه أوامر كمسؤول وأدخل الأمر التالي:
   sc config docker binpath= "\"C:\Program Files\docker\dockerd.exe\" --run-service -H tcp://localhost:2375 -H npipe://"

3. أعد تشغيل Docker باستخدام الأمر التالي:

   net stop docker
   net start docker

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

   ملاحظة:‏

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

تغيير الموقع الافتراضي لتثبيت صور Docker

لتغيير الموقع الافتراضي لتثبيت صور Docker، اتبع الخطوات التالية:

1. قم بتحرير الملف في C:\ProgramData\docker\config\daemon.json.
2. قم بتعيين المتغير data-root إلى الموقع الذي تم اختياره على جهازك المحلي.

    {
   "data-root": "d:\\docker"
   }

3. أعد تشغيل Docker.