Skip to main content

Установите механизм контейнеров для ArcGIS Notebook Server

В шагах ниже описано, как загрузить, установить и настроить ПО для размещения контейнера, необходимого для работы ArcGIS Notebook Server. См. раздел Механизмы контейнеров и ArcGIS Notebook Server для ознакомления с механизмами контейнеров и способами их использования в ArcGIS Notebook Server.

Скачайте и установите механизм контейнеров

Для систем Linux доступны два механизма контейнеров: Docker Engine и Mirantis Container Runtime.

Если у вас Ubuntu или Red Hat Enterprise Linux Server, можно использовать любую версию Docker.

Механизм контейнера отсутствует.

Операционная система

Docker Engine Community edition 29.2.0 или позднее

Примечание:

Если вы используете Docker Engine версии 29 или более поздней, и она была обновлена с предыдущей версии, отредактируйте /etc/docker/daemon.json, чтобы отключить контейнерное хранилище изображений. См. шаг 4 в разделе Настройка параметров и среды Docker для получения дополнительной информации.

Ubuntu Server LTS 24.04.3

Ubuntu Server LTS 22.04.5

Red Hat Enterprise Linux Server 8 обновление 10

Red Hat Enterprise Linux Server 9 обновление 7

Rocky Linux 8 обновление 10

Rocky Linux 9 обновление 7

AlmaLinux 8 обновление 10

AlmaLinux 9 обновление 7

Mirantis Container Runtime версии 25.0.15 или позднее

Примечание:

Обратитесь к матрице совместимости Mirantis Container Runtime 25.0 для получения самой актуальной информации.

Ubuntu Server LTS 22.04.3

Ubuntu Server LTS 24.04.2

Red Hat Enterprise Linux Server 8 обновление 10

Red Hat Enterprise Linux Server 9 обновление 7

Oracle Linux 9 обновление 7

Rocky Linux 8, обновление 10

Rocky Linux 9 обновление 7

SUSE Linux Enterprise Server (SLES) 15 SP6

Mirantis Container Runtime

ArcGIS Notebook Server на Windows с Mirantis Container Runtime поддерживает следующие операционные системы:

Операционная система

Механизм контейнера

Дополнительные требования

Windows Server 2022 Standard and Datacenter

Mirantis Container Runtime версии 25.0.15 или позднее

Дополнительно можно установить Hyper-V.

Примечание:

Существуют ограничения на максимальное количество контейнеров, которые могут работать с изоляцией Hyper-V на Windows Server Standard.

Более подробно см. в разделе Windows FAQ.

Docker Engine из бинарных файлов

ArcGIS Notebook Server на Windows с Docker Engine с бинарных файлов поддерживает следующие операционные системы и версии Docker Engine:

Операционная система

Механизм контейнера

Дополнительные требования

Windows Server 2025 Standard and Datacenter

Windows Server 2022 Standard and Datacenter

Docker Engine — сообщество версии 29.2.0 или позднее

Дополнительно можно установить Hyper-V.

Примечание:

Существуют ограничения на максимальное количество контейнеров, которые могут работать с изоляцией Hyper-V на Windows Server Standard.

Более подробно см. в разделе Windows FAQ.
Примечание:

Поскольку Docker является сторонним компонентом, в этом разделе не приводятся подробные шаги по установке Docker. Обратитесь к веб-сайту Docker для получения самой актуальной информации.

Установите Mirantis Container Runtime на Red Hat Enterprise Linux Server, Ubuntu, SUSE Linux Enterprise Server и Oracle Linux

Для установки Mirantis Container Runtime необходимо получить пробную версию или подписку на ПО.

  1. Удалите предыдущую версию Docker на вашем компьютере.

    Полный порядок действий по удалению см. в документации Docker для соответствующей версии.

  2. Следуйте шагам из Руководства по установке Mirantis Container Runtime вашего дистрибутива Linux.

    Примечание:

    В настоящее время Mirantis не предлагает отдельное руководство по установке для Rocky Linux, но можно использовать руководство по установке Red Hat Enterprise Linux для установки на Rocky Linux.

    Примечание:

    В этом документе описываются два метода установки ПО (из репозитория Docker или через пакет RPM).

  3. Поскольку Docker не запускается автоматически после установки и настройки, запустите демон Docker, выполнив следующую команду:

$ sudo systemctl start docker

  1. Проверьте, что Docker установлен правильно и имеет доступ к образам контейнеров, использовав следующую команду:

$ sudo docker run hello-world

Перейдите к разделу ниже Настройка параметров и среды Docker.

Установите Docker Engine на Red Hat Enterprise Linux Server, Oracle Linux, Rocky Linux или AlmaLinux

Версия Docker Engine доступна для бесплатного скачивания, но для этого требуется наличие учетной записи Docker.

  1. Удалите предыдущую версию Docker на вашем компьютере.

    Полный порядок действий по удалению см. в документации Docker для соответствующей версии.

  2. Выполните шаги, описанные в разделе Установка Docker Engine на RHEL.

    В этом документе описываются два метода установки ПО (из репозитория rpm или через пакет rpm).

    Демон Docker запускается автоматически после установки.

  3. Проверьте, что Docker установлен правильно и имеет доступ к образам контейнеров, использовав следующую команду:

$ sudo docker run hello-world

Перейдите к разделу ниже Настройка параметров и среды Docker.

Установите Docker Engine на Ubuntu

Версия Docker Engine доступна для бесплатного скачивания, но для этого требуется наличие учетной записи Docker.

  1. Удалите предыдущую версию Docker на вашем компьютере.

    Полный порядок действий по удалению см. в документации Docker для соответствующей версии.

  2. Следуйте шагам, описанные в разделе Установка Docker Engine на Ubuntu.

    В этом документе описываются два метода установки ПО (из репозитория Docker или через пакет DEB).

    Демон Docker запускается автоматически после установки.

  3. Проверьте, что Docker установлен правильно и имеет доступ к образам контейнеров, использовав следующую команду:

$ sudo docker run hello-world

Перейдите к разделу ниже Настройка параметров и среды Docker.

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

Когда на ваш компьютер установлена соответствующая версия Docker, настройте Docker для работы с ArcGIS Notebook Server.

  1. Добавьте учетную запись пользователя ОС (или учетную запись, используемую для установки ArcGIS Notebook Server) в группу docker, которая была создана автоматически при установке.

$ sudo usermod -aG docker <ArcGIS Notebook Server install account>

  1. Выйдите и снова войдите в учетную запись пользователя ОС, чтобы применить изменения.

  2. Проверьте, что вы можете выполнить команду Docker из этой учетной записи.

$ docker run hello-world

  1. Если вы используете Docker Engine версии 29 или более поздней, и она была обновлена с предыдущей версии, отредактируйте /etc/docker/daemon.json, чтобы отключить контейнерное хранилище изображений.

    {
  "features": {
    "containerd-snapshotter": true
  }
}
    Примечание:

    Если daemon.json не существует, создайте его.

  2. Убедитесь, что в директории /var имеется не менее 75 ГБ свободного места.

    Docker использует директорию /var в качестве локального регистра для хранения образов. В процессе обновления для последующих версий новые образы также будут копироваться в директорию /var. Если места недостаточно, либо выделите больше места для директории /var, либо выполните следующие шаги, чтобы изменить местоположение корневой директории Docker.

    1. Отредактируйте /etc/docker/daemon.json, чтобы задать data-root для локальной директории на вашем компьютере с достаточным дисковым пространством.

      Примечание:

      Если этот файл не существует, создайте его.

      Пример пути:

      {"data-root" : "/data/docker"}

      Ниже приведён пример /etc/docker/daemon.json со свойствами containerd-snapshotter и data-root:

      {
   "features": {
      "containerd-snapshotter": true
   },
   "data-root" : "/data/docker"
}

    2. Удалите /var/lib/docker и создайте символическую ссылку, которая показывает путь, заданный на предыдущем шаге.

       $ sudo mkdir /data/docker
   $ sudo rm -rf /var/lib/docker
   $ sudo ln -s /data/docker /var/lib/docker
    1. Этот шаг необходим только при использовании механизма контейнера Docker версии 29. Удалите /var/lib/containerd и создайте символическую ссылку, которая показывает путь, заданный на предыдущем шаге.
       $ sudo mkdir /data/containerd
   $ sudo rm -rf /var/lib/containerd
   $ sudo ln -s /data/containerd /var/lib/containerd

  3. Перезапустите сервис Docker, чтобы применить изменения.

    $ sudo systemctl stop docker.service
$ sudo systemctl stop docker.socket
$ sudo systemctl stop containerd
$ sudo systemctl start containerd
$ sudo systemctl start docker.service
$ sudo systemctl start docker.socket

Теперь вы готовы к установке ArcGIS Notebook Server на вашем компьютере.

Требования к механизмам контейнеров

ArcGIS Notebook Server на Windows поддерживает Mirantis Container Runtime и Docker Engine из двоичных файлов в качестве механизмов контейнеров. См. раздел Механизмы контейнеров и ArcGIS Notebook Server для ознакомления с механизмами контейнеров и способами их интеграции в ArcGIS Notebook Server.

Для систем Linux доступны два механизма контейнеров: Docker Engine и Mirantis Container Runtime.

Если у вас Ubuntu или Red Hat Enterprise Linux Server, можно использовать любую версию Docker.

Механизм контейнера отсутствует.

Операционная система

Docker Engine Community edition 29.2.0 или позднее

Примечание:

Если вы используете Docker Engine версии 29 или более поздней, и она была обновлена с предыдущей версии, отредактируйте /etc/docker/daemon.json, чтобы отключить контейнерное хранилище изображений. См. шаг 4 в разделе Настройка параметров и среды Docker для получения дополнительной информации.

Ubuntu Server LTS 24.04.3

Ubuntu Server LTS 22.04.5

Red Hat Enterprise Linux Server 8 обновление 10

Red Hat Enterprise Linux Server 9 обновление 7

Rocky Linux 8 обновление 10

Rocky Linux 9 обновление 7

AlmaLinux 8 обновление 10

AlmaLinux 9 обновление 7

Mirantis Container Runtime версии 25.0.15 или позднее

Примечание:

Обратитесь к матрице совместимости Mirantis Container Runtime 25.0 для получения самой актуальной информации.

Ubuntu Server LTS 22.04.3

Ubuntu Server LTS 24.04.2

Red Hat Enterprise Linux Server 8 обновление 10

Red Hat Enterprise Linux Server 9 обновление 7

Oracle Linux 9 обновление 7

Rocky Linux 8, обновление 10

Rocky Linux 9 обновление 7

SUSE Linux Enterprise Server (SLES) 15 SP6

Mirantis Container Runtime

ArcGIS Notebook Server на Windows с Mirantis Container Runtime поддерживает следующие операционные системы:

Операционная система

Механизм контейнера

Дополнительные требования

Windows Server 2022 Standard and Datacenter

Mirantis Container Runtime версии 25.0.15 или позднее

Дополнительно можно установить Hyper-V.

Примечание:

Существуют ограничения на максимальное количество контейнеров, которые могут работать с изоляцией Hyper-V на Windows Server Standard.

Более подробно см. в разделе Windows FAQ.

Docker Engine из бинарных файлов

ArcGIS Notebook Server на Windows с Docker Engine с бинарных файлов поддерживает следующие операционные системы и версии Docker Engine:

Операционная система

Механизм контейнера

Дополнительные требования

Windows Server 2025 Standard and Datacenter

Windows Server 2022 Standard and Datacenter

Docker Engine — сообщество версии 29.2.0 или позднее

Дополнительно можно установить Hyper-V.

Примечание:

Существуют ограничения на максимальное количество контейнеров, которые могут работать с изоляцией Hyper-V на Windows Server Standard.

Более подробно см. в разделе Windows FAQ.

Установка Mirantis Container Runtime

Выполните следующие шаги для установки Mirantis Container Runtime:

  1. Удалите предыдущую версию Docker на вашем компьютере.

  2. Не включайте функцию Контейнеры на своем локальном сервере до установки Mirantis Container Runtime. Если эта функция уже включена, отключите ее на сервере. Дополнительные сведения см. в разделе Установка или удаление ролей, сервисов ролей или их функций в документации Microsoft.

  3. Следуйте шагам в разделе Установить Mirantis Container Runtime на Windows Server в документации Mirantis, чтобы получить и запустить скрипт установки install.ps1 для Mirantis Container Runtime для Windows Server.

    Чтобы запустить скрипт установки, используйте приведенный ниже код:

    ./install.ps1

  4. Убедитесь, что Mirantis Container Runtime правильно установлен и запущен, выполнив следующую команду:

docker run hello-world:nanoserver

  1. После завершения выполните следующие действия в Настройке компонента Docker для настройки Mirantis Container Runtime.

Установка Docker Engine из двоичных файлов

Выполните следующие шаги для установки Docker Engine из двоичных файлов:

  1. Удалите предыдущую версию Docker на вашем компьютере.

  2. Отключите функцию Контейнеры на локальном сервере, если она включена.

    Более подробную информацию можно найти в документации Microsoft.

  3. Включите функцию контейнеров Windows, выполнив следующую команду в Microsoft PowerShell с правами администратора:

Add-WindowsFeature Containers

  1. Следуйте инструкциям, чтобы перезагрузить компьютер.

  2. Проверьте установку функции Контейнеры, выполнив следующую команду:

Get-WindowsFeature Containers

  1. Следуйте инструкциям раздела Установка серверных и клиентских двоичных файлов на Windows в документации Docker.

    Примечание:

    Docker Engine из двоичных файлов автоматически не обновляется. Вы должны вручную обновиться до новых версий Docker. См. документацию Установка Docker Engine из двоичных файлов для дополнительной информации об ограничениях использования Docker из двоичных файлов в рабочей среде. Хотя на этой странице рекомендуется использовать Docker Desktop, ArcGIS Notebook Server с контейнерами Windows не поддерживает Docker Desktop в Windows как механизм контейнера.

  2. Добавьте директорию установки Docker, например C:\Program Files\docker, в переменную PATH системных переменных.

  3. Проверьте состояние установки и запуска демона Docker, выполнив следующую команду:

docker version

  1. После завершения выполните действия, описанные в разделе Настройка компонента Docker, чтобы настроить Docker Engine.

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

Выполните следующие шаги для настройки компонента Docker:

  1. Если учетная запись, используемая для установки ArcGIS Notebook Server, не является частью группы администраторов, выполните следующие шаги:

    1. В меню Пуск на компьютере с Windows откройте приложение Управление компьютером.

    2. На левой боковой панели разверните элемент Локальные пользователи и группы и откройте папку Группы.

    3. Выберите группу docker-users из списка групп и дважды щелкните по ней.

      Если группа пользователи-докера еще не существует, создайте ее.

    4. Щелкните кнопку Добавить, найдите учетную запись, которую вы использовали для установки ArcGIS Notebook Server, и выберите его. Щелкните ОК для подтверждения.

    5. Щелкните OK, чтобы закрыть диалоговое окно группы.

    6. Создайте файл конфигурации в C:\ProgramData\docker\config\daemon.json, чтобы настроить группу безопасности для Docker.

    7. Измените C:\ProgramData\docker\config\daemon.json, чтобы добавить группу пользователи-докера.

       {
     "group" : "docker-users"
   }

  2. Настройте свой сервис Docker для прослушивания по именованному каналу с помощью следующей команды:

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

  1. Перезапустите Docker со следующей командой:

    net stop docker
net start docker

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

    Примечание:

    Каждый раз при установке или обновлении компонента Docker необходимо перезагружать компьютер.

Изменение директории установки образа Docker по умолчанию

Дополнительно, чтобы изменить директорию установки образа Docker по умолчанию, выполните следующие шаги:

  1. Редактирование файла C:\ProgramData\docker\config\daemon.json

  2. Измените место установки образа Docker по умолчанию, указав выбранное вами местоположение data-root на локальном компьютере.

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

  3. Сохраните daemon.json.

  4. Перезапустите Docker, запустив следующую команду:

    net stop docker
net start docker

Теперь вы готовы к установке ArcGIS Notebook Server на вашем компьютере.

Настройте временный каталог, отличный от используемого по умолчанию, для Docker

Docker Engine 29.4 и более поздних версий поддерживает настройку временного каталога, отличного от каталога по умолчанию, с помощью DOCKER_TMPDIR переменной среды. Эта переменная среды позволяет Docker использовать каталог, отличный от каталога C:\ temp по умолчанию, для временного хранения, например, после установки при загрузке образа среды выполнения Notebook. Выполните следующие шаги, чтобы настроить временный каталог, отличный от используемого по умолчанию, для Docker:

  1. Создайте временную директорию на диске, отличном от диска по умолчанию.

    Пример:

    d:\docker-temp

  2. В Windows щелкните Свойства системы > Расширенные > Переменные среды > Системные переменные.

  3. Задайте общесистемную переменную среды со следующей информацией:

    Имя переменной: DOCKER_TMPDIR

    Значение переменной: <new temporary directory created in step 1>

  4. Перезапустите сервис Docker:

    net stop docker
net start docker