Установка ArcGIS Notebook Server и контейнеров Windows

В версии 11.0 ArcGIS Notebook Server с контейнерами Windows и Mirantis Container Runtime доступен в качестве бета-версии на Windows.

Примечание:

Во время бета-тестирования эти функции могут сопровождаться известными проблемами с производительностью и качеством и не будут поддерживаться службой технической поддержки Esri.

ArcGIS Notebook Server и контейнеры Windows

Как и другие развертывания ArcGIS Notebook Server, ArcGIS Notebook Server с контейнерами Windows устанавливается на операционной системе сервера и настраивается и интегрируется с порталом ArcGIS Enterprise. Кроме того, перед ПО ArcGIS Notebook Server может быть размещен веб-адаптер.

ArcGIS Notebook Server использует виртуализированные операционные системы, известные как контейнеры, для изоляции среды авторов блокнотов. В результате эти контейнеры позволяют авторам использовать определенный поднабор ресурсов сервера так, чтобы их работа или использование ресурсов не мешали другим.

Такие контейнеры распределяет и обслуживает сторонний программный компонент Mirantis Container Runtime, ранее Docker Engine Enterprise. Перед установкой ArcGIS Notebook Server необходимо установить Mirantis Container Runtime версии 20.10 или выше. После установки ArcGIS Notebook Server его надо настроить для работы с Mirantis Container Runtime.

ArcGIS Notebook Server выделяет каждому автору блокнота на сайте по одному контейнеру для каждой рабочей среды, и только они могут работать в данном контейнере. Вычислительные ресурсы, используемые авторами при запуске этих блокнотов, не повлияют на контейнеры других авторов.

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

ArcGIS Notebook Server может объединять несколько компьютеров вместе на одном сайте. В конфигурации с несколькими компьютерами последние должны быть настроены так, чтобы они были идентичными, и чтобы каждый компьютер мог работать с ArcGIS Notebooks.

Рабочие среды блокнота и образы контейнеров Windows

Esri предоставляет единый образ контейнера Windows для ArcGIS Notebook Server. Этот образ контейнера включает рабочие среды Standard и Advanced, что делает ресурсы Python доступными в ArcGIS Notebooks . Дополнительные сведения о библиотеках, доступных для каждой рабочей среды, см. в разделе Доступные библиотеки Python.

Эти две рабочие среды ArcGIS Notebook Server, Standard и Advanced, доступны в ноутбуках как часть образа контейнера. В зависимости от лицензии и прав доступа пользователя для использования будут доступны либо только рабочая среда Standard, либо обе рабочие среды - Standard и Advanced.

Контейнеры Windows на сайте ArcGIS Notebook Server поддерживают два режима изоляции рабочей среды - процесс (process) и Hyper-V. Дополнительные сведения о режимах см. в документации Microsoft по Режимам изоляции. Если сайт настроен на использование изоляции Hyper-V, то на компьютере должна быть установлена роль Hyper-V.

Примечание:

Существуют ограничения в отношении количества контейнеров, которые могут работать в случаях использования контейнеров Windows с Hyper-V. Более подробно см. в разделе Часто задаваемых вопросов по Microsoft.

При запуске контейнера к нему применяется образ контейнера Windows, предоставленный Esri. Рабочая среда будет зависеть от лицензии, которая настроена для ArcGIS Notebook Server, и от прав доступа автора блокнота.

Примечание:

В версии 11.0 существует известное ограничение, которое может привести к WinError 1455 при импорте библиотеки torch или библиотек Python, у которых есть torch в качестве зависимости.

Примечание:

fiona, rasterstats и rasterio не установлены в контейнерах Windows.

Настройка необходимого программного обеспечения

Перед установкой ArcGIS Notebook Server необходимо установить и настроить необходимое программное обеспечение.

Системные требования

Для установки ArcGIS Notebook Server с контейнерами Windows должны быть выполнены следующие системные требования:

• Windows Server 2022 - это единственная операционная система, которая поддерживает работу ArcGIS Notebook Server с контейнерами Windows.
• Для ArcGIS Notebook Server с контейнерами Windows требуется Mirantis Container Runtime версии 20.10 или выше.
• Hyper-V не является обязательным, в зависимости от режима изоляции рабочей среды, выбранной для сайта ArcGIS Notebook Server.
• ArcGIS Notebook Server с контейнерами Windows требует как минимум 75 Гб места на диске.
• См. системные требования ArcGIS Notebook Server.

Включение Hyper-V (необязательное действие)

Hyper-V требуется только в тех случаях, когда вам надо запустить контейнеры Windows в режиме изоляции Hyper-V.

Чтобы включить Hyper-V, ознакомьтесь с разделом Установка роли Hyper-V на Windows Server в документации Microsoft.

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

Выполните следующие шаги, чтобы установить Mirantis Container Runtime на своем компьютере.

1. Удалите предыдущую версию Docker на вашем компьютере.
2. Не включайте функцию Контейнеры на своем локальном сервере перед установкой Mirantis Container Runtime. Если эта функция уже включена, отключите ее на сервере. Дополнительные сведения см. в разделе Установка или удаление ролей, сервисов ролей или их функций в документации Microsoft.
3. Руководствуйтесь инструкциями, приведенными в разделе Установка Mirantis Container Runtime на Windows Server в документации Mirantis.
4. Убедитесь, что Mirantis Container Runtime установлен и запущен, выполнив следующую команду:
   docker run hello-world:nanoserver

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

Настройка Mirantis Container Runtime

1. Включите порт 2375, чтобы разрешить использование удаленного API Docker. Этот порт предназначен для внутреннего использования ArcGIS Notebook Server и должен быть защищен от доступа извне. Чтобы включить этот порт, откройте командную строку от имени администратора и выполните следующую команду:
   sc config docker binpath= "\"C:\Program Files\docker\dockerd.exe\" --run-service -H tcp://localhost:2375 -H npipe://"

2. Откройте окно PowerShell от имени администратора и выполните следующую команду:

   Restart-Service docker

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

   Примечание:

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

Установка ArcGIS Notebook Server

Выполните действия, описанные в разделе справки Установка ArcGIS Notebook Server, и установите ArcGIS Notebook Server, используя мастер установки или командную строку.

Настройка ArcGIS Notebook Server после установки

Когда установка ArcGIS Notebook Server будет завершена, запустите служебное приложение постинсталляции, чтобы установить образ контейнера Windows. Подпишитесь на программу тестирования бета-функций ArcGIS Enterprise в Esri Early Adopter Community (EAC), чтобы загрузить образ контейнера Windows. Выполните следующие действия для каждого компьютера, на котором установлен ArcGIS Notebook Server.

1. Откройте окно командной строки от имени администратора.
2. Перейдите в папку инструментов ArcGIS Notebook Server. По умолчанию путь следующий: C:\Program Files\ArcGIS\NotebookServer\tools\PostInstallUtility.
3. Определите, активен ли на вашем компьютере Mirantis Container Runtime, выполнив следующую команду:

   PostInstallUtility.bat -d

4. Если Mirantis Container Runtime не установлен, установите и настройте его по предоставленным выше инструкциям.
5. Запустите следующую команду:

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

Создание сайта ArcGIS Notebook Server

После установки ArcGIS Notebook Server и настройки образа контейнера Windows с помощью постинсталляционной утилиты, создайте сайт сервера в соответствии с инструкциями раздела Создание сайта ArcGIS Notebook Server.

Примечание:

Если вы собираетесь выполнить развертывание ArcGIS Notebook Server на нескольких компьютерах, перед созданием сайта ознакомьтесь с приведенными ниже рекомендациями по каталогам и хранилищу конфигурации Notebook Server.

Рекомендации по каталогам Notebook Server и хранилищу конфигураций

При развертывании ArcGIS Notebook Server на нескольких компьютерах, каталог ресурсов и хранилище конфигураций должны использовать общий каталог, на который ссылается путь Соглашения об универсальном назначении имен (UNC). Директория рабочей области всегда должна использовать путь UNC в конфигурации подключенной сети с соответствующей буквой диска на всех компьютерах, участвующих в данном сайте, и использовать его в качестве директории рабочей области.

Инструкции по настройке подключенного сетевого диска см. в разделе Настройка подключенного сетевого диска для директории рабочей области.

Использование объекта контейнера Windows для Notebook Server

После успешного создания сайта выполните следующие действия, чтобы согласиться с использованием ArcGIS Notebook Server с контейнерами Windows. Создав сайт ArcGIS Notebook Server, войдите в административный API и убедитесь, что сайт настроен на использование контейнеров Windows.

1. Выполните вход в административную директорию ArcGIS Notebook Server, используя учетную запись администратора.
2. Щелкните Система > Свойства.
3. Щелкните Обновить свойства.
4. Обновите свойство useWindowsContainers, чтобы оно было установлено на true
5. Щелкните Обновить свойства, чтобы сохранить внесенные изменения.
6. Как только Notebook Server перезагрузится и станет доступна административная директория, нажмите Блокнот > Рабочие среды > Восстановить заводские рабочие среды.

   https://notebook.domain.com:11443/arcgis/admin/notebooks/runtimes/restore

7. Щелкните Восстановить заводские рабочие среды для обновления рабочих сред Notebook Server standard и advanced, чтобы использовались образы контейнеров Windows.

Установка и настройка ArcGIS Web Adaptor с ArcGIS Notebook Server

После создания сайта ArcGIS Notebook Server необходимо установить ArcGIS Web Adaptor и зарегистрировать его на ArcGIS Notebook Server. Более подробно см. в разделе Установка и настройка ArcGIS Web Adaptor с ArcGIS Notebook Server.

Установка и настройка образцов данных ArcGIS Notebook Server

Образцы данных ArcGIS Notebook Server нужны для подготовленных Esri образцов блокнотов, которые входят в ArcGIS Notebook Server. Дополнительную информацию см. в разделе Установка и настройка образцов данных ArcGIS Notebook Server.

Настройка Notebook Server с порталом ArcGIS Enterprise

После того, как вы установите ArcGIS Notebook Server, настроите его с Mirantis Container Runtime, создадите сайт сервера и зарегистрируете его с Web Adaptor, вы можете настроить этот сайт с порталом ArcGIS Enterprise. Более подробно см. в разделе Настройка ArcGIS Notebook Server с порталом.

Присоединение дополнительных компьютеров к сайту ArcGIS Notebook Server

ArcGIS Notebook Server поддерживает сайты на нескольких компьютерах. На сайте с несколькими компьютерами у всех компьютеров должна быть одинаковая конфигурация, одна и та же операционная система, а также одинаковые настройки Mirantis Container Runtime и одна и та же буква сетевого диска для директории рабочей области. Дополнительную информацию см. в секции Установка и настройка сайта на нескольких компьютерах раздела Присоединение дополнительных компьютеров к сайту ArcGIS Notebook Server.

Настройка отображаемого сетевого диска для директории рабочей области

Это необязательный процесс, который необходим только в том случае, если вы планируете настраивать сайт Notebook Server с несколькими компьютерами.

1. Создайте ресурс UNC для директории рабочей области ArcGIS Notebook Server на отдельном компьютере, доступном для Notebook Server.

   Примечание:

   Эта директория должна иметь доступ на чтение и запись при работе с учетной записью ArcGIS Notebook Server Windows. Рекомендуется создать общий ресурс UNC для директории рабочей области ArcGIS Notebook Server на компьютере, который не участвует в сайте ArcGIS Notebook Server. Существует известная проблема, когда хранилище SMB, созданное на том же компьютере, что и Notebook Server, отключается при перезагрузке компьютера.

2. На компьютере Notebook Server откройте окно PowerShell от имени администратора.
3. Сохраните пароль учетной записи пользователя ArcGIS Notebook Server в виде защищенной строки для последующего использования с помощью следующей команды:

   $password = ConvertTo-SecureString '<password>' -AsPlainText -Force

4. Добавьте поддержку учетных данных для функций PowerShell:

   $credential = New-Object System.Management.Automation.PSCredential('<domain\username>', $password)

5. Создайте папку с постоянно установленным флагом:

   New-SmbGlobalMapping -Persistent $true -RemotePath <shared folder path> -Credential $credential -LocalPath <unassigned drive letter>:

6. Повторите шаги с 2 по 5 на всех компьютерах, участвующих в сайте ArcGIS Notebook Server, и назначьте одну и ту же букву диска, которая будет отображаться на всех компьютерах.
7. Используйте общий сетевой диск, созданный на предыдущем шаге, чтобы настроить директорию рабочей области при создании сайта ArcGIS Notebook Server.

Расширение рабочей среды блокнота

Дополнительные сведения см. в разделе Расширение рабочей среды блокнота.

После успешного выполнения шагов, описанных в этом разделе, у вас будет настроено развертывание ArcGIS Notebook Server с контейнерами Windows.