Install Docker Engine from binaries (Windows containers)

Introduced at 11.3, ArcGIS Notebook Server with Windows containers supports installing Docker Engine from binaries.

Requirements

Installing Docker Engine from binaries has the following requirements:

Operating system	Docker edition	Notebook runtime (Container) image type	Additional requirements
Windows Server 2022 Standard and Datacenter	Docker Engine - Community version 25.0.0 or later	Windows	Optionally, you can install Hyper-V. 비고: There are limitations to the maximum number of containers that can run with Hyper-V isolation on Windows Server 2022 Standard. See the Windows FAQ for more information.

Install Docker Engine from binaries

Complete the following steps to install Docker Engine from binaries:

1. Uninstall any previous version of Docker on your machine.
2. Disable the Containers feature on your local server if it is enabled.

   See the Microsoft documentation for more information.

3. Enable the Windows Containers feature by running the following command in Windows PowerShell with administrative privileges:

   Add-WindowsFeature Containers

4. Follow the prompts to restart your machine.
5. Verify the installation of the Containers feature by running the following command:

   Get-WindowsFeature Containers

6. Follow the instructions in the Install server and client binaries on Windows section in the Docker documentation.

   비고:

   Docker Engine from binaries does not update automatically. You must manually update to newer versions of Docker. See the Install Docker Engine from binaries documentation for more information on the limitations of using Docker from binaries in a production environment. Although this page recommends using Docker Desktop, ArcGIS Notebook Server with Windows Containers does not support Docker Desktop on Windows as a container engine.

7. Add the docker directory path, for example, C:\Program Files\docker, to the environment path variables.
8. Verify your installation and Docker daemon running status by running the following command:

   docker version

Configure Docker Engine

Complete the following steps to configure 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를 다시 시작합니다.