Skip To Content

Gerenciar recursos do ArcGIS Notebook Server

O ArcGIS Notebooks consume recursos nas máquinas em execução no seu site do ArcGIS Notebook Server . Pelo fato destes recursos serem limitados, o ArcGIS Notebook Server tem configurações administrativas para restringir seu uso.

O ArcGIS Notebook Server utiliza contêiners—sistemas operacionais virtualizados—para isolar o ambiente de cada autor de um notebook. Os contêiners permitem que cada autor utilize um subconjunto de recursos do servidor sem que seu uso de trabalho ou recurso interfira nos outros. Estes contêiners são alocados e mantidos pelo Docker Engine em execução na sua máquina.

Cada autor do notebook é alocado em um contêiner, que é aberto quando eles abrem seu primeiro notebook. Somente o autor do notebook pode trabalhar em seu contêiner e os recursos do computador que eles utilizam em seu contêiner são isolados de outros contêiners.

Quando o contêiner é aberto, seu sistema operacional virtual e configurações são definidos através de uma imagem de contêiner. Esta será uma das duas imagens de contêiner que você recebeu da Esri.

Incluído nesta imagem de contêiner está um tempo de execução do notebook, que é uma coleção de módulos e dependências do Python. O conteúdo do tempo de execução está disponível em cada notebook que executa no contêiner.

A imagem de contêiner utilizada depende dos privilégios de autor do notebook no portal como segue:

  • Os autores que receberam somente o privilégio Criar e Editar Notebooks terão seu contêiner carregado com a imagem de contêiner Padrão. O tempo de execução Padrão do notebook para seus notebooks inclui ArcGIS API for Python e várias centenas de bibliotecas do Python de terceiros.
  • Os autores que também receberam o privilégio Notebook Avançado terão seu contêiner carregado com a imagem de contêiner Avançada. O tempo de execução padrão do notebook para seus notebooks é o tempo de execução Avançado, que inclui todos os módulos do tempo de execução Padrão junto com o ArcPy e suas bibliotecas relacionadas. Eles têm a opção de especificar o tempo de execução de um notebook individual, e pode utilizar o tempo de execução Padrão ou Avançado em seus notebooks.

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 para ArcGIS Notebook Server.

Configurar limites de recurso para seu site do ArcGIS Notebook Server

Em implantações do ArcGIS Notebook Server no Windows, contêiners do notebook são hospedados na máquina em uma máquina virtual do Linux(MobyLinuxVM) executando no servidor de virtualização do Microsoft Hyper-V . Esta máquina virtual do Linux rege os limites de recursos disponíveis para uso pelos contêiners.

Arquitetura do ArcGIS Notebook Server no Windows

Assim, você pode utilizar o painel de configurações do Docker Desktop para limitar os recursos disponíveis no ArcGIS Notebook Server e os contêiners em execução no site do seu servidor.

  1. Clique com o botão direito no ícone do Docker na bandeja do sistema Windows e navegue até Configurações > Avançado.
  2. Você visualizará três controles deslizantes que você poderá utilizar para alterar as seguintes configurações:
    • CPUs—O número de núcleos da CPU disponíveis para contêiners em sua máquina.
    • Memória—A quantidade de memória disponível para contêiners em sua máquina.
    • Oscilar—A quantidade de espaço em disco que os contêiners podem utilizar para memória, se o limite acima for atingido.
  3. Quando estiver satisfeito com os limites de recursos que você definiu, clique em Aplicar.

Atualizar os recursos utilizados por cada tempo de execução

Como administrador, você pode atualizar a CPU e a memória máxima disponível por contêiner, alterando os recursos que cada tempo de execução do notebook utiliza por padrão. Se houver vários usuários criando notebook simultaneamente, você poderá monitorar o uso do seu site e ajustar estas configurações conforme necessário utilizando o ArcGIS Notebook Server Administrator Directory.

  1. Entre no ArcGIS Notebook Server Administrator Directory. A URL está formatada como https://notebookserver.domain.com:11443/arcgis/admin.
  2. Navegue até notebook > tempos de execução.
  3. Selecione o tempo de execução (Padrão ou Avançado, se aplicável) com os limites de recursos que você deseja atualizar.
  4. Atualize os valores maxCpu (em núcleos) e maxMemory (em GB) para o tempo de execução.
  5. Clique em Atualizar Tempo de Execução para confirmar.

Monitorar seus contêiners em execução

Pelo fato de cada contêiner no seu site do ArcGIS Notebook Server utilizar recursos de computação durante a execução, você deve monitorar regularmente os contêiners ativos em seu site e seu nível de atividade. Você pode utilizar recursos no ArcGIS Notebook Server Administrator Directory para visualizar informações sobre os contêiners e notebooks em execução do seu site.

Se um contêiner em execução não tiver sido utilizado recentemente ou se você souber que seu proprietário concluiu seu trabalho com notebooks, você poderá utilizar o diretório para encerrar o contêiner. Isto não excluirá os itens do portal do notebook e não impedirá que o membro do portal abra um novo contêiner. O contêiner encerrado não consumirá mais memória ou CPU.

  1. Entre no ArcGIS Notebook Server Administrator Directory. A URL está formatada como https://notebookserver.domain.com:11443/arcgis/admin.
  2. Navegue até system > containers.

    A página de recursos dos contêiners lista cada contêiner em execução, com o nome de usuário do membro do portal que tem o contêiner mostrado entre parênteses.

  3. Clique em um link de contêiner para abrir seu recurso de informações.

    Na página de recursos do contêiner, você pode visualizar informações sobre ele.

  4. Clique em Sessões do Contêiner para visualizar uma lista de notebooks em execução no contêiner.

    Cada notebook tem um kernel, que serve como seu mecanismo de computação para todas as operações. Note o valor fornecido para cada last_activity do kernel; este registro de data e hora indica a última vez que cada notebook foi acessado, executado ou editado.

  5. Se você identificar um contêiner em execução, mas não for utilizado, considere encerrá-lo. Opcionalmente, na página de recursos do contêiner, clique em Encerrar Contêiner e confirme a operação.

    Isto interrompe e destrói o contêiner em execução; é uma operação irreversível. Na próxima vez que o membro do portal abrir um ArcGIS Notebook, um novo contêiner será aberto.