ArcGIS Notebook Server용 컨테이너 엔진 설치(Linux 컨테이너)

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

Docker 버전

Docker는 Docker Desktop으로 사용할 수 있습니다.

운영 체제	Docker 버전	Notebook 런타임(컨테이너) 이미지 유형	추가 요구사항
Windows Server 2019 Standard 및 Datacenter Windows Server 2022 Standard 및 Datacenter	Docker Desktop의 Windows 4.24.2 버전	Linux	Hyper-V 필요

비고:

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

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를 사용하려면 Docker용 Windows Desktop(4.24.2 버전)이 필요합니다.

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 이미지 설치 위치 변경

기본 Docker 이미지 설치 위치를 변경하려면 아래 단계를 따릅니다.

1. Docker Desktop 설정을 엽니다.
2. 리소스 > 고급을 클릭합니다.
3. 머신의 선택한 로컬 디렉터리 경로에 대한 Disk image location을(를) 설정합니다.

파일 공유 설정

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 런타임에 설정된 메모리 제한에 따라 이 값을 늘릴 수 있습니다.
   • 스왑 — 위의 한도에 도달한 경우 컨테이너가 메모리에 사용할 수 있는 디스크 공간입니다.
   • 디스크 이미지 크기 — 디스크 이미지의 크기입니다. Docker용 Notebooks 컨테이너 이미지를 설치하여 디스크 공간 부족 오류가 발생하는 경우 필요에 따라 이 값을 검토하고 업데이트합니다.
   • 디스크 이미지 위치 — 컨테이너와 이미지가 저장된 디렉터리입니다.

   비고:

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

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

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

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