ArcGIS Notebook Server позволяет реализовать несколько методов автоматизации рабочего процесса, включая автоматизацию с помощью запланированных блокнотов, вебхуков и пользовательских скриптов с использованием административного API Execute Notebook.
Примечание:
Чтобы автоматизировать блокнот с помощью запланированных задач, вебхуков или Run Notebook API, блокнот должен использовать рабочую среду версии 3.0 или более поздней.
Планирование задач блокнота
Авторы блокнота могут запланировать ArcGIS Notebooks на автоматическое выполнение в определенное время в будущем, однократно либо с определенной периодичностью. Создание задач для планирования блокнотов позволяет автоматизировать рутинные рабочие процессы, запускать процессы с интенсивным использованием данных во вне пиковые часы использования и регулярно обновлять наборы данных. Например, вы можете запланировать блокнот, чтобы выполнить следующее:
- Импортировать данные из онлайн-источника, который обновляется ежемесячно, автоматически очистить данные и применить необходимые преобразования, а также переместить данные в рабочую область
- Выполнить рабочий процесс анализа больших данных, который требует большой вычислительной мощности в ночные часы, когда ресурсы вашего компьютера в остальном не используются
- Управлять пользователями, которые создали учетные записи в вашей организации за последнюю неделю, и отправлять список вам по электронной почте
Вы можете создать одну или несколько задач для блокнота. По умолчанию автор или администратор блокнота может создать не более 20 задач. Если владелец блокнота изменится, любые задачи, связанные с этим блокнотом, будут деактивированы и назначены новому владельцу.
Запланированные задачи позволяют параметризовать блокноты. Когда блокнот параметризирован, он позволяет вам писать общий код, который можно адаптировать к различным входным данным без вашего участия. Выбранные параметры вставляются в блокнот при запуске задачи и при желании могут быть сохранены в нем. Например, параметризованный блокнот можно использовать для периодического создания региональных отчетов о загрязнении воздуха. В блокноте может быть несколько запланированных задач, по одной для каждого изучаемого региона, и для каждой задачи в блокнот можно вводить параметризованные входные данные, такие как название города и тип загрязнения.
Примечание:
Количество одновременных выполнений задач блокнота ограничено системным свойством maxExecuteNotebookContainersPerNode в Notebook Server.
Вы можете настроить задачу для сохранения состояния блокнота в исходный элемент блокнота после завершения.
Статический HTML-вид блокнота будет сохраняться для каждой запущенной запланированной задачи.
С помощью окна Управление задачами на главной странице ArcGIS Notebook Server или со страницы Задачи в ArcGIS Notebook Server Manager администраторы могут просматривать детали, редактировать, приостанавливать, возобновлять или удалять активные задачи блокнота на сайте. Администраторы и авторы блокнота с полномочиями расписания блокнота могут просматривать сведения, редактировать, приостанавливать и возобновлять или удалять задачу блокнота на странице сведений блокнота или на панели задач редактора блокнота.
Если предыдущий запуск задачи все еще выполняется, запуск новой запланированной задачи будет пропущен. Например, если задача запланирована на запуск каждые 15 минут, но экземпляр этой задачи выполняется в течение 20 минут, следующее запланированное выполнение будет пропущено. Если это происходит регулярно, владелец задачи должен настроить запланированный временной интервал, чтобы не было перекрытия между запусками.
Дополнительные сведения о запланированных задачах блокнота см. в разделе справки Планирование задачи блокнота.
Ограничения запланированных задач
Существуют определенные ограничения на уровне пользователя, организации и сайта ArcGIS Notebook Server (компьютера), связанные с запланированными задачами блокнота.
Изменение максимального количества одновременных автоматических запусков блокнотов (maxExecuteNotebookContainersPerNode)
Когда блокнот работает по заданному для задачи расписанию, с помощью вебхука или Execute Notebook API, ArcGIS Notebook Server автоматически открывает новый контейнер и запускает блокнот без участия пользователя. По умолчанию ArcGIS Notebook Server настроен на запуск не более 10 одновременных запусков блокнота на каждом компьютере Notebook Server. Учитывая ресурсы (CPU и RAM), доступные на каждом компьютере сайта Notebook Server, администратор может изменить это значение, изменив системное свойство maxExecuteNotebookContainersPerNode в Notebook Server. Любой запрос к автоматизированному блокноту, поданный после того, как ограничение превышено, будет добавлен в очередь и запущен, как только количество запусков автоматических задач упадет ниже этого ограничения. Поставленные в очередь задачи не будут выполняться, если время ожидания превысит время таймаута.
Примечание:
Это не ограничивает количество блокнотов, которые выполняются в интерактивном режиме из редактора блокнотов.
Изменить установленное ограничение maxExecuteNotebookContainersPerNode можно, выполнив следующие действия.
Примечание:
Увеличение ограничения может привести к использованию дополнительных ресурсов на компьютера Notebook Server.
- Войдите на портал ArcGIS Enterprise как администратор.
- Откройте ArcGIS Notebook Server Manager.
- Щелкните Настройки > Сайт.
- Измените значение свойства maxExecuteNotebookContainersPerNode.
- Щелкните Сохранить.
- Ознакомьтесь с предупреждением о перезапуске Notebook Server и нажмите Сохранить и перезапустить, чтобы сохранить изменения.
Максимальное количество активных запланированных задач блокнота на одного пользователя
Авторы блокнотов, обладающие правами составления расписаний для блокнотов, могут создавать не более, чем по 20 активных задач блокнотов. По достижении этого значения пользователь не сможет создавать новые задачи по расписанию. Новую задачу можно создать после того, как существующая задача перейдет из состояния Активна в состояние Завершена, Не удалось (Не выполнено) или Неактивна. Это предельное значение можно изменить, изменив свойство ExecuteNotebooksUserLimit с помощью операции Обновить ограничения системы в ArcGIS Portal Administrator API.
Максимальное количество активных запланированных задач блокнота для одной организации
Максимальное число активных запланированных задач блокнота для одной организации не может превышать 200. Это ограничение определяет общее количество активных задач, принадлежащих всем пользователям в организации. По достижении этого значения пользователи не смогут создавать новые задачи блокнота по расписанию. Это предельное значение можно настроить, изменив операцию ExecuteNotebooksOrgLimitОбновить ограничения системы в ArcGIS Portal Administrator API.
Количество результатов, которое фиксируется для запланированной задачи
Результаты выполнения задач фиксируются и сохраняются для 30 задач. Любые задачи, которые были созданы до последних 30 задач, удаляются безвозвратно. Это предельное значение можно изменить, изменив свойство TaskRunHistoryCount с помощью операции Обновить ограничения системы в ArcGIS Portal Administrator API.
Автоматический отказ выполнения задачи
Задачи, завершившиеся неудачей пять раз подряд, будут автоматически переведены в состояние отказа и больше не будут выполняться. Владелец задачи должен убедиться, что блокнот может быть успешно запущен без какого-либо взаимодействия с пользователем, прежде чем повторно активировать задачу. Чтобы обеспечить дальнейшее выполнение задач, владелец задачи должен выявить и устранить сбой и перевести эту задачу в состояние Активная. Это предельное значение можно изменить, изменив свойство FailedRunsDisableTask с помощью операции Обновить ограничения системы в ArcGIS Portal Administrator API.
Запуск Notebook API
Администраторы и авторы блокнотов также могут автоматизировать запуск блокнота без взаимодействия с пользователем с помощью операции Выполнить блокнот в ArcGIS Notebook Server Administrator Directory. Эта операция автоматически запускает блокнот при вызове, но с помощью пользовательского скрипта вы можете запланировать автоматическое выполнение в установленное время или по регулярному расписанию. Задание cron или планировщик Windows также можно использовать для планирования выполнения операции Выполнить блокнот в заданное время или через повторяющийся интервал.
Дополнительные сведения см. в разделе Выполнить блокнот в справке Administrator Directory.