Установка 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	Тип образа среды выполнения блокнота (Контейнер)	Дополнительные требования
Windows Server 2019 Standard and Datacenter Windows Server 2022 Standard and Datacenter	Docker Desktop под Windows версии 4.4.4 или более новой	Linux	Требуется Hyper-V
Windows Server 2022 Standard and Datacenter	Mirantis Container Runtime версия 20.10 или более новая	Бета-версия Windows	Hyper-V не обязателен. Существуют ограничения на максимальное количество контейнеров, которые могут работать с изоляцией Hyper-V на Windows Server 2022 Standard. Смотри 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 Manager. Если нет, установите его. Подробные инструкции см. в следующей документации Microsoft:
   • Если вашей ОС является Windows Server 2022 или Windows Server 2019, см. раздел Установка роли Hyper-V на Windows Server.
   • Если вашей ОС является Windows 10, см. раздел Установка Hyper-V на Windows 10.

   Для ArcGIS Notebook Server требуется Docker Desktop для Windows (версии 4.4.4 или более новой).

2. В браузере перейдите на страницу загрузки Docker Desktop (Windows) в магазине Docker Hub.
3. Войдите в учетную запись Docker Hub или создайте новую.
4. Загрузите ПО Docker Desktop.
5. Дважды щелкните Docker for Windows Installer, чтобы запустить его.
6. В диалоговом окне Конфигурация установщика снимите отметку Use WSL2 instead of Hyper-V.
7. Закройте программу установки, когда она завершит работу.
8. Щелкните кнопку Docker Desktop в меню Пуск, чтобы запустить Docker.
9. Убедитесь, что Docker запущен, используя один из следующих методов:
   • Проверьте статус значка Docker в области панели задач Windows (обычно в правом нижнем углу экрана).
   • Откройте окно командной строки и выполните следующие команды:
     docker version
     docker run hello-world

     Первая команда возвращает версию Docker на вашем компьютере; вторая проверяет, что Docker имеет доступ и может запускать образы контейнеров.

Настройка параметров Docker

После установки Docker на компьютере, измените описанные ниже параметры.

Изменение общих параметров

Вы будете использовать Docker Remote API, для чего необходим порт 2375. Этот порт предназначен для внутреннего использования ArcGIS Notebook Server и должен быть защищен от доступа извне.

1. Щелкните правой кнопкой мыши кнопку Docker в системном трее Windows и щелкните Настройки.
2. На странице Общие отметьте Предоставить демон на tcp://localhost:2375 без TLS.

   Вы можете получить предупреждение о безопасности. Убедитесь, что системный администратор знает, что этот порт используется внутри, а внешний доступ к нему запрещен.

3. Снимите отметку с Use the WSL2 based engine, если отмечено.

Настройка публикации файлов

Контейнер 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 и щелкните Настройки. В меню настроек щелкните Resources > Advanced.
2. При необходимости измените следующие настройки:
   • ЦПУ— число ядер ЦП, доступных для контейнеров на вашем компьютере. По умолчанию установлено два ядра. Вы можете обновить это значение в зависимости от ресурсов, доступных на машине, и ограничений ЦПУ, установленных для среды выполнения блокнота.
   • Память— объем памяти, доступной для контейнеров на вашем компьютере. По умолчанию это 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 remote API.

   Этот порт предназначен для внутреннего использования 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 на вашем компьютере.