ArcGIS Notebook Server용 Docker 설치

아래 단계에는 ArcGIS Notebook Server에 필요한 Docker 컨테이너 할당 소프트웨어를 다운로드, 설치, 구성하는 방법이 설명되어 있습니다. Docker 소개 및 ArcGIS Notebook Server에서 사용하는 방법은 Docker 및 ArcGIS Notebook Server를 참고하세요.

Docker 버전

Docker는 두 가지 버전으로 제공됩니다. Docker Desktop 및 Mirantis Container Runtime(이전 이름: Docker Engine-Enterprise)

운영 체제	Docker 버전	Notebook 런타임(컨테이너) 이미지 유형	추가 요구 사항
Windows Server 2019 Standard 및 Datacenter Windows Server 2022 Standard 및 Datacenter	Windows 4.4.4 이후 버전용 Docker Desktop	Linux	Hyper-V 필요
Windows Server 2022 Standard 및 Datacenter	Mirantis Container Runtime 20.10 이후 버전	Windows 베타 릴리즈	Hyper-V는 선택 사항입니다. Windows Server 2022 Standard에서 Hyper-V 분리로 실행할 수 있는 최대 컨테이너 수에는 제한이 있습니다. 자세한 내용은 Windows FAQ를 참고하세요.

ArcGIS Notebook Server 11.0에서 Docker Desktop은 Windows와 함께 사용하기에 적절한 버전입니다. 이 소프트웨어에서는 ArcGIS Notebook Server를 실행할 수 있습니다.

비고:

ArcGIS Notebook Server 11.0 릴리즈에서 ArcGIS Notebook Server는 Windows Server용 Mirantis Container Runtime을 베타 릴리즈로 지원합니다. 해당 릴리즈의 경우 ArcGIS Notebook Server 및 Mirantis Container Runtime은 테스트 용도로만 사용하는 것을 권장합니다.

11.0에서 Mirantis Container Runtime 및 ArcGIS Notebook Server 사용에 대한 자세한 내용은 Docker 및 ArcGIS Notebook Server를 참고하세요.

비고:

Docker 및 Mirantis Container Runtime은 서드 파티 소프트웨어 컴포넌트이며 이 항목에는 설치를 위한 전체 프로세스가 나와 있지 않을 수 있습니다. 해당 설치 프로세스에 대한 자세한 내용은 Docker 및 Mirantis Container Runtime 사이트를 참고하세요.

Docker Desktop 설치

Docker Desktop을 설치하려면 다음 단계를 완료합니다.

1. Hyper-V Manager 응용프로그램을 검색하여 Windows 머신에 Hyper-V가 설치되어 있는지 확인합니다. 설치되어 있지 않으면 계속하기 전에 설치하세요. 단계는 다음 Microsoft 문서를 참고하세요.
   • OS가 Windows Server 2022 또는 Windows Server 2019인 경우 Windows Server에 Hyper-V 역할 설치를 참고하세요.
   • OS가 Windows 10인 경우 Windows 10에 Hyper-V 설치를 참고하세요.

   ArcGIS Notebook Server를 사용하려면 Windows용 Docker Desktop(4.4.4 이후 버전)이 필요합니다.

2. 브라우저에서 Docker Hub 저장소의 Docker Desktop(Windows) 다운로드 페이지로 이동합니다.
3. 기존 Docker Hub 계정에 로그인하거나 새 계정에 가입합니다.
4. Docker Desktop 소프트웨어를 다운로드합니다.
5. Windows용 Docker 설치 프로그램을 더블 클릭하여 실행합니다.
6. 설치 프로그램의 구성 대화 상자에서 Hyper-V 대신 WSL2 사용의 선택을 취소합니다.
7. 완료되면 설치 프로그램을 닫습니다.
8. 시작 메뉴에서 Docker Desktop 버튼을 클릭하여 Docker를 시작합니다.
9. 다음 방법 중 하나를 사용하여 Docker가 시작되었는지 확인합니다.
   • Windows 시스템 트레이(일반적으로 화면의 우측 하단에 있음)에서 Docker 아이콘의 상태를 확인합니다.
   • 명령 프롬프트 창을 열고 다음 명령을 실행합니다.
     docker version
     docker run hello-world

     첫 번째 명령은 머신의 Docker 버전을 제공합니다. 두 번째 명령은 Docker가 컨테이너 이미지에 접속 및 실행할 수 있는지 확인합니다.

Docker 설정 구성

머신에 Docker가 설치되면 아래에 설명된 설정을 수정합니다.

일반 설정 수정

Docker 원격 API를 사용하며 여기에는 2375번 포트를 사용해야 합니다. 이 포트는 ArcGIS Notebook Server 내부적으로만 사용되며 외부 사용으로부터 보호되어야 합니다.

1. Windows 시스템 트레이의 Docker 버튼을 마우스 오른쪽 버튼으로 클릭한 후 설정을 클릭합니다.
2. 일반 페이지에서 TLS 없이 tcp://localhost:2375에서 데몬 노출 체크 박스를 선택합니다.

   이때 보안 경고를 받을 수 있습니다. 시스템 관리자는 이 포트가 내부적으로 사용되며 포트에 대한 외부 접속이 허용되면 안 된다는 점을 인지하고 있어야 합니다.

3. WSL2 기반 엔진 사용이 선택되어 있으면 선택 취소합니다.

파일 공유 설정

Docker 컨테이너에는 작업 영역 디렉터리로 구성될 로컬 드라이브 또는 Notebook 서버의 사용자 설정 데이터 디렉터리에 대한 접근 권한이 있어야 합니다. 초기 설치 중에 아래 단계를 수행하고 실행 계정의 자격 증명이 변경될 때마다 또는 실행 계정 자체가 변경되는 경우에 이 단계를 반복합니다. ArcGIS Notebook Server 설치 중에 계정을 만들면 이 단계로 돌아갑니다.

1. Windows 시스템 트레이의 Docker 버튼을 마우스 오른쪽 버튼으로 클릭한 후 설정을 클릭합니다.
2. 설정 메뉴에서 리소스 > 파일 공유를 클릭합니다.
3. ArcGIS Notebook Server 작업 영역 또는 사용자 설정 데이터 디렉터리에 사용될 드라이브 또는 디렉터리 경로를 추가합니다.

   비고:

   작업 영역 디렉터리 또는 사용자 설정 데이터 디렉터리가 현재 없는 경우(예시: C:\arcgisnotebookserver), 이 단계를 수행하기 전에 ArcGIS Notebook Server 사이트를 생성하거나 데이터 디렉터리를 등록합니다.

   비고:

   Windows용 Docker는 Linux 컨테이너와 공유할 Windows에서 로컬 디렉터리만 지원합니다.

고급 리소스 제한

Docker Desktop 설정 패널을 사용하여 ArcGIS Notebook Server와 서버 사이트에서 실행 중인 컨테이너에 제공되는 리소스를 제한할 수 있습니다.

1. Windows 시스템 트레이의 Docker 버튼을 마우스 오른쪽 버튼으로 클릭한 후 설정을 클릭합니다. 설정 메뉴에서 리소스 > 고급을 클릭합니다.
2. 필요한 경우 다음 설정을 변경합니다.
   • CPU: 머신의 컨테이너에 제공되는 CPU 코어 수입니다. 기본 설정에 따라 2개의 코어로 설정됩니다. 머신에서 사용 가능한 리소스와 Notebook 런타임에 설정된 CPU 제한에 따라 이 값을 업데이트할 수 있습니다.
   • 메모리: 머신의 컨테이너에 제공되는 메모리 용량입니다. 기본 설정에 따라 이 값은 2GB로 설정되어 있습니다. 이 값을 최소 6GB로 늘립니다. 머신에서 사용 가능한 리소스와 Notebook 런타임에 설정된 메모리 제한에 따라 이 값을 늘릴 수 있습니다.
   • 스왑: 위의 한도에 도달한 경우 컨테이너가 메모리에 사용할 수 있는 디스크 공간입니다.
   • 디스크 이미지 크기 - 디스크 이미지의 크기입니다. Notebooks용 Docker 컨테이너 이미지를 설치하여 디스크 공간 부족 오류가 발생하는 경우 필요에 따라 이 값을 검토하고 업데이트합니다.
   • 디스크 이미지 위치 - 컨테이너와 이미지가 저장된 디렉터리입니다.

   비고:

   Notebook 런타임용으로 구성된 CPU 또는 메모리 리소스를 업데이트할 때 이 단계를 다시 수행합니다.

3. 리소스 한도가 적절히 설정되었다면 적용을 클릭합니다.

Windows에 Mirantis Container Runtime 설치

주의:

Windows용 Mirantis Container Runtime은 Windows Server 2022용 ArcGIS Notebook Server에 대한 베타 릴리즈로 지원됩니다. 베타 버전을 사용하는 동안 이러한 기능에는 알려진 성능 또는 품질 문제가 있을 수 있으며 Esri 기술지원에서 지원하지 않습니다. Hyper-V는 Windows Server 2022용 Mirantis Container Runtime 설치에 필요하지 않으므로 활성화하지 마세요. Mirantis Container Runtime을 설치하기 전에 로컬 서버에서 컨테이너 피처를 활성화하지 마세요.

1. 머신에 설치된 이전 버전의 Docker를 제거합니다.
2. Mirantis에서 제공한 Windows Server 문서의 MCR 설치에 설명된 단계를 따릅니다.
3. 다음 명령을 실행하여 Mirantis Container Runtime이 제대로 설치되었으며 시작되었는지 확인합니다.

   docker run hello-world:nanoserver

4. 완료되면 아래 단계에 따라 Mirantis Container Runtime을 구성합니다.

Mirantis Container Runtime 구성

아래 단계에 따라 머신에서 Mirantis Container Runtime을 구성합니다.

1. Docker 원격 API를 사용하려면 2375 포트를 활성화합니다.

   이 포트는 ArcGIS Notebook Server 내부적으로만 사용되며 외부 사용으로부터 보호되어야 합니다.

   관리자로 명령 프롬프트를 열고 다음 명령을 실행합니다.

   sc config docker binpath= "\"C:\Program Files\docker\dockerd.exe\" --run-service -H tcp://0.0.0.0:2375 -H npipe://"

2. 관리자로 PowerShell 창을 열고 다음 명령을 실행합니다.
   Restart-Service docker

Docker 컴포넌트가 설치되면 머신을 재시작해야 합니다. Docker 컴포넌트를 설치하거나 업그레이드할 때마다 머신을 재시작해야 합니다.

이제 머신에 ArcGIS Notebook Server를 설치할 준비가 되었습니다.