Crie uma instância de blocos de notas geridos através da Google Cloud consola

Crie uma instância de blocos de notas geridos através da Google Cloud consola

Os blocos de notas geridos do Vertex AI Workbench foram descontinuados. A 14 de abril de 2025, o apoio técnico dos blocos de notas geridos terminou e a capacidade de criar instâncias de blocos de notas geridos foi removida. As instâncias existentes vão continuar a funcionar até 30 de março de 2026, mas os patches, as atualizações e as atualizações não vão estar disponíveis. Para continuar a usar o Vertex AI Workbench, recomendamos que migre as suas instâncias de notebooks geridos para instâncias do Vertex AI Workbench.

Saiba como criar uma instância de notebooks geridos do Vertex AI Workbench e abrir o JupyterLab através da Google Cloud consola. Esta página também descreve como parar, iniciar, repor ou eliminar uma instância de notebooks geridos.

---

Para seguir orientações passo a passo para esta tarefa diretamente na Google Cloud consola, clique em Orientar-me:

Visita guiada

---

Antes de começar

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.

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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

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

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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

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

Crie uma instância

1. Na Google Cloud consola, aceda à página Blocos de notas geridos.

   Aceda a notebooks geridos

2. Clique em  Criar novo.

3. Na janela Criar instância, no campo Nome, introduza my-instance.

4. Clique em Criar.

Quando terminar as tarefas descritas neste documento, pode evitar a faturação contínua eliminando os recursos que criou. Para mais informações, consulte o artigo Limpe.

Abra o JupyterLab

Depois de criar a instância, o Vertex AI Workbench inicia-a automaticamente. Quando a instância estiver pronta para utilização, o Vertex AI Workbench ativa um link Abrir JupyterLab.

1. Junto ao nome da instância de blocos de notas geridos, clique em Abrir JupyterLab.

2. Na caixa de diálogo Autentique o seu bloco de notas gerido, clique no botão para receber um código de autenticação.

3. Escolha uma conta e clique em Permitir. Copie o código de autenticação.

4. Na caixa de diálogo Autentique o seu bloco de notas gerido, cole o código de autenticação e, de seguida, clique em Autenticar.

   A sua instância de blocos de notas geridos abre o JupyterLab.

Abra um novo ficheiro de bloco de notas

1. Selecione Ficheiro > Novo > Bloco de notas.

2. Na caixa de diálogo Selecionar kernel, selecione Python e, de seguida, clique em Selecionar.

   O novo ficheiro do bloco de notas é aberto.

Altere o kernel

Pode alterar o kernel do ficheiro do bloco de notas do JupyterLab no menu ou no ficheiro.

Menu

1. No JupyterLab, no menu Kernel, clique em Alterar kernel.

2. Na caixa de diálogo Selecionar kernel, selecione outro kernel para usar.

3. Clique em Selecionar.

No ficheiro

1. No ficheiro do bloco de notas do JupyterLab, clique no nome do kernel.

   

2. Na caixa de diálogo Selecionar kernel, selecione outro kernel para usar.

3. Clique em Selecionar.

Pare a instância

1. Na Google Cloud consola, aceda à página Blocos de notas geridos.

   Aceda a notebooks geridos

2. Selecione a instância que quer parar.

3. Clique em  Parar.

Inicie a instância

1. Na Google Cloud consola, aceda à página Blocos de notas geridos.

   Aceda a notebooks geridos

2. Selecione a instância que quer iniciar.

3. Clique em  Iniciar.

Reponha a instância

A reposição de uma instância limpa à força o conteúdo da memória da instância e repõe a instância no respetivo estado inicial. Para saber como funciona a reposição de uma instância, consulte o artigo Operação de reposição.

1. Na Google Cloud consola, aceda à página Blocos de notas geridos.

   Aceda a notebooks geridos

2. Selecione a instância que quer repor.

3. Clique em Repor e, de seguida, em Repor para confirmar.

Limpar

Para evitar incorrer em cobranças na sua Google Cloud conta pelos recursos usados nesta página, siga estes passos.

Se criou um novo projeto para saber mais sobre os Managed Notebooks do Vertex AI Workbench e já não precisa do projeto, então elimine o projeto.

Se usou um Google Cloud projeto existente, elimine os recursos que criou para evitar incorrer em custos na sua conta:

1. Na Google Cloud consola, aceda à página Blocos de notas geridos.

   Aceda a notebooks geridos

2. Selecione a linha que contém a instância que quer eliminar.

3. Clique em  Eliminar. (Consoante o tamanho da janela, o botão Eliminar pode estar no menu de opções .)

4. Para confirmar, clique em Eliminar.

O que se segue?

• Experimente um dos tutoriais incluídos na nova instância de blocos de notas geridos. No  explorador de ficheiros do JupyterLab, abra a pasta tutorials e, de seguida, abra um dos ficheiros de bloco de notas.

  

• Leia a Introdução aos blocos de notas geridos.

• Para saber mais sobre as definições avançadas das instâncias de blocos de notas geridos, consulte o artigo Crie uma instância de blocos de notas geridos.