Crie uma versão específica de uma instância de notebooks geridos pelo utilizador

Esta página descreve como pode criar uma instância de notebooks gerida pelo utilizador com base numa versão específica das imagens de VMs de aprendizagem profunda.

Porque é que pode querer criar uma versão específica

Para garantir que a instância de blocos de notas gerida pelo utilizador tem software compatível com o seu código ou aplicação, é recomendável criar uma versão específica.

As instâncias de blocos de notas geridas pelo utilizador são criadas através de imagens de VMs de aprendizagem profunda. As imagens da VM de aprendizagem avançada são atualizadas com frequência, e as versões específicas do software e dos pacotes pré-instalados variam de versão para versão.

Para saber mais sobre versões específicas da Deep Learning VM, consulte as notas de lançamento da Deep Learning VM.

Depois de criar uma versão específica de uma instância de blocos de notas geridos pelo utilizador, pode atualizá-la. A atualização da instância atualiza o software e os pacotes pré-instalados. Para mais informações, consulte o artigo Atualize o ambiente de uma instância de blocos de notas gerida pelo utilizador.

Antes de começar

Antes de poder criar uma instância de notebooks gerida pelo utilizador, tem de ter um Google Cloud projeto 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.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Notebooks API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

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

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the Notebooks API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

    8.

  8. Se planeia usar GPUs com a instância de blocos de notas geridos pelo utilizador, consulte a página de quotas na Google Cloud consola para garantir que tem GPUs suficientes disponíveis no seu projeto. Se as GPUs não forem apresentadas na página de quotas ou precisar de uma quota de GPUs adicional, pode pedir um aumento da quota. Consulte o artigo Pedir um aumento da quota na página Quotas de recursos do Compute Engine.

    9. Funções necessárias

    Se criou o projeto, tem a função de IAM de proprietário (roles/owner) no projeto, que inclui todas as autorizações necessárias. Ignore esta secção e comece a criar a sua instância de blocos de notas geridos pelo utilizador. Se não criou o projeto, continue nesta secção.

    Para receber as autorizações de que precisa para criar uma instância do Vertex AI Workbench User Managed Notebooks, peça ao seu administrador para lhe conceder as seguintes funções de IAM no projeto:

    Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

    Também pode conseguir as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

    Encontre a versão específica que quer

    Para criar uma instância de notebooks geridos pelo utilizador com base numa versão específica da VM de aprendizagem profunda, tem de saber o nome da imagem da versão específica da VM de aprendizagem profunda que quer usar.

    Cada lançamento da VM de aprendizagem profunda inclui atualizações de muitas imagens diferentes, e cada imagem no lançamento tem o seu próprio nome de imagem.

    Para encontrar o nome da imagem específico que quer:

    1. Encontre o número de versão da Deep Learning VM para o qual quer obter os nomes das imagens. Os números de lançamento estão incluídos nas notas de lançamento da VM de aprendizagem avançada. Os números de lançamento têm o formato M seguido do número do lançamento, por exemplo, M79.

    2. Para listar os nomes das imagens de uma versão específica da VM de aprendizagem profunda, 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 da Deep Learning VM, como M79.

    3. Encontre o nome da imagem que quer usar.

    Crie uma versão específica a partir da linha de comandos

    Para criar uma versão específica de uma instância de notebooks geridos pelo utilizador a partir da linha de comandos, conclua os seguintes passos:

    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 o seguinte:

      • INSTANCE_NAME: o nome da nova instância
      • VM_IMAGE_NAME: o nome da imagem que quer usar para criar a sua instância
      • MACHINE_TYPE: o tipo de máquina da VM da sua instância
      • LOCATION: a Google Cloud localização onde quer que a nova instância esteja

    2. Aceda à sua instância a partir da Google Cloud consola.

    O que se segue?