Criar um bloco do Colab Enterprise usando o console do Google Cloud

Criar um bloco do Colab Enterprise usando o console do Google Cloud

Saiba como criar um bloco do Colab Enterprise e executar o código dele em um ambiente de execução padrão usando o console do Google Cloud. Nesta página, também descrevemos como renomear, excluir e fazer upload de um notebook.

Antes de começar

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.

   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

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Vertex AI, Dataform, and Compute Engine APIs.

   Enable the APIs

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

   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

6. Make sure that billing is enabled for your Google Cloud project.

7. Enable the Vertex AI, Dataform, and Compute Engine APIs.

   Enable the APIs

Funções exigidas

Para garantir que sua conta de usuário tenha as permissões necessárias para criar um bloco do Colab Enterprise e executar o código do notebook em um ambiente de execução, peça ao administrador para conceder à sua conta de usuário o papel de usuário do IAM do Colab Enterprise (roles/aiplatform.colabEnterpriseUser) 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.

Um ou mais dos papéis necessários incluem a permissão dataform.repositories.list. Os usuários que recebem a permissão dataform.repositories.list ou o papel de criador de código (roles/dataform.codeCreator) em um projeto podem listar os nomes dos recursos de código nesse projeto usando a API Dataform ou a interface de linha de comando (CLI) do Dataform. Os não administradores que usam o BigQuery Studio só podem ver os recursos de código que criaram ou que foram compartilhados com eles.

Criar um notebook

Para criar um bloco do Colab Enterprise usando o console do Google Cloud:

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

   Acesse o Notebooks

2. No menu Região, selecione a região em que você quer criar o notebook.

3. Ao lado de Arquivos, clique em  Criar um notebook.

   O novo notebook aparece na guia Meus notebooks.

Ao concluir as tarefas descritas neste documento, é possível evitar o faturamento contínuo excluindo os recursos criados. Saiba mais em Limpeza.

Executar código em um ambiente de execução padrão

Para executar o código de um bloco do Colab Enterprise no ambiente de execução padrão, faça o seguinte:

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

   Acesse o Notebooks

2. No menu Região, selecione a região que contém o notebook.

3. Na guia Meus notebooks, clique no notebook que você quer abrir.

4. Mantenha o ponteiro do mouse sobre a célula de código que você quer executar e depois clique no botão  Executar célula.

5. Se esta for a primeira vez que você se conecta a um ambiente de execução com credenciais de usuário final ativadas, uma caixa de diálogo Fazer login vai aparecer.

   O ambiente de execução padrão tem credenciais de usuário final ativadas para facilitar a execução de códigos que interagem com o Google Cloud.

   Para conceder ao Colab Enterprise acesso às suas credenciais de usuário, conclua as seguintes etapas:

   1. Na caixa de diálogo Fazer login, clique na sua conta de usuário.

   2. Selecione Ver, editar, configurar e excluir seus dados do Google Cloud... para conceder ao Colab Enterprise acesso às suas credenciais de usuário.

      

   3. Clique em Continuar.

Após o início do ambiente de execução, o Colab Enterprise se conecta a ele e executa o código na célula.

Renomear o notebook

Para renomear um bloco do Colab Enterprise:

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

   Acesse o Notebooks

2. No menu Região, selecione a região que contém o notebook.

3. Ao lado do notebook que você quer renomear, clique no menu Ações e depois em Renomear.

4. Na caixa de diálogo Renomear notebook, altere o nome do notebook e clique em Renomear.

Fazer upload de um notebook

Para fazer upload de um notebook para o Colab Enterprise:

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

   Acesse o Notebooks

2. No menu Região, selecione a região em que você quer fazer upload do notebook.

3. Ao lado de Arquivos, clique em  Fazer upload do arquivo do notebook.

4. Na caixa de diálogo Fazer upload do notebook, no campo Selecionar notebook, clique em Procurar e selecione o notebook para upload.

   O notebook precisa ter menos de 20 MB.

5. Opcional: no campo Nome do notebook, edite o nome do arquivo do notebook.

6. Clique em Fazer upload.

   O notebook aparecerá na guia Meus notebooks.

Limpeza

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

Para evitar cobranças na sua conta do Google Cloud pelos recursos usados neste tutorial, exclua o projeto que os contém ou mantenha o projeto e exclua os recursos individuais.

Excluir o projeto

Cuidado: excluir um projeto tem os seguintes efeitos:

• Tudo no projeto é excluído. Se você tiver usado um projeto existente para as tarefas neste documento, a exclusão dele incluirá a exclusão de quaisquer outros trabalhos feitos no projeto.
• Os IDs do projeto personalizados são perdidos. Ao criar o projeto, você pode ter criado um código do projeto personalizado para ser usado no futuro. Para preservar os URLs que usam o ID do projeto, como um URL appspot.com, exclua recursos específicos do projeto, em vez de excluir o projeto inteiro.

Se você planeja passar por várias arquiteturas, tutoriais ou guias de início rápido, a reutilização de projetos pode evitar que você exceda os limites da cota do projeto.

1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

Excluir o notebook

To delete a Colab Enterprise notebook:

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

   Acesse o Notebooks

2. Ao lado do notebook que você quer excluir, clique no menu Ações e depois em Excluir.

3. Na caixa de diálogo Excluir, clique em Confirmar.

A seguir

• Leia a Introdução ao Colab Enterprise.

• Conecte-se a um ambiente de execução.