Skip To Content

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 systemDocker editionNotebook runtime (Container) image typeAdditional requirements

Windows Server 2022 Standard and Datacenter

Docker Engine - Community version 25.0.0 or later

Windows

Optionally, you can install Hyper-V.

Anotação:

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.

    Anotação:
    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. Se a conta usada para instalar o ArcGIS Notebook Server não faz parte do grupo de administradores, execute as seguintes etapas:
    1. No menu Iniciar em sua máquina Windows, abra o aplicativo Gerenciamento do Computador.
    2. Na barra lateral esquerda, expanda o item Usuários e grupos locais e abra a pasta Grupos.
    3. Escolha o grupo docker-users na lista de grupos e clique duas vezes nele.

      Se um grupo usuários docker ainda não existe, crie um.

    4. Clique no botão Adicionar, localize a conta que você usou para instalar o ArcGIS Notebook Server e escolha-a. Clique em OK para confirmar.
    5. Clique em OK para fechar a caixa de diálogo do grupo.
    6. Crie um arquivo de configuração no C:\ProgramData\docker\config\daemon.json para definir um grupo de segurança para o Docker.
    7. Edite C:\ProgramData\docker\config\daemon.json para adicionar ao grupo usuários docker.

        
      {
        "group" : "docker-users"
      }

  2. Habilite a porta 2375 para poder usar a API remota do Docker. Esta porta só será usada internamente pelo ArcGIS Notebook Server e deve ser protegida contra uso externo. Para habilitar a porta, abra uma janela de comando como administrador e execute o seguinte comando:
    sc config docker binpath= "\"C:\Program Files\docker\dockerd.exe\" --run-service -H tcp://localhost:2375 -H npipe://"
  3. Reinicie o Docker com o seguinte comando:

    net stop docker
    net start docker

  4. Após o componente do Docker ser instalado, reinicie sua máquina.

    Anotação:
    Cada vez que você instala ou atualiza o componente Docker, deve reiniciar a máquina.

Alterar o local de instalação da imagem padrão do Docker

Para alterar o local de instalação da imagem padrão do Docker, siga os passos abaixo:

  1. Edite o arquivo em C:\ProgramData\docker\config\daemon.json.
  2. Defina data-root para o local escolhido em sua máquina local.

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

  3. Reinicie o Docker.