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.
Edições do Docker
Docker está disponível em duas edições. Docker Desktop e Mirantis Container Runtime (antigamente Docker Engine-Enterprise).
| Sistema operacional | Edição Docker | Tipo de imagem de tempo de execução do notebook (Contêiner) | Requisitos adicionais |
|---|---|---|---|
Windows Server 2019 Standard e Datacenter Windows Server 2022 Standard e Datacenter | Docker Desktop no Windows versão 4.4.4 ou posterior | Linux | Hyper-V exigido |
Windows Server 2022 Standard e Datacenter | Mirantis Container Runtime versão 20.10 ou posterior | Windows versão beta | Hyper-V é opcional. Existem limitações para o número máximo de contêiners que podem ser executados com isolamento do Hyper-V no Windows Server 2022 Standard. Consulte FAQ Windows FAQ para maiores informações. |
No ArcGIS Notebook Server 11.0, Docker Desktop é a edição apropriada para usar com Windows. Este software permite que você execute ArcGIS Notebook Server.
Anotação:
No lançamento do ArcGIS Notebook Server 11.0, ArcGIS Notebook Server suporta Mirantis Container Runtime para Windows Server como uma versão beta. Para esta versão, é recomendado que você use ArcGIS Notebook Server com Mirantis Container Runtime apenas para fins de teste.
Para obter mais informações sobre o uso do Mirantis Container Runtime com ArcGIS Notebook Server na versão 11.0, consulte Docker e ArcGIS Notebook Server.
Anotação:
Docker e Mirantis Container Runtime são componentes de software de terceiros e este tópico pode não fornecer o processo completo para instalá-los. Consulte os sites Docker e Mirantis Container Runtime para obter mais informações sobre seus processos de instalação.
Instale o Docker Desktop
Conclua as seguintes etapas para instalar o Docker Desktop:
- Verifique se o Hyper-V está instalado em sua máquina Windows procurando pelo aplicativo Hyper-V Manager. Se não estiver, instale-o antes de continuar. Veja a seguinte documentação da Microsoft para etapas:
- Se o seu OS for Windows Server 2022 ouWindows Server 2019, consulte Instalar o papel Hyper-V no Windows Server.
- Se o seu OS for Windows 10, consulte Instalar Hyper-V no Windows 10.
O ArcGIS Notebook Server requer Docker Desktop para Windows (versão 4.4.4 ou posterior).
- Em um navegador, vá até a página de download Docker Desktop (Windows) no armazenamento Hub do Docker.
- Entre em sua conta Hub do Docker existente ou registre-se em uma nova conta.
- Baixe o software de Desktop Docker.
- Clique duas vezes em Docker for Windows Installer para executá-lo.
- Na caixa de diálogo Configuração do instalador, desmarque Utilizar WSL2 em vez de Hyper-V.
- Feche o instalador quando estiver concluído.
- Clique no botão Docker Desktop no menu Iniciar para iniciar o Docker.
- Verifique que Docker iniciou, utilizando um dos seguintes métodos:
- Verifique o status do ícone do Docker do sistema do Windows (normalmente localizado no canto inferior direito da tela).
- Abra a Janela de Comando e execute os seguintes comandos:
docker version docker run hello-world
Definir configurações do Docker
Após o Docker ser instalado em sua máquina, modifique as configurações descritas abaixo.
Modificar configurações gerais
Você utilizará o Docker Remote API, que exige o uso da porta 2375. Esta porta só será usada internamente pelo ArcGIS Notebook Server e deve ser protegida contra uso externo.
- Clique com o botão direito do mouse no Docker na bandeja de sistema do Windows e clique em Configurações.
- Na página Geral, verifique Expor daemon em tcp://localhost:2375 without TLS.
Você pode receber um aviso de segurança. Certifique-se que o administrador do sistema esteja ciente que essa porta seja usada internamente e que nenhum acesso externo deva ser permitido à porta.
- Desmarque Utilizar o mecanismo baseado em WSL2 se estiver marcado.
Configurar compartilhamento de arquivo
O contêiner do Docker deve ter acesso à unidade local que será configurada como o diretório da área de trabalho ou a um diretório de dados personalizado para o servidor do notebook. Execute as etapas abaixo durante a instalação inicial e repita-as sempre que as credenciais da sua conta Executar Como forem alteradas ou se a própria conta Executar Como mudar. Se você criar uma conta durante a instalação do ArcGIS Notebook Server, será encaminhado de volta a essas etapas.
- Clique com o botão direito do mouse no Docker na bandeja de sistema do Windows e clique em Configurações.
- No menu de configurações, clique em Recursos > Compartilhamento de arquivo.
- Adicione a unidade ou caminho do diretório que será usado para a sua área de trabalho do ArcGIS Notebook Server ou diretório de dados personalizado.
Anotação:
Se um diretório da área de trabalho ou um diretório de dados personalizados não existir atualmente—por exemplo, C:\arcgisnotebookserver—crie um site do ArcGIS Notebook Server ou registre um diretório de dados antes de executar esta etapa.
Anotação:
Docker for Windows suporta somente diretórios locais no Windows que devem ser compartilhados com ontêiners do Linux .
Limitar recursos avançados
Você pode usar o painel de configurações de Desktop do Docker para limitar os recursos disponíveis para ArcGIS Notebook Server e os contêineres em execução no site do servidor.
- Clique com o botão direito do mouse no Docker na bandeja de sistema do Windows e clique em Configurações. No menu de configurações, clique em Recursos > Avançado.
- Opcionalmente, altere as seguintes configurações:
- CPUs—O número de núcleos da CPU disponíveis para contêiners em sua máquina. Por padrão, isso é definido para dois núcleos. Você pode atualizar este valor dependendo dos recursos disponíveis na máquina e dos limites de CPU definidos para os tempos de execução do notebook.
- Memória—A quantidade de memória disponível para contêiners em sua máquina. Por padrão, isso é definido como 2 GB. Aumente para um mínimo de 6 GB. Você pode atualizar este valor dependendo dos recursos disponíveis na máquina e dos limites de CPU definidos para os tempos de execução do notebook.
- Oscilar—A quantidade de espaço em disco que os contêiners podem utilizar para memória, se o limite acima for atingido.
- Tamanho de imagem de disco—O tamanho da imagem de disco. Revise e atualize esse valor conforme necessário se a instalação de imagens de contêiner do Docker para Notebooks resulta em um erro de espaço em disco insuficiente.
- Localização da imagem de disco— O diretório onde os contêiners e as imagens são armazenadas.
Anotação:
Revisite esta etapa sempre que fizer atualizações nos recursos de CPU ou memória configurados para tempos de execução do notebook. - Quando estiver satisfeito com os limites de recursos que você definiu, clique em Aplicar.
Instale o Mirantis Container Runtime no Windows
Aviso:
Mirantis Container Runtime no Windows é suportado como uma versão beta para ArcGIS Notebook Server no Windows Server 2022. Enquanto estiverem na versão beta, esses recursos poderão ter problemas conhecidos de desempenho ou qualidade e não serão suportados pelo Suporte Técnico da Esri. Não habilite o Hyper-V, pois não é necessário para a instalação do Mirantis Container Runtime no Windows Server 2022. Não habilite o recurso Contêiners em seu servidor local antes de instalar Mirantis Container Runtime.- Desinstale qualquer versão anterior do Docker em sua máquina.
- Siga os passos descritos na documentação Instalar MCR no Windows Server fornecido pela Mirantis.
- Verifique se Mirantis Container Runtime está instalado corretamente e foi iniciado executando o seguinte comando:
docker run hello-world:nanoserver - Depois de concluído, siga as etapas abaixo para configurar o Mirantis Container Runtime.
Configurar Mirantis Container Runtime
Siga as etapas abaixo para configurar o Mirantis Container Runtime em sua máquina.
- Habilite a porta 2375 para poder usar a API remota Docker.
Esta porta só será usada internamente pelo ArcGIS Notebook Server e deve ser protegida contra uso externo.
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://0.0.0.0:2375 -H npipe://" - Abra uma janela do PowerShell como administrador e execute o seguinte comando:
Restart-Service docker
Após o componente do Docker ser instalado, reinicie sua máquina. Você deve reiniciar a máquina sempre que instalar ou atualizar o componente Docker.
Você está agora pronto para instalar o ArcGIS Notebook Server em sua máquina.