Настройка сервисов блокнотов—ArcGIS Enterprise on Kubernetes

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

Блокноты являются средой, соединяющей код, визуализацию "на лету", карты и инструменты данных. В редакторе блокнотов можно создавать, документировать и запускать код Python, все в одном месте.

Сервисы блокнотов включают следующие ресурсы Esri Python:

ArcGIS API for Python: позволяет внедрять в блокноты динамические карты и инструменты работы с геопространственными данными
ArcPy: позволяет использовать скрипты Python в организации

Лицензия:

Эта возможность доступна на двух уровнях лицензирования:

Вместе с лицензией ArcGIS Enterprise on Kubernetes предоставляется лицензия ArcGIS Notebook Services. Эта лицензия позволяет участникам организации создавать блокноты с использованием среды выполнения ArcGIS Notebook Python 3 Standard и автоматизировать рабочие процессы блокнотов с помощью запланированных задач, вебхуков и веб-инструментов.
Лицензия ArcGIS Notebook Services Advanced доступна в качестве премиум-возможности и обеспечивает доступ к среде выполнения ArcGIS Notebook Python 3 Advanced с дополнительными возможностями ArcPy, выходящими за рамки лицензии ArcGIS Notebook Services.

Примечание:

Для поддержки сервисов блокнотов все внешние обратные прокси-серверы или балансировщики нагрузки должны иметь возможность передавать трафик websocket на внутренние цели и содержать требования, чтобы сеансы оставались открытыми в течение 10 минут.

Настройка сервисов блокнотов

Для выполнения следующих шагов настройки может потребоваться изменить способ развертывания ArcGIS Enterprise on Kubernetes в вашей организации; перед выполнением внимательно изучите их.

Включение сервисов блокнотов

Чтобы включить сервисы блокнотов, необходимо настроить рабочую область блокнота и включить эту возможность в ArcGIS Enterprise Manager.

Примечание:

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

В ArcGIS Enterprise Manager щелкните кнопку Функции на боковой панели.
Откроется страница функций.
Включите переключатель Сервисы блокнотов.
Появится диалоговое окно Настроить рабочую область, и вам будет предложено указать необходимые значения. Рабочая область будет использоваться для хранения файлов, связанных с блокнотами каждого участника организации.
Укажите запрошенную информацию.
1. Для Типа тома выберите Динамический или Статический, чтобы указать, как вы хотите подготовить постоянный том для рабочей области. Используйте Статический, если PVC должен быть привязан к существующему PV. Используйте Динамический, если новый PV должен быть представлен через заданный класс хранилища. Обратите внимание на разделы Динамическая подготовка и Статическая подготовка для более подробной информации.
  Примечание:
  PV для этой рабочей области должен быть типа FileSystem и поддерживать режим доступа ReadWriteMany (RWX). Перед настройкой рабочей области блокнота убедитесь, что выделенный для этой рабочей области PV поддерживает режим доступа RWX. Дополнительно, для поддержки PV вам может потребоваться установить в кластере Kubernetes поддерживающий драйвер.
2. Введите Имя тома.
  Если выбрано Статический, необходимо указать имя тома.
3. Для Имени класса хранилища укажите свое собственное имя класса хранилища или, если вы задали класс хранилища, укажите имя класса хранилища для тома.
  Примечание:
  Имя класса хранилища является обязательным для Динамического и необязательным для Статического.
  Примечание:
  При привязке к существующему PV, для которого не определен класс хранилища, оставьте имя класса хранилища пустым. Если в кластере настроен класс хранения по умолчанию, контроллер допуска DefaultStorageClass добавляет класс хранения по умолчанию и предотвращает привязку PVC. В этом случае администратор может либо добавить спецификацию класса хранилища к PV, либо удалить конфигурацию класса хранилища по умолчанию.
4. В качестве Размера (ГБ) задайте размер PV.
  Минимальный размер - 100 ГиБ. Значение должно соответствовать размеру существующего PV при использовании статической состыковки. Если это значение выше размера существующего PV, то PVC не будет привязан к PV.
  Примечание:
  Для вашей организации можно настроить только одну рабочую область блокнота. Размер его хранилища ограничен значением, указанным при создании. Убедитесь, что вы выбрали достаточный размер для рабочей области, чтобы соответствовать текущим и будущим потребностям.
5. Щелкните Сохранить.
Появится сообщение, в котором указывается, что процесс включения может занять некоторое время.
Запрос на включение сервисов блокнотов отправлен. Процесс проверяет предварительные условия и активирует вспомогательные ресурсы. Сервис автоматизации блокнотами будет запущен автоматически.

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

При необходимости вы можете развернуть deamonSet для предварительной загрузки образов сервисов блокнотов. Это поможет сократить время, необходимое для первого открытия блокнота. Время ожидания первоначальной загрузки блокнота установлено на 1 минуту.

Сервисы блокнотов теперь настроены. Вы можете приступить к использованию блокнотов в вашей организации. Узнайте, как создать блокнот и опубликовать блокнот как веб-инструмент.

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

Настройки сервисов блокнотов

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

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

Обзор — определите статус сервиса автоматизации блокнотов, количество запущенных развертываний блокнотов и класс хранилища, назначенный выделенной рабочей области блокнота.
Свойства — управляйте ограничениями, связанными как с интерактивными, так и с автоматизированными развертываниями блокнотов.
Среды выполнения — Просмотр и редактирование настроек доступных сред выполнения сервисов блокнотов.

Просмотр и редактирование свойств

В ArcGIS Enterprise Manager можно просматривать и редактировать следующие свойства:

Размер веб-сокета (МБ) – максимальный размер (в мегабайтах) пакета, который может быть передан между сервером и клиентскими браузерами с использованием протокола WebSocket. WebSocket используется для обеспечения эффективной, безопасной двусторонней связи с клиентами. Значение этого свойства по умолчанию составляет 16 МБ. Возможно, вам придется поднять этот предел, если блокнот передает на сайт сервера особенно большой фрагмент данных.
Порог неактивности блокнота (минуты) – это свойство определяет, когда неактивные блокноты закрыты. Блокноты, которые открыты, но неактивны в течение этого времени (в минутах), автоматически закрываются. Ядро блокнота остановлено. По умолчанию это 7 минут.
Порог пустого развертывания — это свойство устанавливает, как долго развертывание блокнотов может оставаться открытым (в минутах) без запуска каких-либо активных блокнотов. После достижения этого значения развертывание автоматически закрывается. По умолчанию это 60 минут. Как и в случае с порогом неактивности блокнота, вы можете уменьшить это значение для экономии ресурсов.
Максимальное количество снимков на элемент блокнота - Это свойство ограничивает допустимое количество снимков для одного элемента блокнота. Значение, предлагаемое по умолчанию, равно 5.

Для просмотра и редактирования свойств выполните следующие действия:

Войдите в ArcGIS Enterprise Manager как администратор.
Щелкните страницу Возможности.
На карточке Сервисы блокнотов нажмите Настройки.
Щелкните страницу Свойства.
Если вы измените любое из значений настроек, кнопка Сохранить станет доступной.
Щелкните Сохранить, чтобы сохранить внесенные изменения.

Просмотр и редкатирование сред выполнения

В ArcGIS Enterprise Manager вы можете выполнять следующие задачи управления рабочей средой:

Просмотреть доступные рабочие среды.
Дублировать созданную системой рабочую среду, чтобы добавить пользовательскую рабочую среду. Каждую рабочую среду можно настроить отдельно, что позволяет разным типам задач использовать рабочие среды с разными настройками.
Просмотреть и отредактировать системные ресурсы, доступные для каждого развертывания рабочей среды. Если сразу несколько пользователей одновременно работают с блокнотами, вы можете следить за нагрузкой и регулировать эти настройки.
Управлять узлами, на которых можно планировать запуск модулей для рабочей среды. Управлять размещением модулей полезно, когда некоторые задачи требуют ресурсов, таких как графический процессор, которые доступны только на некоторых узлах кластера.

Для просмотра и редактирования рабочей среды выполните следующие действия:

Войдите в ArcGIS Enterprise Manager как администратор.
Щелкните страницу Возможности.
На карточке Сервисы блокнотов нажмите Настройки.
Щелкните страницу Среды выполнения, чтобы увидеть список доступных рабочих сред.
Чтобы создать новую рабочую среду, щелкните Дублировать рядом с созданной системой рабочей средой, которую хотите дублировать.
Щелкните имя среды выполнения, которое требуется просмотреть или изменить.
Чтобы просмотреть или отредактировать ресурсы, к которым может получить доступ каждое развертывание рабочей среды, выполните следующие действия:
1. Щелкните Настройки среды выполнения.
2. Просмотрите или измените Запросы CPU и Ограничения CPU.
3. Просмотрите или измените Запросы памяти, Ограничения памяти, Максимальный объем памяти подкачки и Разделяемая память.
4. Используйте кнопку-переключатель Включить графический процессор и значение Единицы графического процессора, чтобы просмотреть или изменить доступ рабочей среды к ресурсам GPU. Единицы графического процессора представляют собой число GPU на узел.
  Примечание:
  Ваш кластер Kubernetes должен быть настроен для включения ресурсов GPU. Подробнее см. раздел Настройка узлов с поддержкой графического процессора.
5. Щелкните Сохранить, чтобы сохранить внесенные изменения.
Для просмотра и редактирования настроек размещения модуля для рабочей среды выполните следующие действия:
1. Щелкните Размещение модуля.
2. Просмотрите или отредактируйте Привязка узлов и Допуски.
  Если вы настраиваете привязки узлов для сервисов блокнотов с поддержкой GPU, используйте следующие значения:
  - Тип — обязательное
  - Ключ — укажите ключ, используемый для подписывания узла GPU, например notebook.
  - Оператор — In
  - Значение — укажите значение, используемое для подписывания узла GPU, например NotebooksGPUNode.
  Если вы настраиваете допуски для сервисов блокнотов с поддержкой GPU, используйте следующие значения:
  - Эффект — не выполнять
  - Ключ — nvidia.com/gpu
  - Оператор — существует
3. При настройке новых Привязок узлов или Допусков щелкните Добавить.
4. Щелкните Сохранить, чтобы сохранить внесенные изменения.
Чтобы просмотреть библиотеки, включенные в рабочую среду, щелкните Манифест.

Отзыв по этому разделу?