바이너리(Windows 컨테이너)에서 Docker Engine 설치

Windows 컨테이너가 있는 ArcGIS Notebook Server는 바이너리에서 Docker Engine 설치를 지원합니다.

요구사항

바이너리에서 Docker Engine 설치에는 다음과 같은 요구 사항이 있습니다.

운영 체제	Docker 에디션	Notebook 런타임(컨테이너) 이미지 유형	추가 요구사항
Windows Server 2022 Standard 및 Datacenter	Docker Engine - Community 27.1.2 이상 버전	Windows	필요한 경우 Hyper-V를 설치할 수 있습니다. 비고: Windows Server 2022 Standard에서 Hyper-V 분리로 실행할 수 있는 최대 컨테이너 수에는 제한이 있습니다. 자세한 내용은 Windows FAQ를 참고하세요.

바이너리에서 Docker Engine 설치

바이너리에서 Docker Engine을 설치하려면 다음 단계를 완료합니다.

1. 머신에 설치된 이전 버전의 Docker를 제거합니다.
2. 로컬 서버에서 컨테이너 피처가 활성화된 경우 비활성화합니다.

   자세한 내용은 Microsoft 문서를 참고하세요.

3. Windows PowerShell에서 관리자 권한으로 다음 명령을 실행하여 Windows 컨테이너 피처를 활성화합니다.

   Add-WindowsFeature Containers

4. 메시지에 따라 머신을 다시 시작합니다.
5. 다음 명령을 실행하여 컨테이너 피처의 설치를 확인합니다.

   Get-WindowsFeature Containers

6. Docker 문서의 Windows에 서버 및 클라이언트 바이너리 설치 섹션의 지침을 따릅니다.

   비고:

   바이너리의 Docker Engine은 자동으로 업데이트되지 않습니다. 최신 버전의 Docker로 직접 업데이트해야 합니다. 프로덕션 환경에서 바이너리의 Docker 사용 시 제한 사항에 대한 자세한 내용은 바이너리의 Docker Engine 설치 문서를 참고하세요. 이 페이지에서는 Docker Desktop 사용을 권장하지만 Windows 컨테이너가 있는 ArcGIS Notebook Server는 컨테이너 엔진으로 Windows용 Docker Desktop을 지원하지 않습니다.

7. 환경 경로 변수에 docker 디렉터리 경로(예시: C:\Program Files\docker)를 추가합니다.
8. 다음 명령을 실행하여 설치 및 Docker 데몬 실행 상태를 확인합니다.

   docker version

Docker Engine 구성

Docker Engine을 구성하려면 다음 단계를 완료합니다.

1. ArcGIS Notebook Server를 설치하는 데 사용된 계정이 관리자 그룹의 일부가 아닌 경우 다음 단계를 수행하세요.
   1. Windows 머신의 시작 메뉴에서 컴퓨터 관리 응용프로그램을 엽니다.
   2. 좌측 사이드바에서 로컬 사용자 및 그룹 항목을 확장하고 그룹 폴더를 엽니다.
   3. 그룹 목록에서 docker-users 그룹을 선택하고 더블 클릭합니다.

      docker-users 그룹이 아직 존재하지 않는 경우 해당 그룹을 생성합니다.

   4. 추가 버튼을 클릭하고 ArcGIS Notebook Server를 설치하는 데 사용한 계정을 찾아 선택합니다. 확인을 클릭하여 확인합니다.
   5. 확인을 클릭하여 그룹 대화 상자를 닫습니다.
   6. C:\ProgramData\docker\config\daemon.json에 구성 파일을 생성하여 Docker의 보안 그룹을 설정합니다.
   7. C:\ProgramData\docker\config\daemon.json를 편집하여 docker-users 그룹을 추가합니다.

        
      {
        "group" : "docker-users"
      }

2. Docker 원격 API 사용을 활성화하려면 2375 포트를 활성화합니다. 이 포트는 ArcGIS Notebook Server 내부적으로만 사용되며 외부 사용으로부터 보호되어야 합니다. 포트를 활성화하려면 관리자로 명령 프롬프트를 열고 다음 명령을 실행합니다.
   sc config docker binpath= "\"C:\Program Files\docker\dockerd.exe\" --run-service -H tcp://localhost:2375 -H npipe://"

3. 다음 명령으로 Docker를 다시 시작합니다.

   net stop docker
   net start docker

4. Docker 컴포넌트가 설치되면 머신을 재시작해야 합니다.

   비고:

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

기본 Docker 이미지 설치 위치 변경

기본 Docker 이미지 설치 위치를 변경하려면 다음 단계를 완료합니다.

1. C:\ProgramData\docker\config\daemon.json에서 파일을 편집합니다.
2. 로컬 머신의 선택한 위치에 data-root를 설정합니다.

    {
   "data-root": "d:\\docker"
   }

3. Docker를 다시 시작합니다.