Crie uma instância de notebooks gerenciados usando o console Google Cloud

Crie uma instância de notebooks gerenciados usando o console Google Cloud

Os notebooks gerenciados do Vertex AI Workbench foram descontinuados. Em 14 de abril de 2025, o suporte a notebooks gerenciados foi encerrado, e não é mais possível criar instâncias de notebooks gerenciados. As instâncias atuais vão continuar funcionando até 30 de março de 2026, mas patches, atualizações e upgrades não estarão disponíveis. Para continuar usando o Vertex AI Workbench, recomendamos que você migre suas instâncias de notebooks gerenciados para instâncias do Vertex AI Workbench.

Saiba como criar uma instância de notebooks gerenciados do Vertex AI Workbench e abrir o JupyterLab usando o console Google Cloud . Nesta página, também descrevemos como interromper, iniciar, redefinir ou excluir uma instância de notebooks gerenciados.

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

Criar uma instância

1. No console do Google Cloud , acesse a página Notebooks gerenciados.

   Acessar Notebooks gerenciados

2. Clique em  Criar novo.

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

4. Clique em Criar.

Ao concluir as tarefas descritas neste documento, é possível evitar o faturamento contínuo excluindo os recursos criados. Para mais informações, consulte Limpeza.

Abrir JupyterLab

Depois que você cria instância, o Vertex AI Workbench a inicia automaticamente. Quando a instância estiver pronta para uso, o Vertex AI Workbench ativa um link Abrir JupyterLab.

1. Ao lado do nome da instância de notebooks gerenciados, clique em Abrir JupyterLab.

2. Na caixa de diálogo Autenticar seu notebook gerenciado, 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 Autenticar seu notebook gerenciado, cole o código de autenticação e clique em Autenticar.

   Sua instância de notebooks gerenciados abre o JupyterLab.

Abrir um novo arquivo de notebook

1. Selecione File -> New -> Notebook.

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

   O novo arquivo do notebook será aberto.

Alterar o kernel

É possível alterar o kernel do arquivo do notebook do JupyterLab no menu ou no arquivo.

Menu

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

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

3. Clique em Selecionar.

No arquivo

1. No arquivo do notebook do JupyterLab, clique no nome do kernel.

   

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

3. Clique em Selecionar.

Interromper a instância

1. No console Google Cloud , acesse a página Notebooks gerenciados.

   Acessar Notebooks gerenciados

2. Selecione a instância que você quer interromper.

3. Clique Stop.

Iniciar a instância

1. No console Google Cloud , acesse a página Notebooks gerenciados.

   Acessar Notebooks gerenciados

2. Selecione a instância que você quer iniciar.

3. Clique Iniciar.

Redefinir a instância

A redefinição forçada de uma instância exclui permanentemente o conteúdo da memória dela e a redefine para o estado inicial. Para saber mais sobre como funciona a redefinição de uma instância, consulte Redefinir uma instância.

1. No console Google Cloud , acesse a página Notebooks gerenciados.

   Acessar Notebooks gerenciados

2. Selecione a instância que você quer redefinir.

3. Clique em Redefinir e, em seguida, clique em Redefinir para confirmar.

Limpar

Para evitar cobranças na conta do Google Cloud pelos recursos usados nesta página, siga as etapas abaixo.

Se você criou um projeto novo para aprender sobre os notebooks gerenciados do Vertex AI Workbench e não precisa mais dele, então exclua o projeto.

Se você tiver usado um Google Cloud projeto que já existe, exclua os recursos criados para evitar cobranças na sua conta:

1. No console Google Cloud , acesse a página Notebooks gerenciados.

   Acessar Notebooks gerenciados

2. Selecione a linha que contém a instância que você quer excluir.

3. Clique Excluir. Dependendo do tamanho da janela, o botão Excluir vai estar no menu "opções" ().

4. Para confirmar, clique em Excluir.

A seguir

• Teste um dos tutoriais incluídos na nova instância de notebooks gerenciados. No navegador de arquivos JupyterLab, navegador de arquivos, abra a pasta tutoriais e abra um dos arquivos de notebook.

  

• Leia a Introdução aos notebooks gerenciados.