Criar uma instância de notebooks gerenciados pelo usuário

Uma instância de notebooks gerenciados pelo usuário é uma instância de máquina virtual de aprendizado profundo com as mais recentes bibliotecas de aprendizado de máquina e ciência de dados pré-instaladas. Como opção, é possível incluir GPUs Nvidia para aceleração de hardware.

Antes de começar

Siga as etapas em Antes de começar para criar um projeto do Google Cloud e ativar a API Notebooks.

Criar uma instância de notebooks gerenciados pelo usuário com propriedades padrão.

Para criar uma instância de notebooks gerenciados pelo usuário com propriedades padrão, execute as etapas a seguir. Para especificar as propriedades da instância, consulte Criar uma instância de notebooks gerenciada pelo usuário com propriedades específicas ou acesse notebook.new para acessar diretamente a caixa de diálogo de criação de instância Criar um notebook gerenciado pelo usuário.
  1. No Console do Google Cloud, acesse a página "Notebooks".

    Acesse o Notebooks

  2. Verifique se a guia Notebooks gerenciados pelo usuário está selecionada.

  3. Clique em Novo notebook.

  4. Selecione um tipo de instância e, então, escolha se quer incluir uma GPU.

  5. Se você optar por incluir uma GPU, será necessário selecionar a opção Instalar o driver da GPU NVIDIA automaticamente para mim. É possível ajustar o número de GPUs posteriormente, se necessário. Para informações sobre como ajustar o número de GPUs, consulte Gerenciar aceleradores de hardware para um notebook.

  6. Clique em Criar.

  7. O Vertex AI Workbench inicia automaticamente a instância. Quando a instância estiver pronta para uso, o Vertex AI Workbench ativa um link Abrir JupyterLab.

Criar uma instância de notebooks gerenciados pelo usuário com propriedades específicas

Para criar uma instância de notebooks gerenciada pelo usuário com propriedades diferentes das fornecidas pelos tipos de instância padrão, especifique as propriedades preferidas ao criar uma instância. É possível especificar as propriedades preferidas usando o Console do Google Cloud, notebook.new (https://notebook.new) ou o comando gcloud. -line:

Console

  1. No Console do Google Cloud, acesse a página "Notebooks".

    Acesse o Notebooks

  2. Verifique se a guia Notebooks gerenciados pelo usuário está selecionada.

  3. Clique em Nova instância e, em seguida, selecione Personalizar instância.

  4. A página Criar um notebook gerenciado pelo usuário é aberta.

    Para informações sobre como concluir a caixa de diálogo Criar um notebook gerenciado pelo usuário, consulte Definir propriedades da instância.

notebook.new

  1. Acesse notebook.new (https://notebook.new).

  2. A caixa de diálogo Criar um notebook gerenciado pelo usuário é aberta.

    Para informações sobre como concluir a caixa de diálogo Criar um notebook gerenciado pelo usuário, consulte Definir propriedades da instância.

gcloud

Por padrão, a ferramenta de linha de comando gcloud cria uma instância de notebooks gerenciada pelo usuário com um endereço IP externo. Se você criar uma instância sem um endereço IP externo, será necessário especificar uma sub-rede com o Acesso privado do Google ativado. Para mais informações, consulte Opções de configuração de rede.

  1. Para criar uma instância de notebooks gerenciada pelo usuário na linha de comando, no Cloud Shell ou em qualquer terminal em que a ferramenta de linha de comando gcloud esteja instalada, digite o seguinte comando gcloud notebooks:

     gcloud notebooks instances create INSTANCE_NAME
         --vm-image-project=deeplearning-platform-release
         --vm-image-family=VM_IMAGE_FAMILY
         --machine-type=MACHINE_TYPE
         --location=LOCATION
     

    Substitua:

    • INSTANCE_NAME: o nome da nova instância.
    • VM_IMAGE_FAMILY: o nome da família de imagens que você quer usar para criar sua instância
    • MACHINE_TYPE: o tipo de máquina da VM da instância
    • LOCATION: o local do Google Cloud em que você quer que a nova instância fique
  2. Acesse a instância no Console do Cloud.

    Para informações sobre todos os comandos usados na criação de uma instância na linha de comando, consulte a documentação da ferramenta gcloud.

Definir propriedades da instância

  1. Na página Criar um notebook gerenciado pelo usuário, forneça as seguintes informações para a nova instância:

    • Nome do notebook: forneça um nome para a nova instância.
    • Região: selecione uma região para a nova instância. Para ter o melhor desempenho de rede, selecione a região mais próxima de você.
    • Zona: selecione uma zona na região escolhida.
    • Sistema operacional: selecione o sistema operacional que você quer usar.
    • Ambiente: selecione o ambiente que você quer usar.
    • Script: (opcional) clique em Procurar para selecionar um script a ser executado após a criação da instância. Esse script é executado apenas uma vez após a criação da instância do notebook. O caminho precisa ser um URL ou do Cloud Storage, por exemplo: gs://<var>PATH_TO_FILE</var>/<var>FILE_NAME</var>.
    • Metadados personalizados: opcional: informe as chaves de metadados personalizadas para a instância.
    • Tipo de máquina: selecione o número de CPUs e a quantidade de RAM para a nova instância. O Vertex AI Workbench fornece estimativas de custo mensais para cada tipo de máquina selecionada.
    • GPUs: selecione o Tipo de GPU e o Número de GPUs para a nova instância. Para informações sobre as diferentes GPUs, consulte GPUs no Compute Engine.

      Marque a caixa de seleção Instalar automaticamente o driver da GPU NVIDIA.

      É possível modificar o tipo e o número de GPUs da instância após a criação. Veja mais informações em Gerenciar aceleradores de hardware em um notebook.

    • VM protegida: opcional: marque as caixas de seleção para ativar a Inicialização segura, ativar o vTPM e o monitoramento de integridade.

    • Discos: opcional: para alterar as configurações padrão de inicialização ou de disco de dados, expanda a seção Discos. Selecione as opções Tipo de disco de inicialização, Tamanho do disco de inicialização em GB, Tipo de disco de dados e Tamanho do disco de dados em GB que você quer. Para mais informações sobre tipos de disco, consulte Opções de armazenamento.

    • Criptografia: para alterar a configuração de criptografia da Chave de criptografia gerenciada pelo Google para Chave de criptografia gerenciada pelo cliente (CMEK), consulte Chaves de criptografia gerenciadas pelo cliente.

    • Rede: para alterar as configurações de rede, como selecionar uma nuvem privada virtual, desativar o acesso ao proxy ou desativar o endereço IP externo, faça o seguinte passos:

      1. Expanda a seção Rede.

      2. Selecione Redes neste projeto ou Redes compartilhadas comigo.

      3. No campo Rede, selecione uma rede. É possível selecionar uma rede VPC, desde que ela tenha o Acesso privado do Google ativado ou tenha acesso à Internet. Para mais informações, consulte Opções de configuração de rede.

      4. No campo Sub-rede, selecione a sub-rede que você quer.

      5. Para desativar o endereço IP externo, defina o campo IP externo como Nenhum.

      6. Para desativar o acesso ao proxy, desmarque a caixa de seleção ao lado de Permitir acesso ao proxy quando ele estiver disponível.

    • Permissão: para conceder acesso a todos os usuários que tenham acesso a uma conta de serviço específica do Compute Engine ou a um usuário específico, expanda a seção Permissão e conclua. as seguintes etapas:

      1. Defina o campo Acesso ao JupyterLab como Conta de serviço ou Somente usuário único. Para Somente usuário único, no campo E-mail do usuário, digite o endereço de e-mail que você quer usar. Para mais informações sobre contas de serviço, consulte Tipos de contas de serviço.
      2. Na seção Identidade e acesso à API, marque ou desmarque a caixa de seleção Usar a conta de serviço padrão do Compute Engine e especifique uma conta de serviço.
    • Segurança: marque ou desmarque as seguintes caixas de seleção:

      • Ativar o acesso raiz à instância
      • Ativar nbconvert
      • Ativar o download de arquivos pela IU do JupyterLab
    • Upgrade do ambiente e integridade do sistema: para fazer upgrade automaticamente para versões recém-lançadas do ambiente, expanda a seção Upgrade do ambiente e integridade do sistema. e conclua as seguintes etapas:

      1. Marque a caixa de seleção Ativar upgrade automático do ambiente.
      2. Escolha se você quer fazer upgrade do notebook semanal ou mensal.
      3. No campo Dia da semana, escolha o dia da semana.
      4. No campo Hora, escolha uma hora do dia.
      5. Em Integridade e relatórios do sistema, marque ou desmarque as seguintes caixas de seleção:

        • Ativar relatório de integridade do sistema
        • Relatar métricas personalizadas para o Cloud Monitoring
        • Instalar agente do Cloud Monitoring
  2. Clique em Criar.

  3. O Vertex AI Workbench cria uma nova instância de notebooks gerenciados pelo usuário com base nas propriedades especificadas. Quando a instância estiver pronta para uso, o Vertex AI Workbench ativa um link Abrir JupyterLab.

Determinar quem tem acesso à instância do JupyterLab

A menos que você tenha concedido acesso a uma conta de serviço específica ou a um único usuário na página Criar um notebook gerenciado pelo usuário, Permissões, qualquer pessoa que tem permissões de editor no projeto do Google Cloud para acessar o notebook.

Se você concedeu acesso a uma conta de serviço específica, qualquer pessoa que tenha acesso a essa conta de serviço poderá acessar a instância do JupyterLab. Quem não tem acesso à conta de serviço especificada não pode acessar a instância do JupyterLab.

Se você concedeu acesso a um único usuário, somente ele poderá acessar a instância do JupyterLab. Se não for esse usuário, não será possível acessar a instância do JupyterLab por conta própria.

Abrir o notebook

Para abrir uma instância de notebooks gerenciado pelo usuário, conclua estas etapas:
  1. No Console do Google Cloud, ao lado do nome da instância de notebooks gerenciados pelo usuário, clique em Abrir JupyterLab.

  2. Sua instância de notebooks gerenciados pelo usuário abre o JupyterLab.

Tags de rede

Sua nova instância de notebooks gerenciado pelo usuário tem automaticamente as tags de rede deeplearning-vm e notebook-instance atribuídas.

Essas tags permitem gerenciar o acesso à rede da sua instância e faz referência a elas nas regras de firewall da rede VPC. Para mais informações sobre tags de rede, consulte Como configurar tags de rede.

Para visualizar as tags de rede da nova instância de notebooks gerenciado pelo usuário, conclua as seguintes etapas:

  1. No menu de navegação do Console do Google Cloud, aponte para o Compute Engine e clique em Instâncias de VM.
  2. Clique no nome da nova instância de notebooks gerenciados pelo usuário
  3. Em Rede, encontre Tags de rede.

Opções de configuração de rede

Uma instância de notebooks gerenciada pelo usuário precisa acessar endpoints de serviço fora da rede VPC.

Você pode fornecer esse acesso de uma das seguintes maneiras:

Se você usa o VIP private.googleapis.com ou restricted.googleapis.com para fornecer acesso aos endpoints do serviço, adicione entradas DNS para cada um dos endpoints de serviço necessários:

  • notebooks.googleapis.com
  • *.notebooks.cloud.google.com
  • *.notebooks.googleusercontent.com

Solução de problemas

Se tiver problemas ao criar um notebook, consulte a Como solucionar problemas em notebooks para receber ajuda sobre problemas comuns.

A seguir