Skip to main content

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

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

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

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

  • ArcGIS API for Python: включение динамических карт и инструментов геопространственных данных в ваши блокноты

  • ArcPy: поддержка написания скриптов на Python в вашей организации

Лицензия:

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

  • Лицензия ArcGIS Notebook Services предоставляется вместе с лицензией ArcGIS Enterprise on Kubernetes. Эта лицензия позволяет участникам организации создавать блокноты с использованием среды выполнения 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.

Примечание:

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

  1. В ArcGIS Enterprise Manager щелкните кнопку Функции на боковой панели.

    Откроется страница функций.

  2. Включите переключатель Сервисы блокнотов.

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

  3. Укажите запрошенную информацию:

    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. Щелкните Сохранить.

    Появится сообщение, в котором указывается, что процесс включения может занять некоторое время.

    Примечание:

    Если рабочая область блокнотов не была создана успешно или если вам нужно воссоздать рабочую область с другим именем класса хранилища, вы можете удалить рабочую область с помощью операции Удалить (Рабочая область).

    Запрос на включение сервисов блокнотов отправлен. Процесс проверяет предварительные условия и активирует вспомогательные ресурсы. Сервис автоматизации блокнотами будет запущен автоматически.

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

При необходимости вы можете развернуть DaemonSet для предварительной загрузки образов сервисов блокнотов. Это поможет сократить время, необходимое для первого открытия блокнота. Время ожидания первоначальной загрузки блокнота установлено на 1 минуту. Дополнительные сведения см. в репозитории ArcGIS Enterprise on Kubernetes на GitHub.

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

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

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

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

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

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

  • Свойства — управляйте ограничениями, связанными как с интерактивными, так и с автоматизированными развертываниями блокнотов.

  • Среды выполнения — Просмотр и редактирование настроек доступных сред выполнения сервисов блокнотов.

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

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

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

  • Порог неактивности блокнота (минуты) – это свойство определяет, когда неактивные блокноты закрыты. Блокноты, которые открыты, но неактивны в течение этого времени (в минутах), автоматически закрываются. Ядро блокнота остановлено. По умолчанию — 720 минут.

  • Порог пустого развертывания — это свойство устанавливает, как долго развертывание блокнотов может оставаться открытым (в минутах) без запуска каких-либо активных блокнотов. После достижения этого значения развертывание автоматически закрывается. По умолчанию это 60 минут. Как и в случае с порогом неактивности блокнота, вы можете уменьшить это значение для экономии ресурсов.

  • Максимальное количество снимков на элемент блокнота - Это свойство ограничивает допустимое количество снимков для одного элемента блокнота. Значение, предлагаемое по умолчанию, равно 5.

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

  1. Войдите в ArcGIS Enterprise Manager в качестве администратора.

  2. Щелкните страницу Возможности.

  3. На карточке Сервисы блокнотов щелкните Настройки.

  4. Щелкните страницу Свойства.

    Если вы измените любое из значений настроек, кнопка Сохранить станет доступной.

  5. Щелкните Сохранить, чтобы сохранить внесенные изменения.

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

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

  • Просмотреть доступные рабочие среды.

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

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

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

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

  1. Войдите в ArcGIS Enterprise Manager в качестве администратора.

  2. Щелкните страницу Возможности.

  3. На карточке Сервисы блокнотов щелкните Настройки.

  4. Щелкните страницу Среды выполнения, чтобы увидеть список доступных рабочих сред.

  5. Чтобы создать новую рабочую среду, щелкните Дублировать рядом с созданной системой рабочей средой, которую хотите дублировать.

  6. Щелкните имя среды выполнения, которое требуется просмотреть или изменить.

  7. Чтобы просмотреть или отредактировать ресурсы, к которым может получить доступ каждое развертывание рабочей среды, выполните следующие действия:

    1. Щелкните Настройки среды выполнения.

    2. Просмотрите или измените Запросы CPU и Ограничения CPU.

    3. Просмотрите или отредактируйте Запросы памяти, Ограничения памяти, Максимальный объем памяти подкачки и Разделяемую память.

    4. Используйте кнопку-переключатель Включить графический процессор и значение Единицы графического процессора, чтобы просмотреть или изменить доступ рабочей среды к ресурсам GPU. Единицы графического процессора представляют собой число GPU на узел.

      Примечание:

      Ваш кластер Kubernetes должен быть настроен на включение ресурсов GPU. Подробнее см. раздел Настройка узлов с поддержкой графического процессора.

    5. Щелкните Сохранить, чтобы сохранить внесенные изменения.

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

    1. Щелкните Размещение модуля.

    2. Просмотрите или отредактируйте Привязка узлов и Допуски.

      Если вы настраиваете привязки узлов для сервисов блокнотов с поддержкой GPU, используйте следующие значения:

      • Тип — обязательное

      • Ключ — укажите ключ, используемый для надписи узла GPU, например notebook.

      • Оператор — In

      • Значение — укажите значение, используемое для надписи узла GPU, например NotebooksGPUNode.

      Если вы настраиваете допуски для сервисов блокнотов с поддержкой GPU, используйте следующие значения:

      • Эффект — не выполнять

      • Ключ — nvidia.com/gpu

      • Оператор — существует

    3. При настройке новых Привязок узлов или Допусков щелкните Добавить.

    4. Щелкните Сохранить, чтобы сохранить внесенные изменения.

  9. Чтобы просмотреть библиотеки, включенные в рабочую среду, щелкните Манифест.

Обновление созданных пользователем рабочих сред выполнения блокнотов

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

  1. Войдите в ArcGIS Enterprise Manager в качестве администратора.

  2. Щелкните страницу Возможности.

  3. На карточке Сервисы блокнотов щелкните Настройки.

  4. Щелкните страницу Среда выполнения, чтобы просмотреть список доступных рабочих сред выполнения.

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

  6. Нажмите Обновить.

Ваш рабочий цикл теперь обновлен до самой последней версии.