Die Software Docker wird für die Container-Zuordnung in ArcGIS Notebook Server verwendet.
Docker-Software
ArcGIS Notebook Server verwendet die Software Docker für die Container-Zuordnung, 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
Für Windows-Benutzer ist Docker Desktop die richtige Edition. Mit dieser Software können Sie ArcGIS Notebook Server ausführen.
Stellen Sie sicher, dass die erforderliche Mindestversion von Docker Desktop auf jedem ArcGIS Notebook Server-Computer installiert ist. 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 Editionen von Docker. 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 umfasst 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 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.
Auf Windows-Computern werden die Container in einer ArcGIS Notebook Server-Site mit Linux-Containern innerhalb des Linux-Emulators MobyLinuxVM verwaltet, der in der Hyper-V-Umgebung enthalten ist. Entsprechend muss die Hyper-V-Rolle auf dem Computer installiert sein. Dieser Anforderung ist Bestandteil der Systemanforderungen für ArcGIS Notebook Server.
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.
Voraussetzungen und Einschränkungen für Windows-Systeme
Wenn Sie ArcGIS Notebook Server auf Windows-Computern bereitstellen, sind einige Voraussetzungen und Einschränkungen zu beachten. Diese gelten allerdings nicht für das Bereitstellen von ArcGIS Notebook Server auf Linux-Computern.
Voraussetzungen für Docker Desktop
Vor der Verwendung von Docker Desktop müssen die folgenden Voraussetzungen erfüllt sein:
- Es wird empfohlen, dass Sie Windows Server 2019-Computer in einer Produktionsumgebung von ArcGIS Notebook Server verwenden. Windows 10-Computer werden nur für Entwicklungsumgebungen unterstützt.
- Wenn Sie ArcGIS Notebook Server auf Windows Server 2019 bereitstellen, können Sie Docker Desktop verwenden. Informationen zur erforderlichen Mindestversion finden Sie im Abschnitt Docker-Editionen. Beachten Sie, dass in der Dokumentation zu Docker für die aktuelle Version die Unterstützung von Windows Server 2019 in den Systemanforderungen nicht aufgeführt ist.
- ArcGIS Notebook Server verwendet in der eigenen Docker-Komponente Linux-Container. Auf Windows Server 2019-Computern werden die Container in einer ArcGIS Notebook Server-Site innerhalb des Linux-Emulators "MobyLinuxVM" verwaltet, der in der Hyper-V-Umgebung enthalten ist.
- ArcGIS Notebook Server erfordert, dass die Hyper-V-Rolle bereits in Windows Server und Windows 10 installiert ist.
- In bestimmten Virtualisierungsumgebungen ist es nicht möglich, Hyper-V unter Windows zu aktivieren und zu betreiben. Daher kann ArcGIS Notebook Server in diesen Umgebungen nicht installiert und betrieben werden.
- Die Ausführung des Docker Desktop-Service wird beendet, wenn sich der Benutzer, der Docker installiert, bei dem ArcGIS Notebook Server-Computer abmeldet, auf dem Docker installiert ist. Dieser ArcGIS Notebook Server-Computer kann gesperrt werden, aber der Benutzer muss für die erfolgreiche Ausführung von Docker angemeldet sein. Wenn der Benutzer nicht angemeldet ist, schlägt das Öffnen von Notebooks mit der Fehlermeldung Notebook kann nicht geladen werden fehl.
Hinweis:
Es gibt alternative Lösungen für die automatische Ausführung von Docker Desktop beim Neustart des ArcGIS Notebook Server-Computers, sodass sich der Benutzer nicht mehr anmelden muss.
- ArcGIS Notebook Server unterstützt Sites mit mehreren Computern. In Windows-Systemen unterstützt Docker das Bereitstellen von freigegebenen Laufwerken auf Containern nicht, daher muss das Workspace-Verzeichnis lokal auf jedem Computer bleiben. Da Benutzer auf jedem Computer in einer Site mit mehreren Computern Container starten und Notebooks öffnen können, ist es notwendig, dass die Inhalte im Workspace-Verzeichnis computerübergreifend synchronisiert werden. Die Schritte zum Konfigurieren einer Replikationsmethode werden unter Konfigurieren einer DFS-Replikation für ArcGIS Notebook Server beschrieben.