Poniżej przedstawiono etapy pobierania, instalowania i konfigurowania oprogramowania do przydzielania kontenerów Docker wymaganego przez aplikację ArcGIS Notebook Server. Temat Środowisko Docker i aplikacja ArcGIS Notebook Server zawiera wprowadzenie do środowiska Docker oraz informacje o sposobach jego użytkowania w aplikacji ArcGIS Notebook Server.
Edycje platformy Docker
Platforma Docker jest dostępna w dwóch edycjach. Docker Desktop i Mirantis Container Runtime (wcześniej Docker Engine-Enterprise).
| System operacyjny | Edycja platformy Docker | Typ obrazu środowiska wykonawczego notatników (kontenera) | Wymagania dodatkowe |
|---|---|---|---|
Windows Server 2019 Standard i Datacenter Windows Server 2022 Standard i Datacenter | Docker Desktop w systemie Windows wersja 4.4.4 lub nowsza | Linux | Hyper-V — wymagane |
Windows Server 2022 Standard i Datacenter | Mirantis Container Runtime wersja 20.10 lub nowsza | Windows — wersja beta | Hyper-V jest opcjonalne. Istnieją ograniczenia maksymalnej liczby kontenerów, które mogą działać z izolacją Hyper-V w systemie Windows Server 2022 Standard. Więcej informacji zawiera sekcja Windows — często zadawane pytania. |
W przypadku oprogramowania ArcGIS Notebook Server 11.0 Docker Desktop jest odpowiednią edycją do użycia z systemem Windows. To oprogramowanie umożliwia uruchamianie serwera ArcGIS Notebook Server.
Notatka:
W wersji ArcGIS Notebook Server 11.0 oprogramowanie ArcGIS Notebook Server obsługuje środowisko Mirantis Container Runtime dla systemu Windows Server jako wersja beta. W tej wersji zaleca się używanie oprogramowania ArcGIS Notebook Server ze środowiskiem Mirantis Container Runtime wyłącznie w celach testowych.
Więcej informacji na temat używania środowiska Mirantis Container Runtime z oprogramowaniem ArcGIS Notebook Server w wersji 11.0 można znaleźć w sekcjach Docker i ArcGIS Notebook Server.
Notatka:
Docker i Mirantis Container Runtime to zewnętrzne komponenty oprogramowania i ten temat nie obejmuje całego procesu ich instalacji. Więcej informacji na temat procesu ich instalacji można znaleźć w witrynach oprogramowania Docker i Mirantis Container Runtime.
Instalowanie aplikacji Docker Desktop
Wykonaj następujące czynności, aby zainstalować aplikację Docker Desktop:
- Sprawdź, czy na komputerze z systemem Windows zainstalowano rolę Hyper-V, wyszukując aplikację Hyper-V Manager. Jeśli nie jest zainstalowana, zainstaluj ją przed kontynuacją. Instrukcje można znaleźć w następującej dokumentacji firmy Microsoft:
- W przypadku systemu operacyjnego Windows Server 2022 lub Windows Server 2019 zapoznaj się z dokumentacją Instalowanie roli Hyper-V w systemie Windows Server.
- W przypadku systemu operacyjnego Windows 10 zapoznaj się z dokumentacją Instalowanie roli Hyper-V w systemie Windows 10.
Oprogramowanie ArcGIS Notebook Server wymaga aplikacji Docker Desktop dla systemu Windows (wersja 4.4.4 lub nowsza).
- W przeglądarce przejdź do strony pobierania Docker Desktop (Windows) w sklepie Docker Hub.
- Zaloguj się na istniejące konto Docker Hub lub zarejestruj nowe konto.
- Pobierz oprogramowanie Docker.
- Kliknij dwukrotnie Instalator Docker for Windows, aby go uruchomić.
- W oknie dialogowym instalatora Konfiguracja wyłącz zaznaczenie opcji Użyj WSL2 zamiast Hyper-V.
- Po zakończeniu zamknij instalator.
- Kliknij przycisk Docker Desktop w menu Start, aby uruchomić środowisko Docker.
- Sprawdź, czy środowisko Docker zostało uruchomione, korzystając z jednej z następujących metod:
- Sprawdź status ikony Docker na pasku zadań systemu Windows (zwykle znajduje się w prawym dolnym rogu ekranu).
- Otwórz okno wiersza poleceń i uruchom następujące polecenia:
docker version docker run hello-world
Konfigurowanie ustawień środowiska Docker
Po zainstalowaniu środowiska Docker na komputerze zmodyfikuj opisane poniżej ustawienia.
Modyfikowanie ustawień ogólnych
Używany będzie interfejs Docker Remote API, który wymaga portu 2375. Ten port będzie używany wewnętrznie przez aplikację ArcGIS Notebook Server i należy go chronić przed użyciem z zewnątrz.
- Kliknij prawym przyciskiem myszy przycisk Docker na pasku zadań systemu Windows i kliknij opcję Ustawienia.
- Na stronie Ogólne zaznacz opcję Ujawnij demon w tcp://localhost:2375 bez szyfrowania TLS.
Może zostać wyświetlone ostrzeżenie dotyczące bezpieczeństwa. Upewnij się, że administrator systemu został poinformowany o tym, iż port jest używany wewnętrznie i nie powinien być on dostępny z zewnątrz.
- Wyłącz zaznaczenie opcji Użyj mechanizmu na podstawie WSL2, jeśli jest włączone.
Konfigurowanie udostępniania plików
Kontener Docker musi mieć dostęp do lokalnego dysku, który zostanie skonfigurowany jako katalog przestrzeni roboczej lub do niestandardowego katalogu danych na potrzeby serwera notatników. Wykonaj poniższą czynność podczas instalacji początkowej i powtórz po każdej zmianie poświadczeń konta Uruchom jako lub zmianie samego konta Uruchom jako. Jeśli tworzysz konto podczas instalacji aplikacji ArcGIS Notebook Server, nastąpi powrót do tych czynności.
- Kliknij prawym przyciskiem myszy przycisk Docker na pasku zadań systemu Windows i kliknij opcję Ustawienia.
- W menu ustawień kliknij opcję Zasoby > Udostępnianie plików.
- Dodaj dysk lub ścieżkę katalogu, który będzie używany jako przestrzeń robocza lub niestandardowy katalog danych aplikacji ArcGIS Notebook Server.
Notatka:
Jeśli katalog przestrzeni roboczej lub niestandardowy katalog danych — na przykład C:\arcgisnotebookserver — aktualnie nie istnieje, przed wykonaniem tej czynności utwórz witrynę ArcGIS Notebook Server lub zarejestruj katalog danych.
Notatka:
Środowisko Docker dla systemu Windows obsługuje tylko katalogi lokalne w systemie Windows, które mają być udostępniane kontenerom Linux.
Ograniczanie zasobów zaawansowanych
W celu ograniczenia zasobów dostępnych dla aplikacji ArcGIS Notebook Server i dla kontenerów działających na witrynie serwera można użyć ustawień aplikacji Docker Desktop.
- Kliknij prawym przyciskiem myszy przycisk Docker na pasku zadań systemu Windows i kliknij opcję Ustawienia. W menu ustawień kliknij opcję Zasoby > Zaawansowane.
- Opcjonalnie zmień następujące ustawienia:
- Procesory — liczba rdzeni procesora dostępnych dla kontenerów uruchamianych na komputerze. Domyślnie skonfigurowane są dwa rdzenie. Wartość tę można zaktualizować w zależności od dostępnych zasobów na komputerze i limitów dotyczących procesora skonfigurowanych dla środowisk wykonawczych notatników.
- Pamięć — wielkość pamięci dostępnej dla kontenerów uruchamianych na komputerze. Domyślnie skonfigurowane są 2 GB. Zwiększ tę wartość do co najmniej 6 GB. Wartość tę można zwiększyć w zależności od dostępnych zasobów na komputerze i limitów dotyczących pamięci skonfigurowanych dla środowisk wykonawczych notatników.
- Plik wymiany — wielkość przestrzeni na dysku, którą mogą wykorzystywać kontenery w przypadku osiągnięcia powyższego limitu.
- Rozmiar obrazu dysku — wielkość obrazu dysku. Przejrzyj i zaktualizuj tę wartość odpowiednio do potrzeb, jeśli podczas instalowania obrazów kontenera Docker dla aplikacji Notebooks wystąpi błąd braku miejsca na dysku.
- Lokalizacja obrazu dysku – katalog, w którym zapisywane są kontenery i obrazy.
Notatka:
Wróć do tego etapu za każdym razem, gdy zaktualizujesz zasoby procesora lub pamięci skonfigurowane dla środowisk wykonawczych notatników. - Po skonfigurowaniu właściwych limitów dotyczących zasobów kliknij przycisk Zastosuj.
Instalacja środowiska Mirantis Container Runtime w systemie operacyjnym Windows
Uwaga:
Środowisko Mirantis Container Runtime w systemie Windows jest obsługiwane jako wersja beta dla oprogramowania ArcGIS Notebook Server w systemie Windows Server 2022. W funkcjach w fazie beta mogą występować znane problemy z wydajnością lub jakością i funkcje te nie będą obsługiwane w ramach pomocy technicznej firmy Esri. Nie należy włączać roli Hyper-V, ponieważ nie jest ona wymagana do instalacji środowiska Mirantis Container Runtime w systemie Windows Server 2022. Nie należy włączać funkcji Kontenery na serwerze lokalnym przed zainstalowaniem środowiska Mirantis Container Runtime.- Odinstaluj wszystkie wcześniejsze wersje środowiska Docker na tym komputerze.
- Wykonaj czynności opisane w sekcji Instalowanie MCR w systemie Windows Server w dokumentacji dostarczonej przez Mirantis.
- Sprawdź, czy środowisko Mirantis Container Runtime zostało poprawnie zainstalowane i uruchomione, wykonując następujące polecenie:
docker run hello-world:nanoserver - Następnie wykonaj poniższe czynności, aby skonfigurować środowisko Mirantis Container Runtime.
Konfigurowanie usługi Mirantis Container Runtime
Wykonaj następujące czynności, aby skonfigurować środowisko Mirantis Container Runtime na swoim komputerze.
- Włącz port 2375, aby móc korzystać ze zdalnego interfejsu API środowiska Docker.
Ten port będzie używany wewnętrznie przez aplikację ArcGIS Notebook Server i należy go chronić przed użyciem z zewnątrz.
Otwórz wiersz poleceń jako administrator i wykonaj następujące polecenie:
sc config docker binpath= "\"C:\Program Files\docker\dockerd.exe\" --run-service -H tcp://0.0.0.0:2375 -H npipe://" - Otwórz okno PowerShell jako administrator i wykonaj następujące polecenie:
Restart-Service docker
Po zainstalowaniu komponentu Docker uruchom ponownie komputer. Komputer należy uruchamiać ponownie po każdej instalacji lub aktualizacji komponentu Docker.
Teraz możesz na swoim komputerze zainstalować aplikację ArcGIS Notebook Server.