Instalar mecanismo de contêiner para ArcGIS Notebook Server (contêiners do Linux).

As etapas abaixo descrevem como fazer o download, instalar e configurar o software de alocação de contêiner Docker exigido pelo ArcGIS Notebook Server. Consulte Docker e ArcGIS Notebook Server para uma introdução para ao Docker e como é usado noArcGIS Notebook Server.

Baixar e instalar o Docker

Há duas edições do Docker disponíveis para sistemas Linux Docker Engine e Mirantis Container Runtime.

Se você estiver executando o Ubuntu ou Red Hat Enterprise Linux Server, você poderá utilizar a edição do Docker.

Edição Docker	Sistema operacional	Tipo de imagem de tempo de execução do notebook (Contêiner)
Docker Engine Community edição 28.3.0 ou posterior Anotação: Se você estiver usando Docker Engine versão 29 ou posterior e não foi atualizado de uma versão anterior, edite/etc/docker/daemon.json para desativar o armazenamento de imagens do contêiner.	Ubuntu Server LTS 24.04.2 Ubuntu Server LTS 22.04.5 Red Hat Enterprise Linux Server 9 atualização 6 Rocky Linux 9 atualização 6 AlmaLinux 9 atualização 6	Linux
Mirantis Container Runtime versão 25.0.11 ou posterior	Ubuntu Server LTS 22.04.5 Red Hat Enterprise Linux Server 9 atualização 6 Oracle Linux 9 atualização 6 SUSE Linux Enterprise Server (SLES) 15 SP7	Linux

Anotação:

Devido ao fato do Docker ser um componente de software de terceiros, este tópico não detalha as etapas completas para instalar o Docker. Revise e consulte o site Docker para obter as informações mais atualizadas.

Instalar Mirantis Container Runtime no Red Hat Enterprise Linux Server, Ubuntu, SUSE Linux Enterprise Server, e Oracle Linux

Para instalar o Mirantis Container Runtime, você deve obter uma avaliação ou assinatura do software.

1. Desinstale qualquer versão anterior do Docker em sua máquina.

   Consulte a documentação do Docker desta versão para etapas completas de desinstalação.

2. Siga as etapas em seu guia de instalação do Linux de distribuição do Mirantis Container Runtime .

   Anotação:

   Atualmente, o Mirantis não tem um guia de instalação separado para Rocky Linux, mas o guia de instalação do Red Hat Enterprise Linux pode ser seguido para instalação no Rocky Linux.

   Anotação:

   O documento descreve os dois métodos que você pode usar para instalar o software (de um repositório do Docker ou por meio de um pacote RPM).

3. Já que o Docker não inicia automaticamente após a instalação e configuração, inicie o daemon Docker executando o seguinte comando:
   $ sudo systemctl start docker

4. Verifique se o Docker está instalado corretamente e pode acessar imagens de contêiner executando o seguinte comando:
   $ sudo docker run hello-world

Prossiga para a seção Definir as configurações e ambientes do Docker abaixo.

Instalar Docker Engine no Red Hat Enterprise Linux Server ou AlmaLinux

A edição do Docker Engine é um download gratuito, mas requer que você tenha uma conta do Docker.

1. Desinstale qualquer versão anterior do Docker em sua máquina.

   Consulte a documentação do Docker desta versão para etapas completas de desinstalação.

2. Siga as etapas em Instalar o Docker Engine no CentOS.

   O documento descreve os dois métodos que você pode usar para instalar o software (de um repositório do Docker ou por meio de um pacote DEB).

   O daemon do Docker inicia automaticamente após a instalação.

3. Verifique se o Docker está instalado corretamente e pode acessar imagens de contêiner executando o seguinte comando:
   $ sudo docker run hello-world

Prossiga para a seção Definir as configurações e ambientes do Docker abaixo.

Instale o Docker Engine no Ubuntu

A edição do Docker Engine é um download gratuito, mas requer que você tenha uma conta do Docker.

1. Desinstale qualquer versão anterior do Docker em sua máquina.

   Consulte a documentação do Docker desta versão para etapas completas de desinstalação.

2. Siga as etapas em Instalar o Docker Engine no Ubuntu.

   O documento descreve os dois métodos que você pode usar para instalar o software (de um repositório do Docker ou por meio de um pacote DEB).

   O daemon do Docker inicia automaticamente após a instalação.

3. Verifique se o Docker está instalado corretamente e pode acessar imagens de contêiner executando o seguinte comando:
   $ sudo docker run hello-world

Prossiga para a seção Definir as configurações e ambientes do Docker abaixo.

Instale o Docker Engine no Rocky Linux

A edição do Docker Engine é um download gratuito, mas requer que você tenha uma conta do Docker.

1. Desinstale qualquer versão anterior do Docker em sua máquina.

   Consulte a documentação do Docker desta versão para etapas completas de desinstalação.

2. Siga as etapas no guia do Rocky LinuxDocker .

   O daemon do Docker inicia automaticamente após a instalação.

3. Verifique se o Docker está instalado corretamente e pode acessar imagens de contêiner executando o seguinte comando:
   $ sudo docker run hello-world

Prossiga para a seção Definir as configurações e ambientes do Docker abaixo.

Defina as configurações e ambientes do Docker

Quando a edição do Docker apropriada for instalado em sua máquina, configure o Docker para utilizar com ArcGIS Notebook Server.

1. Adicione sua conta de usuário do OS (ou conta utilizada para instalar o ArcGIS Notebook Server) para o grupo denominado docker, que foi criado automaticamente na instalação.

   $ sudo usermod -aG docker <ArcGIS Notebook Server install account>

2. Saia e entre novamente na conta de usuário do sistema operacional para que as alterações tenham efeito.
3. Verifique se você consegue executar comandos do Docker a partir da conta.

   $ docker run hello-world

4. Se você estiver usando Docker Engine versão 29 ou posterior e não foi atualizado de uma versão anterior, edite /etc/docker/daemon.json para desativar o armazenamento de imagens do contêiner.

   {
     "features": {
       "containerd-snapshotter": false
     }
   }

   Anotação:

   Se daemon.json não existir, crie-o.

5. Certifique-se de que o diretório /var tenha pelo menos 75 GB de espaço em disco.

   O Docker utiliza o diretório /var como seu registro do sistema local para imagens do contêiner. Durante o processo de atualização de lançamentos subsequentes, novas imagens serão copiadas para o diretório do /var também. Caso não haja espaço suficiente, aumente a alocação para o diretório /var ou siga as etapas abaixo para alterar a localização do diretório raiz do Docker.

   1. Edite /etc/docker/daemon.json para definir o diretório raiz de dados como um diretório local em sua máquina com espaço suficiente.

      Anotação:

      Se este arquivo não existir, crie-o.

      Caminho de exemplo:

      {"data-root" : "/data/docker"}

   2. Remova /var/lib/docker e crie um link simbólico que faça referência ao caminho especificado na etapa anterior.

      $ rm -rf /var/lib/docker
      $ ln -s /data/docker /var/lib/docker

6. Reinicie o serviço Docker para aplicar as alterações.

   $ systemctl stop docker.service
   $ systemctl start docker.service

Você está agora pronto para instalar o ArcGIS Notebook Server em sua máquina.