Konfigurieren von Notebook-Services

Notebook-Services bieten eine webbasierte Python-Notebook-Oberfläche für die Analyse räumlicher Daten. Mit Notebooks können Sie Analysen durchführen, Workflows automatisieren sowie Daten und Analyseergebnisse unmittelbar in einem geographischen Kontext visualisieren.

Notebooks sind eine Umgebung, in der Code, On-the-fly-Visualisierungen und Karten sowie Datenwerkzeuge kombiniert werden. Im Notebook-Editor können Sie Python-Code zentralisiert schreiben, dokumentieren und ausführen.

Notebook-Services beinhalten die folgenden von Esri bereitgestellten Python-Ressourcen:

• ArcGIS API for Python: Über die API können Sie dynamische Karten und räumliche Datenwerkzeuge in Notebooks integrieren.
• ArcPy: Ermöglicht das Python-Skripting in in Ihrer Organisation.

Lizenz:

Diese Funktion ist in zwei Lizenzierungsstufen verfügbar:

• Im Lieferumfang der ArcGIS Enterprise on Kubernetes-Lizenz ist eine Lizenz für ArcGIS Notebook Services enthalten. Mit dieser Lizenz können Organisationsmitglieder Notebooks unter Verwendung der ArcGIS Notebook Python 3 Standard-Runtime erstellen und Notebook-Workflows mithilfe von geplanten Tasks, Webhooks und Web-Werkzeugen automatisieren.
• Die als Premiumfunktion verfügbare Advanced-Lizenz für ArcGIS Notebook Services ermöglicht den Zugriff auf die ArcGIS Notebook Python 3 Advanced-Runtime mit zusätzlichen ArcPy-Funktionen, die über die in der Lizenz für ArcGIS Notebook Services enthaltenen Funktionen hinausgehen.

Hinweis:

Zur Unterstützung von Notebook-Services müssen alle externen Reverse Proxys oder Load Balancer in der Lage sein, den Websocket-Datenverkehr an die Backend-Ziele weiterzuleiten, und die Anforderungen müssen so festgelegt sein, dass Sitzungen 10 Minuten lang geöffnet bleiben.

Konfigurieren von Notebook-Services

Die folgenden Konfigurationsschritte erfordern möglicherweise Änderungen an der Art der Bereitstellung von ArcGIS Enterprise on Kubernetes in Ihrer Organisation. Lesen Sie diese Informationen sorgfältig durch, bevor Sie den Vorgang fortsetzen.

Aktivieren der Notebook-Services

Zur Aktivierung der Notebook-Services müssen Sie einen Notebook-Workspace konfigurieren und die Funktion in ArcGIS Enterprise Manager aktivieren.

Hinweis:

Vergewissern Sie sich vor dem Aktivieren der Notebook-Services, dass Ihr Administrator genügend Ressourcenkontingente und Worker-Knoten zugewiesen hat, um diese Premium-Funktion zu unterstützen.

1. Klicken Sie in ArcGIS Enterprise Manager auf die Schaltfläche Funktionen auf der Seitenleiste.

   Die Seite mit den Funktionen wird angezeigt.

2. Aktivieren Sie die Umschaltfläche Notebook-Services.

   Das Dialogfeld Workspace konfigurieren wird angezeigt, in dem sie aufgefordert werden, die erforderlichen Werte anzugeben. Im Workspace werden Dateien, die mit den Notebooks der einzelnen Organisationsmitglieder verknüpft sind, gespeichert.

3. Geben Sie die erforderlichen Informationen an:
   1. Wählen Sie für die Bereitstellung persistenter Volumes für den Workspace die Option Dynamisch oder Statisch für Volumetyp aus. Wählen Sie Statisch, wenn der PVC an ein vorhandenes PV gebunden sein soll. Wählen Sie Dynamisch aus, wenn ein neues PV über die angegebene Speicherklasse bereitgestellt werden soll. Weitere Informationen finden Sie unter Überlegungen bei der dynamischen Bereitstellung und statischen Bereitstellung.

      Hinweis:

      Das PV für diesen Workspace muss den Typ FileSystem aufweisen und den Zugriffsmodus ReadWriteMany (RWX) unterstützen. Bevor Sie einen Notebook-Workspace konfigurieren, vergewissern Sie sich, dass das PV, das Sie diesem Workspace zuweisen, den RWX-Zugriffsmodus unterstützt. Zur Unterstützung des PV müssen Sie möglicherweise einen unterstützenden Treiber im Kubernetes-Cluster installieren.

   2. Geben Sie im Textfeld Volumename einen Namen ein.

      Wenn Sie Statisch auswählen, müssen Sie einen Volumenamen angeben.

   3. Geben Sie für Speicherklassenname Ihren eigenen Speicherklassennamen an, oder wenn Sie eine Speicherklasse festgelegt haben, geben Sie den Speicherklassennamen für das Volume an.

      Hinweis:

      Der Name der Speicherklasse ist für "Dynamisch" erforderlich und für "Statisch" optional.

      Hinweis:

      Wenn die Bindung an ein vorhandenes PV erfolgt, für das keine Speicherklasse definiert wurde, lassen Sie den Namen der Speicherklasse leer. Wenn eine Standardspeicherklasse im Cluster konfiguriert wurde, fügt der Admission Controller DefaultStorageClass die Standardspeicherklasse hinzu und verhindert die Bindung des PVC. In diesem Fall sollten Administratoren entweder eine Speicherklassenspezifikation zum PV hinzufügen oder die Standardkonfiguration der Speicherklasse entfernen.

   4. Definieren Sie für Größe (GiB) die Größe des PV.

      Die Mindestgröße beträgt 100 GiB. Der Wert muss der Größe des vorhandenen PV entsprechen, wenn die statische Bindung verwendet wird. Übersteigt der Wert die Größe des vorhandenen PV, wird der PVC nicht an das PV gebunden.

      Hinweis:

      Es kann nur ein Notebook-Workspace für Ihre Organisation konfiguriert werden. Die Speichergröße ist auf den Wert begrenzt, der bei seiner Erstellung angegeben wurde. Achten Sie darauf, dass Sie die Größe des Workspace so auswählen, dass er Ihren aktuellen und zukünftigen Anforderungen gerecht wird.

   5. Klicken Sie auf Speichern.

   Ihnen wird eine Meldung angezeigt, die darauf hinweist, dass der Aktivierungsvorgang einige Zeit in Anspruch nehmen kann.

   Es wird eine Anforderung zum Aktivieren der Notebook-Services übermittelt. Im Rahmen dieses Vorgangs werden die Voraussetzungen geprüft und die unterstützenden Ressourcen aktiviert. Ein Notebook-Automatisierungsservice wird automatisch gestartet.

Sollte beim Aktivieren der Funktion ein Fehler auftreten, wiederholen Sie die obigen Schritte, um sicherzustellen, dass der Workspace konfiguriert wurde, die Lizenz für die Notebook-Services gültig und verfügbar ist und die Systemdienste gestartet wurden. In den Protokollen finden Sie die Anforderungen für diese Funktion.

Sie können optional ein deamonSet bereitstellen, um die Images der Notebook-Services vorab zu laden. Dadurch wird das erstmalige Öffnen eines Notebooks beschleunigt. Für das erstmalige Laden eines Notebooks ist ein Timeout nach einer Minute festgelegt.

Die Notebook-Services sind nun konfiguriert. In Ihrer Organisation können nun Notebooks verwendet werden. Weiterführende Informationen finden Sie unter Erstellen eines Notebooks und Veröffentlichen eines Notebooks als Web-Werkzeug.

Lesen Sie außerdem, wie Sie die Einstellungen für die Notebook-Services anpassen können.

Einstellungen für Notebook-Services

Nach der Freigabe der Notebook Services können Sie die zugehörigen Einstellungen anzeigen und bearbeiten, z. B. die unterstützenden Ressourcen für die entsprechenden Runtimes, die WebSocket-Größe, die maximalen Snapshots pro Notebook-Element und vieles mehr.

Die Funktion der Notebook-Services umfasst drei Hauptregisterkarten, auf denen Sie Einstellungen anzeigen oder bearbeiten können: Überblick, Eigenschaften und Runtimes.

• Überblick: Hier können Sie den Status des Notebook-Automatisierungsservice, die Anzahl der ausgeführten Notebook-Bereitstellungen und die dem dedizierten Notebook-Workspace zugewiesene Speicherklasse festlegen.
• Eigenschaften: Hier können Sie die Limits für interaktive und automatisierte Notebook-Bereitstellungen verwalten.
• Runtimes: Die Einstellungen für verfügbare Notebook-Service-Runtimes anzeigen und bearbeiten.

Anzeigen und Bearbeiten von Eigenschaften

Die folgenden Eigenschaften können in ArcGIS Enterprise Manager angezeigt und bearbeitet werden.

• WebSocket-Größe (MB): Die maximale Größe eines Pakets (in Megabyte), das zwischen dem Server und Client-Browsern mit dem WebSocket-Protokoll übergeben werden kann. WebSocket wird verwendet, um die effiziente, sichere und bidirektionale Kommunikation mit Clients zu vereinfachen. Der Standardwert dieser Eigenschaft ist 16 MB. Möglicherweise müssen Sie diesen Grenzwert erhöhen, wenn eine besonders große Datenmenge von einem Notebook an die Server-Site übergeben wird.
• Schwellenwert für Notebook-Leerlauf (Minuten): Mit dieser Eigenschaft wird gesteuert, wann Notebooks im Leerlauf geschlossen werden. Notebooks, die geöffnet wurden, aber während dieses Zeitraums (in Minuten) nicht aktiv waren, werden automatisch geschlossen. Der Kernel des Notebooks wird gestoppt. Die Standardeinstellung ist 7 Minuten.
• Schwellenwert für leere Bereitstellungen: Mit dieser Eigenschaft wird festgelegt, wie lange eine Notebook-Bereitstellung geöffnet bleiben kann (in Minuten), ohne dass aktive Notebooks ausgeführt werden. Wenn dieser Wert erreicht wird, wird die Bereitstellung automatisch geschlossen. Die Standardeinstellung ist 60 Minuten. Wie bei dem Schwellenwert für den Notebook-Leerlauf können Sie diesen Wert herabsetzen, um Ressourcen zu sparen.
• Maximale Anzahl Snapshots pro Notebook-Element: Diese Eigenschaft begrenzt die Anzahl der für ein Notebook-Element zulässigen Snapshots. Der Standardwert ist 5.

Führen Sie zum Anzeigen und Bearbeiten der Eigenschaften die folgenden Schritte aus:

1. Melden Sie sich bei ArcGIS Enterprise Manager als Administrator an.
2. Klicken Sie auf die Seite Funktionen.
3. Klicken Sie auf der Kachel Notebook-Services auf Einstellungen.
4. Klicken Sie auf die Seite Eigenschaften.

   Wenn Sie einen Einstellungswert ändern, wird die Schaltfläche Speichern verfügbar.

5. Klicken Sie auf Speichern, um Ihre Änderungen dauerhaft zu speichern.

Anzeigen und Bearbeiten von Runtimes

Sie können die folgenden Runtime-Verwaltungsaufgaben in ArcGIS Enterprise Manager durchführen:

• Anzeigen der verfügbaren Runtimes.
• Duplizieren einer systemseitig erstellten Runtime, um eine benutzerseitig erstellte Runtime zu erstellen. Jede Runtime kann separat konfiguriert werden, sodass für unterschiedliche Task-Typen Runtimes mit unterschiedlichen Einstellungen verwendet werden können.
• Anzeigen und Bearbeiten der für die jeweilige Runtime-Bereitstellung verfügbaren Systemressourcen. Wenn mehrere Benutzer gleichzeitig Notebooks erstellen, können Sie die Auslastung überwachen und die Einstellungen bei Bedarf anpassen.
• Steuerung der Knoten, auf denen Pods für eine Runtime geplant werden können. Die Steuerung der Pod-Platzierung ist hilfreich, wenn für Tasks Ressourcen (z. B. eine GPU) erforderlich sind, die nur auf bestimmten Knoten im Cluster verfügbar sind.

Führen Sie zum Anzeigen und Bearbeiten einer Runtime die folgenden Schritte aus:

1. Melden Sie sich bei ArcGIS Enterprise Manager als Administrator an.
2. Klicken Sie auf die Seite Funktionen.
3. Klicken Sie auf der Kachel Notebook-Services auf Einstellungen.
4. Klicken Sie auf die Seite Runtimes, um die Liste der verfügbaren Runtimes anzuzeigen.
5. Wenn Sie eine neue Runtime erstellen möchten, klicken Sie auf Duplizieren neben der systemseitig erstellten Runtime, die Sie duplizieren möchten.
6. Klicken Sie auf den Namen der Runtime, die Sie anzeigen oder bearbeiten möchten.
7. Führen Sie die folgenden Schritte aus, um die Ressourcen anzuzeigen oder zu bearbeiten, auf die die jeweilige Runtime-Bereitstellung zugreifen kann:
   1. Klicken Sie auf Runtime-Einstellungen.
   2. Zeigen Sie die CPU-Anforderungen und CPU-Begrenzungen an, oder bearbeiten Sie sie.
   3. Zeigen Sie die Optionen Speicheranforderungen, Speicherbegrenzungen, Maximaler Swap-Speicher und Gemeinsam genutzter Speicher an, oder bearbeiten Sie sie.
   4. Verwenden Sie die Umschaltfläche GPU aktivieren und den Wert GPU-Einheiten, um den Zugriff der Runtime auf GPU-Ressourcen anzuzeigen oder zu bearbeiten. GPU-Einheiten gibt die Anzahl der GPUs pro Knoten an.

      Hinweis:

      Ihr Kubernetes-Cluster muss für die Aktivierung von GPU-Ressourcen konfiguriert sein. Weitere Informationen finden Sie unter Konfigurieren von GPU-fähigen Knoten.

   5. Klicken Sie auf Speichern, um alle Änderungen dauerhaft zu speichern.
8. Führen Sie die folgenden Schritte aus, um die Einstellungen für die Pod-Platzierung für eine Runtime anzuzeigen oder zu bearbeiten:
   1. Klicken Sie auf Pod-Platzierung.
   2. Zeigen Sie die Optionen Knotenaffinität und Toleranzen an, oder bearbeiten Sie sie.

      Wenn Sie die Knotenaffinität für GPU-aktivierte Notebook-Services konfigurieren, verwenden Sie die folgenden Werte:

      • Typ: Erforderlich
      • Schlüssel: Geben Sie den Schlüssel an, der zur Beschriftung des GPU-Knotens verwendet wird, z. B. notebook.
      • Operator: In
      • Wert: Geben Sie den Wert an, der für die Beschriftung des GPU-Knotens verwendet wird, z. B. NotebooksGPUNode.

      Wenn Sie die Toleranzen für GPU-aktivierte Notebook-Services konfigurieren, verwenden Sie die folgenden Werte:

      • Effekt: Keine Ausführung
      • Schlüssel: nvidia.com/gpu
      • Operator: Ist vorhanden
   3. Klicken Sie auf Hinzufügen, wenn Sie neue Knotenaffinitäten oder Toleranzen konfigurieren.
   4. Klicken Sie auf Speichern, um alle Änderungen dauerhaft zu speichern.
9. Klicken Sie auf Manifest, um die Bibliotheken anzuzeigen, die in der Runtime enthalten sind.