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 comoDocker Desktop.
| 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.19.0 ou posterior | Linux | Hyper-V exigido |
Anotação:
Docker é um componente de software de terceiros e este tópico pode não fornecer o processo completo para instalá-lo. Consulte o site Docker para obter mais informações sobre o processo 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 ou 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.
ArcGIS Notebook Server exige Docker Desktop for Windows (versão 4.19.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, 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.
Configurar parâmetros 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.
Alterar o local de instalação da imagem Docker padrão
Para alterar o local de instalação da imagem Docker padrão , siga as etapas abaixo:
- Abra as configurações do Docker Desktop.
- Clique em Recursos > Avançado.
- Defina o Disk image location do caminho do diretório local escolhido em sua máquina.
Configurar o compartilhamento de arquivos
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 .
Configurar 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.
- 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.