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
Quando você recebe os downloads de software e os arquivos de autorização do My Esri antes da instalação, você também recebe duas imagens de contêiner específicas do Docker para ArcGIS Notebooks. Essas imagens de contêiner fornecem o tempo de execução necessário—uma coleção específica de módulos do Python—para usuários de notebook.
A Esri fornece duas imagens de contêiner do Docker: Standard e Advanced. 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 Standard habilita ArcGIS Notebooks para usar o código de 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 Standard e Advanced estão listados em Visualizar bibliotecas disponíveis do Python.
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
Para usuários Windows, Docker Desktop é a edição apropriada. Este software permite que você execute ArcGIS Notebook Server.
Certifique-se de instalar o versão mínima exigida do Docker Desktop em cada máquina ArcGIS Notebook Server. Para mais informações sobbre como instalar e configurar o Docker, consulte Instale Docker para ArcGIS 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.
Tempos de execução do notebook e imagens de contêiner
Quando um contêiner é iniciado pela primeira vez, ele está quase vazio. As bibliotecas, ferramentas e configurações do sistema que o contêiner precisa para funcionar são fornecidas por meio de um arquivo container image . A imagem do contêiner é aplicada ao contêiner como parte do processo de inicialização.
Dica:
Se você implantou um software na nuvem, provavelmente está familiarizado com imagens de máquinas, que fornecem a máquinas virtuais em branco o código, as ferramentas e as configurações de que precisam para funcionar. As imagens de contêiner funcionam da mesma maneira para o sistema operacional virtual em branco do contêiner.
A Esri fornece duas imagens de contêiner para ArcGIS Notebook Server. Incluído em cada imagem de contêiner está um tempo de execução do notebook, o que torna os recursos do Python disponíveis no ArcGIS Notebooks. Cada tempo de execução empacota uma lista destas bibliotecas e dependências, incluindo uma versão específica de cada biblioteca Python.
Os dois tempos de execução do ArcGIS Notebook Server —Standard (que inclui ArcGIS API for Python e outros módulos do Python) e Advanced (que também inclui ArcPy)—estão disponíveis em notebooks como parte de sua imagem de contêiner correspondente.
Visualizar bibliotecas disponíveis em cada tempo de execução
Dependendo da sua licença, você receberá a imagem do contêiner Padrão ou as imagens do contêiner Padrão e Avançado.
Nas máquinas do Windows, os contêiners em um site do ArcGIS Notebook Server com contêiners do Linux são gerenciados dentro de um emulador Linux denominado MobyLinuxVM, que está contido no ambiente Hyper-V. Da mesma forma, o papel Hyper-V deve ser instalado na máquina. Este requisito está incluído nos requisitos de sistema doArcGIS Notebook Server .
Quando um contêiner é iniciado, uma das duas imagens de contêiner que você recebeu da Esri é aplicada ao contêiner. O tempo de execução e a imagem aplicada dependem dos privilégios do autor de notebook no portal:
- Os autores que receberam somente o privilégio Criar e Editar Notebooks terão seu contêiner carregado com a imagem do contêiner Padrão. Todos os notebooks que eles abrirem usarão o tempo de execução Padrão.
- Os autores que também receberam o privilégio Notebooks Avançados terão seu contêiner carregado com a imagem do contêiner Avançado. O tempo de execução padrão do notebook para seus notebooks é o tempo de execução Avançado. Entretanto, eles têm a opção de especificar o tempo de execução de um notebook individual, e podem utilizar o tempo de execução Padrão ou Avançado em seus notebooks.
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
O seguinte é necessário antes de usar o 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ê pode usar o Docker Desktop. Veja a seção Edições do Docker para a versão mínima exigida. Observe que a documentação da versão do Docker atual não menciona Windows Server 2019 em seus requisitos de sistema.
- O ArcGIS Notebook Server utiliza contêiners Linux em seu componente do Docker. Nas máquinas Windows Server 2019, os contêiners em um site do ArcGIS Notebook Server são gerenciados dentro de um emulador do Linux nomeado MobyLinuxVM, que está contido no ambiente Hyper-V.
- O ArcGIS Notebook Server exige o papel Hyper-V já estar instalado no Windows Server e Windows 10.
- Certos ambientes de virtualização não permitem que o Hyper-V para ser ativado 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:
Há 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.
- O ArcGIS Notebook Server suporta sites de múltiplas máquinas. 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.