ArcGIS Notebook Server udostępnia wiele metod automatyzacji procedur wykonywania zadań, w tym automatyzację za pomocą zaplanowanych notatników, elementów webhook oraz niestandardowych skryptów z użyciem administracyjnego interfejsu API wykonywania notatników.
Notatka:
Aby możliwa była automatyzacja notatnika z użyciem zaplanowanych zadań, elementów webhook lub interfejsu API uruchamiania notatników, notatnik musi używać środowiska wykonawczego w wersji 3.0 lub nowszej.
Planowanie zadań notatnika
Twórcy notatników mogą tworzyć harmonogramy aplikacji ArcGIS Notebooks umożliwiające automatyczne uruchamianie notatników w stałych terminach w przyszłości (raz lub wielokrotnie). Tworzenie zadań w celu zaplanowanego wykonywania notatników umożliwia zautomatyzowanie rutynowych procedur, uruchamianie procesów intensywnie wykorzystujących dane poza szczytowymi godzinami wykorzystania, a także regularne aktualizowanie zestawów danych. Notatnik można na przykład zaplanować w taki sposób, aby wykonywał następujące zadania:
- Importowanie danych ze źródła online, które jest aktualizowane co miesiąc, automatyczne czyszczenie danych i zastosowanie niezbędnych transformacji, a także przenoszenie danych do przestrzeni roboczej.
- Realizowanie w nocy procedury uruchamiania zadań analizy dużych zbiorów danych, która wymaga ogromnych ilości zasobów obliczeniowych, gdy zasoby te nie są używane do innych zadań.
- Zarządzanie użytkownikami, którzy utworzyli konta w instytucji w ostatnim tygodniu i przesyłanie do Ciebie ich listy w wiadomości e-mail.
Dla notatnika można utworzyć jedno lub większą liczbę zadań. Domyślnie autor notatnika lub administrator może utworzyć maksymalnie 20 zadań. Jeśli zmieni się właściciel notatnika, wszystkie zadania powiązane z tym notatnikiem zostają zdezaktywowane i przypisane do nowego właściciela.
Zaplanowane zadania pozwalają na parametryzowanie notatników. Gdy notatnik jest sparametryzowany, umożliwia napisanie ogólnego kodu, który można dostosować do różnych danych wejściowych bez interakcji z użytkownikiem. Wybrane parametry są wstawiane do notatnika podczas uruchamiania zadania i opcjonalnie mogą zostać zapisane w notatniku. Sparametryzowanego notatnika można na przykład użyć do okresowego generowania raportów dotyczących zanieczyszczenia powietrza w całym regionie. Notatnik może mieć wiele zaplanowanych zadań, po jednym dla każdego badanego regionu, a dla każdego zadania sparametryzowanymi danymi wejściowymi przekazywanymi do notatnika mogą być nazwa miasta czy typ zanieczyszczenia.
Notatka:
Liczba uruchomionych współbieżnie zadań notatnika jest ograniczona przez właściwość systemową maxExecuteNotebookContainersPerNode na serwerze Notebook Server.
Zadanie można skonfigurować w taki sposób, by po zakończeniu wykonywania zapisywało stan notatnika w pierwotnym elemencie notatnika.
Dla każdego zaplanowanego zadania, które zostało uruchomione, zapisywany jest statyczny widok HTML notatnika.
Za pomocą okna Zarządzaj zadaniami na stronie głównej programu ArcGIS Notebook Server lub na stronie Zadania w narzędziu ArcGIS Notebook Server Manager administratorzy mogą przeglądać szczegóły aktywnych zadań notatników w witrynie, edytować je, wstrzymywać, wznawiać i usuwać. Administratorzy i autorzy notatników z uprawnieniem do planowania notatników mogą wyświetlać szczegóły, edytować, wstrzymywać i wznawiać lub usuwać zadanie notatnika na stronie szczegółów notatnika lub na panelu zadania w edytorze notatników.
Jeśli poprzednie uruchomienie zadania nie zostało jeszcze zakończone, nowe uruchomienie zaplanowanego zadania jest pomijane. Jeśli na przykład zaplanowano uruchamianie zadania co 15 minut, ale instancja tego zadania działa przez 20 minut, następne zaplanowane uruchomienie zostanie pominięte. Jeśli dochodzi do tego regularnie, właściciel zadania powinien tak skorygować zaplanowany przedział czasu, by uruchomienia nie nakładały się na siebie.
Więcej informacji na temat zaplanowanych zadań notatników zawiera temat pomocy Planowanie zadania notatnika.
Planowanie limitów zadań
Istnieją pewne limity dotyczące poziomu użytkownika, instytucji i witryny (maszyny/komputera) programu ArcGIS Notebook Server związane z zaplanowanymi zadaniami notatników.
Zmiana maksymalnej liczby jednoczesnych automatycznych uruchomień notatników (maxExecuteNotebookContainersPerNode)
Gdy notatnik jest uruchamiany za pomocą zaplanowanego zadania, elementu webhook lub interfejsu API wykonywania notatników, ArcGIS Notebook Server automatycznie otwiera nowy kontener i uruchamia notatnik bez interakcji z użytkownikiem. Domyślnie ArcGIS Notebook Server skonfigurowano do uruchamiania maksymalnie 10 notatników działających jednocześnie na każdym komputerze z aplikacją Notebook Server. Biorąc pod uwagę zasoby (procesor i pamięć RAM) dostępne na każdym komputerze w witrynie Notebook Server, administrator może dostosować ten limit, modyfikując właściwość systemową maxExecuteNotebookContainersPerNode na serwerze Notebook Server. Wszelkie zautomatyzowane żądania dotyczące notatników przesłane po przekroczeniu tego limitu zostaną dodane do kolejki i uruchomione, gdy liczba zautomatyzowanych uruchomień zadań spadnie poniżej tego limitu. Zadania w kolejce ulegną niepowodzeniu, jeśli czas oczekiwania przekroczy limit czasu.
Notatka:
Nie ogranicza to liczby notatników uruchamianych interaktywnie w edytorze notatników.
Limit maxExecuteNotebookContainersPerNode można zmienić, wykonując poniższe czynności.
Notatka:
Zwiększenie limitu może zwiększyć wykorzystanie zasobów na komputera Notebook Server.
- Zaloguj się w portalu ArcGIS Enterprise jako administrator.
- Otwórz narzędzie ArcGIS Notebook Server Manager.
- Kliknij Ustawienia > Witryna.
- Zmień wartość właściwości maxExecuteNotebookContainersPerNode.
- Kliknij Zapisz.
- Zapoznaj się z ostrzeżeniem dotyczącym ponownego uruchomienia programu Notebook Server, a następnie kliknij opcję Zapisz i uruchom ponownie, aby zapisać zmiany.
Maksymalna liczba aktywnych zaplanowanych zadań notatników na użytkownika
Każdy autor notatników z uprawnieniami do planowania notatników może utworzyć maksymalnie 20 aktywnych zadań notatników. Po wykorzystaniu tego limitu użytkownik nie może tworzyć nowych zaplanowanych zadań. Nowe zadanie można utworzyć, gdy istniejące zadanie zmieni się z aktywnego na ukończone, zakończone niepowodzeniem lub nieaktywne. Ten limit można zmienić, aktualizując właściwość ExecuteNotebooksUserLimit za pomocą operacji aktualizacji limitów systemowych w interfejsie API administratora aplikacji ArcGIS Portal.
Maksymalna liczba aktywnych zaplanowanych zadań notatników na instytucję
Maksymalna liczba aktywnych zaplanowanych zadań notatników na instytucję jest ograniczona do 200. Limit ten odpowiada całkowitej liczbie aktywnych zadań, które mogą posiadać wszyscy użytkownicy w instytucji. Po wykorzystaniu tego limitu użytkownicy nie mogą tworzyć nowych zaplanowanych zadań notatników. Ten limit można zmienić, aktualizując limit ExecuteNotebooksOrgLimit za pomocą operacji aktualizacji limitów systemowych w interfejsie API administratora aplikacji ArcGIS Portal.
Liczba wyników zgłaszanych dla zaplanowanego zadania
Wyniki zadania są zgłaszane i zachowywane przez 30 uruchomień. Uruchomienia zadań wcześniejsze niż ostatnie 30 uruchomień są trwale usuwane. Ten limit można zmienić, aktualizując właściwość TaskRunHistoryCount za pomocą operacji aktualizacji limitów systemowych w interfejsie API administratora aplikacji ArcGIS Portal.
Automatyczne niepowodzenie zadania
Dla każdego zadania, które zakończy się niepowodzeniem pięć razy z rzędu, zostanie automatycznie ustawiony stan niepowodzenia i nie będzie ono już uruchamiane. Przed ponownym aktywowaniem zadania jego właściciel musi zapewnić, by możliwe było uruchomienie notatnika bez żadnej interakcji z użytkownikiem. Aby zapewnić, że zadanie będzie nadal uruchamiane, jego właściciel musi zidentyfikować i usunąć przyczynę niepowodzenia oraz zmienić stan zadania na Aktywne. Ten limit można zmienić, aktualizując właściwość FailedRunsDisableTask za pomocą operacji aktualizacji limitów systemowych w interfejsie API administratora aplikacji ArcGIS Portal.
Interfejs API uruchamiania notatników
Administratorzy i autorzy notatników mogą także automatyzować notatniki w taki sposób, aby były uruchamiane bez interakcji z użytkownikiem. W tym celu należy użyć operacji Wykonaj notatnik w aplikacji ArcGIS Notebook Server Administrator Directory. Wywołanie tej operacji powoduje automatyczne uruchomienie notatnika, ale za pomocą niestandardowego skryptu można zaplanować automatyczne jego uruchamianie o skonfigurowanej godzinie lub w regularnych odstępach czasu. Do zaplanowania uruchamiania operacji Wykonaj notatnik o skonfigurowanej godzinie lub w regularnych odstępach czasu można użyć zadania cron lub harmonogramu systemu Windows.
Więcej informacji zawiera temat dotyczący operacji Wykonywanie notatnika w instrukcji obsługi aplikacji Administrator Directory.