Die folgenden Schritte beschreiben das Herunterladen, Installieren und Konfigurieren der für ArcGIS Notebook Server erforderlichen Software Docker für die Container-Zuordnung. Eine Einführung in Docker und in die Verwendung des Programms in ArcGIS Notebook Server finden Sie unter Docker und ArcGIS Notebook Server.
Docker-Editionen
Docker ist in zwei Editionen verfügbar. Docker Desktop und Mirantis Container Runtime (zuvor Docker Engine-Enterprise).
| Betriebssystem | Docker-Edition | (Container)-Image-Typ für Notebook-Runtime | Zusätzliche Anforderungen |
|---|---|---|---|
Windows Server 2019 Standard und Datacenter Windows Server 2022 Standard und Datacenter | Docker Desktop unter Windows: Version 4.4.4 oder höher | Linux | Hyper-V erforderlich |
Windows Server 2022 Standard und Datacenter | Mirantis Container Runtime Version 20.10 oder höher. | Windows-Betaversion | Die Verwendung von Hyper-V ist optional. Es gibt Beschränkungen bezüglich der maximalen Anzahl an Containern, die mit der Hyper-V-Isolation unter Windows Server 2022 Standard ausgeführt werden kann. Weitere Informationen finden Sie unter Windows FAQ. |
Bei ArcGIS Notebook Server 11.0 ist Docker Desktop die am besten geeignete Edition zur Verwendung mit Windows. Mit dieser Software können Sie ArcGIS Notebook Server ausführen.
Hinweis:
Ab ArcGIS Notebook Server, Version 11.0, unterstützt ArcGIS Notebook Server als Betaversion Mirantis Container Runtime für Windows Server. Für diese Version wird empfohlen, dass Sie ArcGIS Notebook Server mit Mirantis Container Runtime nur für Testzwecke verwenden.
Weitere Informationen zur Verwendung von Mirantis Container Runtime mit ArcGIS Notebook Server 11.0 finden Sie unter Docker und ArcGIS Notebook Server.
Hinweis:
Docker und Mirantis Container Runtime sind Softwarekomponenten von Drittanbietern. Möglicherweise werden in diesem Thema nicht alle Installationsschritte beschrieben. Weitere Informationen zu den Installationsprozessen finden Sie auf den Sites zu Docker und Mirantis Container Runtime.
Installieren von Docker Desktop
Führen Sie die folgenden Schritte aus, um Docker Desktop zu installieren:
- Vergewissern Sie sich, dass Hyper-V auf Ihrem Windows-Computer installiert ist. Suchen Sie dazu nach der Anwendung Hyper-V Manager. Installieren Sie sie gegebenenfalls. Die genauen Schritte finden Sie in der folgenden Microsoft-Dokumentation:
- Bei Verwendung von Windows Server 2022 oder Windows Server 2019 als Betriebssystem finden Sie weitere Informationen unter Install the Hyper-V role on Windows Server.
- Bei Verwendung von Windows 10 finden Sie weitere Informationen unter Install Hyper-V on Windows 10.
ArcGIS Notebook Server erfordert Docker Desktop for Windows (ab Version 4.4.4 oder höher).
- Rufen Sie in einem Browser die Download-Seite für Docker Desktop (Windows) im Docker Hub ab.
- Melden Sie sich bei Ihrem Docker Hub-Konto an, oder registrieren Sie ein neues Konto.
- Laden Sie Docker Desktop herunter.
- Doppelklicken Sie zum Ausführen der Software auf Docker for Windows Installer.
- Deaktivieren Sie im Dialogfeld Configuration des Installationsprogramms das Kontrollkästchen Use WSL2 instead of Hyper-V.
- Schließen Sie das Installationsprogramm nach Abschluss.
- Klicken Sie im Startmenü auf die Schaltfläche Docker Desktop, um Docker zu starten.
- Überprüfen Sie mit einer der folgenden Methoden, ob Docker gestartet wurde:
- Sehen Sie sich den Status des Docker-Symbols auf der Windows-Taskleiste (in der Regel rechts unten auf dem Bildschirm) an.
- Öffnen Sie ein Befehlszeilenfenster, und führen Sie die folgenden Befehle aus:
docker version docker run hello-world
Konfigurieren der Docker-Einstellungen
Ändern Sie nach der Installation von Docker auf Ihrem Computer die folgenden Einstellungen.
Ändern der allgemeinen Einstellungen
Sie verwenden die Docker-Remote-API, die die Verwendung von Port 2375 erfordert. Dieser Port wird lediglich intern von ArcGIS Notebook Server verwendet und sollte vor externen Zugriffen geschützt werden.
- Klicken Sie in der Windows-Taskleiste mit der rechten Maustaste auf die Schaltfläche Docker, und klicken Sie auf Settings.
- Aktivieren Sie auf der Seite General die Option Expose daemon on tcp://localhost:2375 without TLS.
Es kann sein, dass Sie anschließend eine Sicherheitswarnung erhalten. Ihr Systemadministrator muss wissen, dass dieser Port intern verwendet wird und dass keine Zugriffe von außen zugelassen werden sollten.
- Deaktivieren Sie die Option Use the WSL2 based engine, wenn sie aktiviert ist.
Festlegen einer Dateifreigabe
Der Docker-Container muss über Zugriff auf das lokale Laufwerk, das als Workspace-Verzeichnis konfiguriert wird, oder auf ein benutzerdefiniertes Datenverzeichnis für den Notebook-Server verfügen. Führen Sie während der Erstinstallation die folgenden Schritte aus, und wiederholen Sie sie bei jeder Änderung der Anmeldeinformationen für IhrAusführen als-Konto oder des Ausführen als-Kontos selbst. Wenn Sie während der Installation von ArcGIS Notebook Server ein Konto erstellen, werden Sie zu diesen Schritten zurückverwiesen.
- Klicken Sie in der Windows-Taskleiste mit der rechten Maustaste auf die Schaltfläche Docker, und klicken Sie auf Settings.
- Klicken Sie im Menü "Settings" auf Resources > File sharing.
- Fügen Sie den Laufwerks- oder Verzeichnispfad hinzu, der für das Workspace- oder das benutzerdefinierte Datenverzeichnis von ArcGIS Notebook Server verwendet wird.
Hinweis:
Wenn derzeit kein Workspace-Verzeichnis oder benutzerdefiniertes Datenverzeichnis, z. B. C:\arcgisnotebookserver, vorhanden ist, erstellen Sie eine ArcGIS Notebook Server-Site, oder registrieren Sie ein Datenverzeichnis, bevor Sie diesen Schritt ausführen.
Hinweis:
Docker für Windows unterstützt nur lokale Verzeichnisse unter Windows, die für Linux-Container freigegeben werden.
Begrenzen erweiterter Ressourcen
Sie können im Fenster mit den Docker Desktop-Einstellungen die Ressourcen für ArcGIS Notebook Server und die in der Server-Site ausgeführten Container begrenzen.
- Klicken Sie in der Windows-Taskleiste mit der rechten Maustaste auf die Schaltfläche Docker, und klicken Sie auf Settings. Klicken Sie im Menü "Settings" auf Resources > Advanced.
- Optional können Sie die folgenden Einstellungen ändern:
- CPUs: Die Anzahl der auf dem Computer verfügbaren CPU-Kerne. Die Standardeinstellung sind zwei Kerne. Abhängig von den auf dem Computer verfügbaren Ressourcen und den für Notebook-Runtimes festgelegten CPU-Grenzwerten können Sie diesen Wert aktualisieren.
- Memory: Die Menge des auf dem Computer verfügbaren Arbeitsspeichers. Die Standardeinstellung ist 2 GB. Erhöhen Sie den Wert auf mindestens 6 GB. Abhängig von den auf dem Computer verfügbaren Ressourcen und den für Notebook-Runtimes festgelegten Speichergrenzwerten können Sie diesen Wert erhöhen.
- Swap: Die Menge des Festplattenspeichers, die Container bei Erreichen der Arbeitsspeicherobergrenze zusätzlich verwenden können.
- Disk image size: Die Größe des Datenträger-Image. Prüfen und aktualisieren Sie diesen Wert bei Bedarf, wenn Sie Docker Container-Images für Notebooks-Ergebnisse installieren und ein Fehler aufgrund von nicht genügend freiem Speicherplatz auftritt.
- Disk image location: Das Verzeichnis, in dem Container und Images gespeichert werden.
Hinweis:
Sie können jederzeit die für Notebook-Runtimes konfigurierten CPU- und Speicherressourcen prüfen und aktualisieren. - Wenn Sie mit den eingestellten Ressourcenbegrenzungen zufrieden sind, klicken Sie auf Apply.
Installieren von Mirantis Container Runtime unter Windows
Vorsicht:
Mirantis Container Runtime unter Windows wird als Betaversion für ArcGIS Notebook Server unter Windows Server 2022 unterstützt. Im Beta-Stadium können bei diesen Funktionen bekannte Performance- oder Qualitätsprobleme auftreten. Diese werden nicht durch den technischen Support von Esri abgedeckt. Aktivieren Sie Hyper-V nicht. Die Software wird für die Installation von Mirantis Container Runtime unter Windows Server 2022 nicht benötigt. Aktivieren Sie die Funktion "Container" auf Ihrem lokalen Server erst nach der Installation von Mirantis Container Runtime.- Deinstallieren Sie alle Vorversionen von Docker von Ihrem Computer.
- Führen Sie die Schritte in der Mirantis-Dokumentation Install MCR on Windows Server aus.
- Vergewissern Sie sich, dass Mirantis Container Runtime korrekt installiert ist und durch den folgenden Befehl gestartet wurde:
docker run hello-world:nanoserver - Führen Sie nach der Fertigstellung die folgenden Schritte zur Konfiguration von Mirantis Container Runtime aus.
Konfigurieren von Mirantis Container Runtime
Führen Sie die folgenden Schritte aus, um Mirantis Container Runtime auf Ihrem Computer zu konfigurieren.
- Aktivieren Sie Port 2375, um die Docker-Remote-API verwenden zu können.
Dieser Port wird lediglich intern von ArcGIS Notebook Server verwendet und sollte vor externen Zugriffen geschützt werden.
Öffnen Sie als Administrator eine Eingabeaufforderung, und führen Sie den folgenden Befehl aus:
sc config docker binpath= "\"C:\Program Files\docker\dockerd.exe\" --run-service -H tcp://0.0.0.0:2375 -H npipe://" - Öffnen Sie als Administrator ein PowerShell-Fenster, und führen Sie den folgenden Befehl aus:
Restart-Service docker
Starten Sie Ihren Computer nach der Installation der Docker-Komponente neu. Ein Neustart ist nach jedem Installations- oder Upgrade-Vorgang der Docker-Komponente erforderlich.
Sie können jetzt ArcGIS Notebook Server auf Ihrem Computer installieren.