Container-Engines und ArcGIS Notebook Server
ArcGIS Notebook Server verwendet Software für die Zuordnung von Docker-Containern.
Docker-Software
ArcGIS Notebook Server verwendet Software für die Zuordnung von Docker-Containern, um Notebook-Autoren die sichere Arbeit mit isolierten Ressourcen zu ermöglichen. Im Gegensatz zu virtuellen Maschinen sind Container virtualisierte Betriebssysteme. Jeder Container auf einem Computer enthält alle Betriebssystemkomponenten in einer isolierten Umgebung. ArcGIS Notebook Server stellt einen separaten Container für jeden Benutzer der Site bereit. Jedem Benutzer gehört immer nur ein Container pro Runtime. Die Benutzer können Notebooks ausschließlich in ihrem eigenen Container ausführen.
Docker ist eine separate Drittanbietersoftwarekomponente, die auf jedem ArcGIS Notebook Server-Computer installiert werden muss, bevor ArcGIS Notebook Server verwendet wird.
Docker-Container-Images
Wenn Sie vor der Installation die Software-Downloads und Autorisierungsdateien von My Esri erhalten, erhalten Sie auch zwei Docker-Container-Images, die speziell für ArcGIS Notebooks vorgesehen sind. Diese Container-Images stellen die erforderliche Runtime (eine spezielle Sammlung von Python-Modulen) für Notebook-Benutzer bereit.
Esri stellt zwei Docker-Container-Images bereit: Standard und Advanced. Diese zwei Container-Images enthalten Systemwerkzeuge und Bibliotheken sowie bestimmte Einstellungen zum geeigneten Konfigurieren des Containers. Außerdem ist eine Notebook-Runtime enthalten: Das Standard-Container-Image enthält die Standard-Runtime, während das Advanced-Container-Image die Advanced-Runtime enthält.
Die Standard-Runtime ermöglicht ArcGIS Notebooks das Verwenden von Code aus ArcGIS API for Python- und Drittanbietermodulen. Die Advanced-Runtime enthält alle Module des Standard-Image und außerdem ArcPy mit den zugehörigen Bibliotheken.
Wenn Sie über eine Advanced-Lizenz verfügen, sollten Sie beide Container-Images von My Esri herunterladen und installieren. Die in den Standard- und Advanced-Images enthaltenen Python-Module finden Sie unter Anzeigen von verfügbaren Python-Bibliotheken.
Damit ein Benutzer mit der Advanced-Runtime Notebooks erstellen kann, muss ihm im Portal eine Rolle zugewiesen sein, die die Berechtigung "Erweiterte Notebooks" besitzt. Beim erstmaligen Öffnen eines Notebooks wird ein spezieller Container gestartet, dem das Advanced-Container-Image zugeordnet ist.
Notebook-Autoren mit der Berechtigung "Erweiterte Notebooks" können auch für ein Notebook festlegen, dass die Standard-Runtime verwendet werden soll. Dies ermöglicht ihnen, selbst erstellte Notebooks mit Benutzern, die nur Zugriff auf die Standard-Runtime haben, gemeinsam zu nutzen. Wenn jene Benutzer dies zum ersten Mal tun, wird für sie ein zweiter Container mit geladenem Standard-Container-Image gestartet.
Weitere Informationen zu Notebook-Benutzerberechtigungen
Standardmäßig erhält ein Container eine bestimmte Menge an Arbeitsspeicher und eine bestimmte Anzahl von Freigaben auf dem CPU-Kern. Diese Ressourcenbegrenzungen werden von der ausgeführten Runtime folgendermaßen festgelegt:
Bei der Standard-Runtime werden 1 CPU-Kern und 4 GB RAM pro Container zugewiesen.
Bei der Advanced-Runtime werden 2 CPU-Kerne und 6 GB RAM pro Container zugewiesen.
Als ArcGIS Notebook Server-Administrator überwachen Sie, wie viele Notebook-Autoren in Ihrer Site arbeiten und welche Runtime sie verwenden. Basierend auf diesen Faktoren können Sie die für ArcGIS Notebook Server festgelegten Ressourcenbegrenzungen ändern.
Docker-Editionen
Docker ist in zwei Editionen verfügbar. Docker und Mirantis Container Runtime (früher Docker Engine-Enterprise). Beide Editionen bieten den vollen Funktionsumfang.
Hinweis:
In den Docker-FAQ finden Sie weitere Informationen über die Docker-Version und Preisgestaltung.
Stellen Sie sicher, dass Sie Docker oder Mirantis Container Runtime auf jedem ArcGIS Notebook Server-Computer installieren. Weitere Informationen zum Installieren und Konfigurieren von Docker finden Sie unter Installieren von Docker für ArcGIS Notebook Server.
Hinweis:
ArcGIS Notebook Server funktioniert nur mit einer der auf einem Computer installierten Docker-Editionen. Auf einer Site mit mehreren Computern können Sie keine Editionen mischen.
Notebook-Runtimes und Container-Images
Beim erstmaligen Starten eines Containers ist dieser nahezu leer. Die Systembibliotheken, Werkzeuge und Konfigurationen, welche der Container für die ordnungsgemäße Funktion benötigt, werden über eine Container-Image-Datei bereitgestellt. Das Container-Image wird im Rahmen des Startprozesses auf das Container-Image angewendet.
Tipp:
Wenn Sie Cloud-Software bereitgestellt haben, sind Sie wahrscheinlich mit Computer-Images vertraut, die leeren virtuellen Maschinen den Code, die Werkzeuge und die Einstellungen bereitstellen, welche für die ordnungsgemäße Funktion erforderlich sind. Container-Images funktionieren auf dieselbe Weise für das leere Betriebssystem des Containers.
Esri stellt zwei Container-Images für ArcGIS Notebook Server bereit. In jedem Container-Image ist eine Notebook-Runtime enthalten, die Python-Ressourcen in ArcGIS Notebooks zur Verfügung stellt. Jede Runtime packt eine Liste dieser Bibliotheken und Abhängigkeiten, einschließlich einer speziellen Version der einzelnen Python-Bibliotheken.
Die beiden ArcGIS Notebook Server-Runtimes "Standard" (enthält die ArcGIS API for Python und weitere Python-Module) und "Advanced" (enthält zudem ArcPy) sind in Notebooks als Bestandteil des entsprechenden Container-Image verfügbar.
In den einzelnen Runtimes verfügbare Bibliotheken anzeigen
Je nach Lizenz erhalten Sie entweder das Standard-Container-Image oder sowohl das Standard- als auch das erweiterte Container-Image.
Wenn ein Container gestartet wird, wird eines der beiden Container-Images, die Sie von Esri erhalten haben, auf den Container angewendet. Die Runtime und das angewendete Image sind von den Berechtigungen abhängig, die dem Notebook-Autor im Portal erteilt wurden:
Wenn Autoren lediglich die Berechtigung zum Erstellen und Bearbeiten von Notebooks haben, wird der Container mit dem Standard-Container-Image geladen. Alle geöffneten Notebooks verwenden die Standard-Runtime.
Wenn Autoren zusätzlich über die Berechtigung "Erweiterte Notebooks" verfügen, wird der Container mit dem erweiterten Container-Image geladen. Die standardmäßige Notebook-Runtime für ihre Notebooks ist die Advanced Runtime. Autoren haben jedoch die Möglichkeit, die Runtime für ein einzelnes Notebook anzugeben und entweder die Standard- oder die Advanced Runtime in ihren Notebooks zu verwenden.
ArcGIS Notebook Server ist mit Windows-Containern kompatibel, wobei entweder die Mirantis Container Runtime oder die Docker Engine aus Binärdateien als Container-Engine-Optionen unter Windows verwendet werden können.
Container-Engines für Windows
Ähnlich wie bei anderen ArcGIS Notebook Server-Bereitstellungen wird ArcGIS Notebook Server mit Windows-Containern auf einem Serverbetriebssystem installiert und mit einem ArcGIS Enterprise-Portal konfiguriert und verbunden. Zusätzlich kann vor der ArcGIS Notebook Server-Software ein Web Adaptor bereitgestellt werden.
ArcGIS Notebook Server verwendet als Container bezeichnete virtualisierte Betriebssysteme, um die Umgebungen von Notebook-Autoren zu isolieren. Daher können Autoren mithilfe der Container einen Teil der Serverressourcen verwenden, ohne dass ihre Arbeit oder Ressourcenverwendung zu Konflikten mit anderen führt.
Diese Container werden von einer Drittanbieter-Container-Engine (Mirantis Container Runtime oder Docker Engine aus Binärdateien) zugewiesen und verwaltet. Vor der Installation von ArcGIS Notebook Server müssen Sie eine Container-Engine installieren. Nach der Installation muss ArcGIS Notebook Server für die Verwendung mit dieser Container-Engine konfiguriert werden.
ArcGIS Notebook Server weist pro Runtime jedem Notebook-Autor in der Site einen Container zu. Nur diese können im Container arbeiten. Die Computerressourcen, die die Autoren beim Ausführen von Notebooks verwenden, haben keine Auswirkungen auf die Container anderer Autoren.
Wenn ein Portal-Mitglied mit den entsprechenden Berechtigungen sein erstes Notebook öffnet, wird ein Container in der ArcGIS Notebook Server-Site gestartet. Die Sitzung zwischen dem Notebook und dem Container wird während der Dauer des Notebooks beibehalten.
ArcGIS Notebook Server kann mehrere Computer in einer Site verbinden. Computer in einer Konfiguration mit mehreren Computern müssen gleich konfiguriert sein. Zudem kann ArcGIS Notebooks auf jedem Computer ausgeführt werden.
Notebook-Runtimes und Windows-Container-Images
Ein einzelnes Windows-Container-Image wird für ArcGIS Notebook Server bereitgestellt. Dieses Container-Image enthält die Notebook-Runtimes "Standard" und "Advanced", über die Python-Ressourcen in ArcGIS Notebooks zur Verfügung gestellt werden. Weitere Informationen zu den in den einzelnen Runtimes verfügbaren Bibliotheken finden Sie unter Verfügbare Python-Bibliotheken.
Die beiden ArcGIS Notebook Server-Runtimes "Standard" und "Advanced" sind in Notebooks als Bestandteil des Container-Image verfügbar. Je nach Lizenz und Benutzerberechtigung ist entweder die Runtime "Standard" oder sowohl die Runtime "Standard" als auch die Runtime "Advanced" verfügbar.
Die Windows-Container in einer ArcGIS Notebook Server-Site unterstützen zwei Modi für die Runtime-Isolation: Prozessisolation und Hyper-V-Isolation. Weitere Informationen zu den Modi finden Sie in der Microsoft-Dokumentation zu Isolationsmodi. Wenn Sie die Site für die Verwendung der Hyper-V-Isolation konfigurieren, muss auf dem Computer die Hyper-V-Rolle installiert sein. Weitere Informationen zur Installation von Hyper-V für Windows Server finden Sie in der Microsoft-Dokumentation.
Hinweis:
Es gibt Beschränkungen bezüglich der Anzahl der Container, die bei Verwendung von Windows-Containern mit Hyper-V ausgeführt werden können. Weitere Informationen finden Sie in den häufig gestellten Fragen zu Containern in der Microsoft-Dokumentation.
Beim Starten eines Containers wird das von Esri bereitgestellte Windows-Container-Image auf den Container angewendet. Die Runtime ist von der für ArcGIS Notebook Server konfigurierten Lizenz und von der Berechtigung des Notebook-Autors abhängig.
Hinweis:
Es ist eine Einschränkung bekannt, die dazu führen kann, dass beim Importieren der torch-Bibliothek oder von Python-Bibliotheken mit torch als Abhängigkeit WinError 1455 auftritt. Weitere Informationen finden Sie unter Allgemeine Probleme und Lösungen.
Voraussetzungen und Einschränkungen für Windows-Systeme
Wenn Sie ArcGIS Notebook Server auf Windows-Computern mit Windows-Containern bereitstellen, sind einige Voraussetzungen und Einschränkungen zu beachten.
Voraussetzungen für Mirantis Container Runtime
Beachten Sie beim Arbeiten mit Mirantis Container Runtime Folgendes:
Mirantis Container Runtime unterstützt aktuell nur Windows Server 2022.
Wenn ArcGIS Notebook Server und Mirantis Container Runtime auf mehreren Computern bereitgestellt werden, müssen Sie keine Replikation (DFS) für Ihr Workspace-Verzeichnis mehr konfigurieren. Das Workspace-Verzeichnis kann als Pfad geteilt werden, der auf einem Laufwerk mit Mirantis Container Runtime bereitgestellt wurde.