Вы можете использовать сервисы блокнотов для создания и автоматизации рабочих процессов блокнотов.
Лицензия:
Эта возможность доступна на двух уровнях лицензирования:
- Вместе с лицензией 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.
Примечание:
Для поддержки сервисов Notebook все внешние обратные прокси-серверы или балансировщики нагрузки должны иметь возможность передавать трафик websocket на внутренние цели и содержать требования, чтобы сеансы оставались открытыми в течение 10 минут.
Введение в сервисы блокнотов
Сервисы блокнотов предоставляют удобный веб-интерфейс Python для анализа геопространственных данных. С помощью блокнотов можно выполнять анализ, автоматизировать рабочие процессы и быстро визуализировать данные и результаты анализа в географическом контексте.
Блокноты являются эффективной современной средой, соединяющей код, визуализацию "на лету", карты и инструменты обработки данных. В редакторе блокнотов можно создавать, документировать и запускать код Python, все в одном месте.
До включения сервисов блокнотов убедитесь, что ваш администратор выделил достаточную квоту ресурсов и рабочие узлы для поддержки этой расширенной возможности.
Настройка сервисов блокнотов
Для выполнения следующих шагов настройки может потребоваться изменить способ развертывания ArcGIS в вашей организации; перед выполнением внимательно изучите их.
Для сервисов блокнотов требуется, чтобы модуль runAsUser имел разрешения на чтение и запись в соответствующий сетевой ресурс. У некоторых провайдеров для этого может потребоваться предоставить другим пользователям такие разрешения, в то время как в других случаях общее местоположение может быть обновлено, чтобы разрешить ID пользователя по умолчанию (117932853) владеть родительской директорией и любыми поддиректориями/файлами. Если другим пользователям разрешен доступ для чтения/записи, в качестве средства контроля безопасности конфигурации NFS следует использовать соответствующие диапазоны IP-адресов. Для кластеров, которые применяют произвольное присвоение ID пользователя во время входа в модуль или планирования, ID пользователя должно быть присвоено статическое значение, а разрешения должны быть соответствующим образом скорректированы.
Включение сервисов блокнотов
Чтобы включить сервисы блокнотов, необходимо настроить рабочую область блокнота и включить эту возможность в ArcGIS Enterprise Manager.
- В ArcGIS Enterprise Manager щелкните кнопку Функции на боковой панели.
Откроется страница функций.
- Включите переключатель Сервисы блокнотов.
Появится диалоговое окно Настроить рабочую область, и вам будет предложено указать необходимые значения. Рабочая область будет использоваться для хранения файлов, связанных с блокнотами каждого участника организации.
- Укажите запрошенную информацию.
-
- Тип тома – выберите Динамический или Статический, чтобы указать, как вы хотите подготовить постоянный том для рабочей области. Используйте Статический, если PVC должен быть привязан к существующему PV. Используйте Динамический, если новый PV должен быть представлен через заданный класс хранилища. Обратите внимание на разделы Динамическая подготовка и Статическая подготовка для более подробной информации.
Примечание:
PV для этой рабочей области должен быть типа FileSystem и поддерживать режим доступа ReadWriteMany (RWX). Перед настройкой рабочей области блокнота убедитесь, что выделенный для этой рабочей области PV поддерживает режим доступа RWX. Дополнительно, для поддержки PV вам может потребоваться установить в кластере Kubernetes поддерживающий драйвер.
- Имя тома — если выбрано Статический, необходимо указать имя тома.
- Имя класса хранилища — укажите свое собственное имя класса хранилища или, если вы задали класс хранилища, укажите имя класса хранилища для тома.
Примечание:
Имя класса хранилища является обязательным для Динамического и необязательным для Статического.
Примечание:
При привязке к существующему PV, для которого не определен класс хранилища, оставьте имя класса хранилища пустым. Если в кластере настроен класс хранения по умолчанию, контроллер допуска DefaultStorageClass добавляет класс хранения по умолчанию и предотвращает привязку PVC. В этом случае администратор может либо добавить спецификацию класса хранилища к PV, либо удалить конфигурацию класса хранилища по умолчанию.
- Размер (ГБ) — определяет размер PV. Минимальный размер - 100 ГБ. Значение должно соответствовать размеру существующего PV при использовании статической состыковки. Если это значение выше размера существующего PV, то PVC не будет привязан к PV.
Примечание:
Для вашей организации можно настроить только одну рабочую область блокнота. Размер его хранилища ограничен значением, указанным при создании. Убедитесь, что вы выбрали достаточный размер для рабочей области, чтобы соответствовать текущим и будущим потребностям.
- Щелкните Сохранить.
- Тип тома – выберите Динамический или Статический, чтобы указать, как вы хотите подготовить постоянный том для рабочей области. Используйте Статический, если PVC должен быть привязан к существующему PV. Используйте Динамический, если новый PV должен быть представлен через заданный класс хранилища. Обратите внимание на разделы Динамическая подготовка и Статическая подготовка для более подробной информации.
Появится сообщение, в котором указывается, что процесс включения может занять некоторое время.
Запрос на включение сервисов блокнотов отправлен. Процесс будет проверять предварительные условия и активировать вспомогательные ресурсы. Сервис автоматизации блокнотами будет запущен автоматически.
-
Если функцию не удалось включить, повторите описанные выше шаги, чтобы убедиться, что рабочая область настроена, лицензия сервисов блокнотов действительна и доступна, а системные сервисы запущены. Просмотрите журналы, чтобы определить требования для этой возможности.
При необходимости вы можете развернуть deamonSet для предварительной загрузки образов сервисов блокнотов. Это поможет сократить время, необходимое для первого открытия блокнота. Время ожидания первоначальной загрузки блокнота установлено на 1 минуту.
Сервисы блокнотов теперь настроены. Вы можете приступить к использованию блокнотов в вашей организации. Узнайте, как создать блокнот и опубликовать блокнот как веб-инструмент.
Кроме того, узнайте, как настроить параметры для возможности сервисов блокнотов.
Настройки сервисов блокнотов
После включения сервисов блокнотов вы можете просматривать и редактировать соответствующие настройки, такие как вспомогательные ресурсы для применимых сред исполнения, размер WebSocket, максимальное количество снимков на элемент блокнота и многое другое.
Возможность сервисов блокнотов включает три основные вкладки, где вы можете просматривать или редактировать настройки: Обзор, Свойства и Среды выполнения.
- Обзор — определите статус сервиса автоматизации блокнотов, количество запущенных развертываний блокнотов и класс хранилища, назначенный выделенной рабочей области блокнота.
- Свойства — управляйте ограничениями, связанными как с интерактивными, так и с автоматизированными развертываниями блокнотов.
- Среды выполнения — Просмотр и редактирование настроек доступных сред выполнения сервисов блокнотов.
Просмотр и редактирование свойств
В ArcGIS Enterprise Manager можно просматривать и редактировать следующие свойства:
- Размер веб-сокета (МБ) – максимальный размер (в мегабайтах) пакета, который может быть передан между сервером и клиентскими браузерами с использованием протокола WebSocket. WebSocket используется для обеспечения эффективной, безопасной двусторонней связи с клиентами. Значение этого свойства по умолчанию составляет 16 МБ. Возможно, вам придется поднять этот предел, если блокнот передает на сайт сервера особенно большой фрагмент данных.
- Порог неактивности блокнота (минуты) – это свойство определяет, когда неактивные блокноты закрыты. Блокноты, которые открыты, но неактивны в течение этого времени (в минутах), автоматически закрываются. Ядро блокнота остановлено. По умолчанию это 7 минут.
- Порог пустого развертывания — это свойство устанавливает, как долго развертывание блокнотов может оставаться открытым (в минутах) без запуска каких-либо активных блокнотов. После достижения этого значения контейнер автоматически закрывается. По умолчанию это 60 минут. Как и в случае с порогом неактивности блокнота, вы можете уменьшить это значение для экономии ресурсов.
- Максимальное количество снимков на элемент блокнота - Это свойство ограничивает допустимое количество снимков для одного элемента блокнота. Значение, предлагаемое по умолчанию, равно 5.
Выполните следующие шаги для просмотра и изменения свойств.
- Войдите в ArcGIS Enterprise Manager как администратор.
- Щелкните страницу Возможности.
- На карточке Сервисы блокнотов нажмите Настройки.
- Щелкните страницу Свойства.
Если вы измените любое из значений настроек, кнопка Сохранить станет доступной.
- Щелкните Сохранить, чтобы сохранить внесенные изменения.
Просмотр и редкатирование сред выполнения
Как администратор, вы можете обновлять доступность ядер ЦП и памяти CPU для контейнера, изменяя ресурсы, которые по умолчанию используются рабочей средой блокнота. Если сразу несколько пользователей одновременно работают с блокнотами, вы можете следить за нагрузкой и регулировать эти настройки с помощью ArcGIS Enterprise Manager.
В ArcGIS Enterprise Manager можно просматривать и редактировать следующие аспекты среды выполнения:
Выполните следующие шаги для просмотра и изменения значений среды выполнения.
- Войдите в ArcGIS Enterprise Manager как администратор.
- Щелкните страницу Возможности.
- На карточке Сервисы блокнотов нажмите Настройки.
- Щелкните страницу Среды выполнения.
Если вы измените любое из значений настроек, кнопка Сохранить станет доступной.
- Щелкните Сохранить, чтобы сохранить внесенные изменения.