Skip To Content

Docker e ArcGIS Notebook Server

O software de alocação de contêiners Docker é utilizado pelo ArcGIS Notebook Server.

Software Docker

O ArcGIS Notebook Server utiliza software de alocação de contêiners Docker para fornecer segurança e isolar recursos para autores de notebook. Os contêiners são sistemas operacionais virtualizados, em oposição às máquinas virtuais; cada contêiner em uma máquina inclui todos os componentes do sistema operacional em um ambiente isolado. O ArcGIS Notebook Server fornece um contêiner separado para cada usuário no site. Cada usuário possui um contêiner por tempo de execução e os usuários só podem executar notebooks em seu próprio contêiner.

Docker é um componente de software separado de terceiros que deve ser instalado em cada máquina do ArcGIS Notebook Server antes de usar o ArcGIS Notebook Server.

Imagens de contêiner Docker

Ao receber seus downloads de software e arquivos de autorização da My Esri antes da instalação, você também recebe duas imagens de contêiner Docker específicas para ArcGIS Notebooks. Essas imagens de contêiner fornecem o tempo de execução necessário—uma coleção específica de módulos Python—para usuários de notebook.

A Esri fornece duas imagens de contêiner Docker: Padrão e Avançada. Essas duas imagens de contêiner incluem ferramentas e bibliotecas do sistema, bem como várias configurações para configurar o contêiner de forma adequada. Eles também incluem um tempo de execução do notebook: a imagem do contêiner Padrão inclui o tempo de execução do notebook padrão e a imagem do contêiner Avançada inclui o tempo de execução avançada.

O tempo de execução Padrão permite que o ArcGIS Notebooks use código do ArcGIS API for Python e módulos de terceiros. O tempo de execução Avançado contém todos os módulos da imagem padrão e também inclui ArcPy e bibliotecas relacionadas.

Se você tiver uma licença Avançada, deverá baixar e instalar as duas imagens de contêiner do My Esri. Os módulos Python contidos nas imagens padrão e avançadas estão listados em Bibliotecas Python disponíveis.

Para criar notebooks usando o tempo de execução avançado, um usuário deve ser atribuído a uma função no portal que inclui o privilégio de Notebooks Avançados. Na primeira vez que abrirem um notebook, um contêiner será aberto para eles, com a imagem de contêiner Avançada aplicada a ele.

Os autores de notebooks com o privilégio Advanced Notebooks também podem especificar um notebook para usar o tempo de execução padrão. Isso permite que eles compartilhem os notebooks que criaram com usuários que têm acesso apenas ao tempo de execução Padrão. Na primeira vez que eles fizerem isso, um segundo contêiner será iniciado para eles, carregado com a imagem do contêiner Padrão.

Saiba mais sobre os privilégios do usuário de notebook

Por padrão, um contêiner é alocado a uma determinada quantidade de RAM e um determinado número de compartilhamentos de núcleo da CPU. Estes limites de recursos padrão são determinados pelo tempo de execução que está sendo executado pelo contêiner, da seguinte maneira:

  • O tempo de execução Padrão aloca 1 núcleo da CPU e 4 GB de RAM por contêiner.
  • O tempo de execução Avançado aloca 2 núcleos da CPU e 6 GB de RAM por contêiner.

Como um administrador do ArcGIS Notebook Server, monitore o número de autores do notebook que trabalham em seu site e o tempo de execução que cada um está utilizando. Dependendo destes fatores, você pode precisar ou talvez queira alterar os limites de recursos definidos do ArcGIS Notebook Server.

Edições do Docker

Docker está disponível em duas edições. Docker e Mirantis Container Runtime (antigamente Docker Engine-Enterprise). Ambas as edições são consideradas completas.

Anotação:

Consulte o FAQ doDocker para obter mais informações sobre a versão do Docker e os preços.

Para usuários Windows, Docker Desktop é a edição apropriada. Este software permite a você executar o ArcGIS Notebook Server.

Certifique-se de instalar oDocker Desktop 4.4.4 ou posterior, ou Mirantis Container Runtime 20.10.0 ou posterior em cada máquina do ArcGIS Notebook Server . Para mais informações sobre como instalar e configurar Docker, consutle Instalar Docker noArcGIS Notebook Server.

Anotação:

O ArcGIS Notebook Server funcionará apenas com uma das edições do Docker instaladas em uma máquina. Você não pode misturar edições em um site multimáquina.

Mirantis Container Runtime do Windows versão beta

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.

Anotação:

Enquanto estiverem na versão beta, esses recursos podem ter problemas conhecidos de desempenho ou qualidade e não serão suportados pelo suporte técnico da Esri.

Em uma versão futura, a Esri planeja suporte total do ArcGIS Notebook Server com Mirantis Container Runtime para Windows Server e Contêiners do Windows e descontinuará o suporte do ArcGIS Notebook Server para Docker Desktop no Windows.

Anotação:

Veja a página do Mirantis Container Runtime para obter mais informações sobre preços.

Pré-requisitos e restrições para sistemas do Windows

Se você implantar em máquinas ArcGIS Notebook Server nas máquinas do Windows, há uma série de pré-requisitos e restrições a serem considerados. Estes não se aplicam ao desenvolver o ArcGIS Notebook Server em máquinas Linux.

Pré-requisitos do Docker Desktop

  • É recomendado que você utilize máquinas do Windows Server 2019 em um ambiente de produção do ArcGIS Notebook Server. As máquinas do Windows 10 são suportadas apenas para ambientes de desenvolvimento.
  • Se você implantar o ArcGIS Notebook Server no Windows Server 2019, você poderá usar o Docker Desktop (versão 4.4.4 ou posterior). Observe que a documentação da versão do Docker atual não menciona Windows Server 2019 em seus requisitos de sistema.
  • ArcGIS Notebook Server 10.8.x não suporta mais Windows Server 2016.
  • O ArcGIS Notebook Server utiliza contêiners do Linux em seu componente do Docker. Em máquinas Windows, os contêineres em um site do ArcGIS Notebook Server são gerenciados em um emulador Linux denominado MobyLinuxVM, que está contido no ambiente Hyper-V.
  • ArcGIS Notebook Server requer que a função Hyper-V já esteja instalada noWindows Server e Windows 10.
  • Certos ambientes de virtualização não permitem que o Hyper-V seja habilitado e operado no Windows. Como resultado, o ArcGIS Notebook Server não pode ser instalado e operado em tais ambientes.
  • O serviço Docker Desktop deixará de funcionar quando o usuário instalando oDocker sair da máquina do ArcGIS Notebook Server onde oDocker está instalado. Esta máquina do ArcGIS Notebook Server pode estar bloqueada, mas o usuário deve estar registrado no Docker para executar com sucesso. Se o usuário não estiver registrado, a abertura de notebooks falhará com a mensagem Erro, não foi possível carregar o notebook.
    Anotação:

    soluções alternativas para executar oDocker Desktop automaticamente ao reiniciar a máquina do ArcGIS Notebook Server, em vez de ter o usuário registrado.

  • Com início na versão 10.7.1, o ArcGIS Notebook Server suporta sites de máquinas múltiplas. Em sistemas do Windows, o Docker não suporta a montagem de drives compartilhados em contêiners, então o diretório de área de trabalho deve permanecer local em cada máquina. Devido ao fato dos usuários poerem iniciar contêiners e abrir notebooks em cada máquina em um site de máquinas múltiplas, é necessário que o conteúdo no diretório da área de trabalho seja sincronizado através das máquinas. As etapas para configurar um método de replicação são fornecidas em Configurar replicação DFS para ArcGIS Notebook Server.

Pré-requisitos do Mirantis Container Runtime

  • Mirantis Container Runtime atualmente suporta somente Windows Server 2022.
  • Quando o ArcGIS Notebook Server e Mirantis Container Runtime são implantados em várias máquinas, você não precisa mais configurar a replicação (DFS) para seu diretório da área de trabalho. O diretório da área de trabalho pode ser compartilhada como um caminho montado em uma unidade com Mirantis Container Runtime.