Criar uma versão específica de uma instância de notebooks gerenciados pelo usuário

Nesta página, você verá como criar uma instância de notebooks gerenciados pelo usuário com base em uma versão específica de imagens de VM de aprendizado profundo.

Por que criar uma versão específica

Para garantir que a instância de notebooks gerenciada pelo usuário tenha um software compatível com seu código ou aplicativo, convém criar uma versão específica.

As instâncias de notebooks gerenciados pelo usuário são criadas com imagens da VM de aprendizado profundo. As imagens da VM de aprendizado profundo são atualizadas com frequência, e as versões específicas de software e pacotes pré-instalados variam de acordo com a versão.

Para saber mais sobre versões específicas da VM de aprendizado profundo, consulte as Notas de lançamento da VM de aprendizado profundo.

Depois de criar uma versão específica de uma instância de notebooks gerenciados pelo usuário, é possível fazer upgrade dela. O upgrade da instância atualiza o software e os pacotes pré-instalados. Para mais informações, consulte Fazer upgrade de um ambiente de instância de notebooks gerenciados pelo usuário.

Antes de começar

Antes de criar uma instância de notebooks gerenciados pelo usuário, é necessário ter um projeto do Google Cloud e ativar a API Notebooks para esse projeto.
  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

  4. Enable the Notebooks API.

    Enable the API

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  6. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

  7. Enable the Notebooks API.

    Enable the API

  8. Se você planeja usar GPUs com a instância de notebooks gerenciada pelo usuário, consulte a página de cotas no Console do Google Cloud para garantir que há GPUs suficientes disponíveis no seu projeto. Se as GPUs não estiverem listadas nessa página ou se você precisar de mais cotas, solicite um aumento de cota. Consulte Como solicitar um aumento na cota na página Cotas de recursos do Compute Engine.

Funções exigidas

Caso tenha criado o projeto, você terá o papel do IAM de Proprietário (roles/owner) no projeto, que inclui todas as permissões necessárias. Pule esta seção e comece a criar sua instância de notebooks gerenciados pelo usuário. Se você não criou o projeto, continue nesta seção.

Para garantir que sua conta de usuário tenha as permissões necessárias para criar uma instância de notebooks gerenciados pelo usuário do Vertex AI Workbench, peça ao administrador para conceder à sua conta de usuário os seguintes papéis do IAM no projeto:

Para mais informações sobre como conceder papéis, consulte Gerenciar acesso.

O administrador também pode conceder à sua conta de usuário as permissões necessárias via papéis personalizados ou outros papéis predefinidos.

Encontrar a versão específica que você quer

Para criar uma instância de notebooks gerenciados pelo usuário com base em uma determinada versão da VM de aprendizado profundo, é preciso saber o nome da imagem da versão específica da VM de aprendizado profundo que você quer usar.

Cada versão da VM de aprendizado profundo inclui atualizações para muitas imagens diferentes, e cada imagem na versão tem seu próprio nome de imagem.

Para encontrar o nome da imagem específica que você quer:

  1. Encontre o número da versão da VM de aprendizado profundo para receber os nomes das imagens. Os números de lançamento estão incluídos nas notas de lançamento da VM de aprendizado profundo. Os números de versão estão na forma de um M seguido pelo número da versão, por exemplo, M79.

  2. Para listar os nomes das imagens de uma versão específica da VM de aprendizado profundo, execute o seguinte comando.

    gcloud compute images list --project="deeplearning-platform-release" \
        --format="value(name)" \
        --filter="labels.release=RELEASE_NUMBER" \
        --show-deprecated
    

    Substitua RELEASE_NUMBER por um número de versão de VM de aprendizado profundo, como M79.

  3. Encontre o nome da imagem que você quer usar.

Criar uma versão específica da linha de comando

Para criar uma versão específica de uma instância de notebooks gerenciados pelo usuário na linha de comando, conclua as etapas a seguir:

  1. Execute o seguinte comando gcloud notebooks:

    gcloud notebooks instances create INSTANCE_NAME \
        --vm-image-project="deeplearning-platform-release" \
        --vm-image-name=VM_IMAGE_NAME \
        --machine-type=MACHINE_TYPE \
        --location=LOCATION
    

    Substitua:

    • INSTANCE_NAME: o nome da nova instância.
    • VM_IMAGE_NAME: o nome da imagem 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 sua instância no Console do Google Cloud.

A seguir