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 als Docker Desktop verfügbar.
| 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.19.0 oder höher | Linux | Hyper-V erforderlich |
Hinweis:
Docker ist eine Softwarekomponente eines Drittanbieters. Möglicherweise werden in diesem Thema nicht alle Installationsschritte beschrieben. Weitere Informationen zum Installationsprozess finden Sie auf der Docker-Site.
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 finden Sie Informationen unter Install the Hyper-V role on Windows Server.
- Bei Verwendung von Windows 10 finden Sie Informationen unter Install the Hyper-V role on Windows 10.
ArcGIS Notebook Server erfordert Docker Desktop for Windows (ab Version 4.19.0).
- 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.
Konfigurieren allgemeiner 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.
Ändern des Standardinstallationsverzeichnisses für das Docker-Image
Führen Sie die folgenden Schritte aus, um das Standardinstallationsverzeichnis für das Docker-Image zu ändern:
- Öffnen Sie die Docker Desktop-Einstellungen.
- Klicken Sie auf Resources > Advanced.
- Legen Sie für Disk image location den gewünschten lokalen Verzeichnispfad auf dem Computer fest.
Einrichten der 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.
Konfigurieren 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.
- Ändern Sie die folgenden Einstellungen:
- 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.
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.