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
A edição do Docker necessária para executar ArcGIS Notebook Server no Windows é Docker Desktop Community. Isso é acessível através do aplicativo Docker Desktop para Windows. Siga estas etapas para instalar o Docker em sua máquina.
- 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 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 for Windows (versão 3.0.0 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, não permita que o Docker utilize contêiners Windows já que o ArcGIS Notebook Server requer contêiners Linux.
- 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.
Use a porta 2375
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.
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, voltará a esta etapa.
- 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.
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.