Conectar-se a um ambiente de execução no Colab Enterprise

Nesta página, mostramos como se conectar a um ambiente de execução no Colab Enterprise.

Para executar o código no seu notebook, você precisa se conectar a um ambiente de execução. Um tempo de execução é um recurso de computação que executa o código.

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

Conectar usando métodos diferentes

Nesta página, mostramos como se conectar a um ambiente de execução usando os seguintes métodos:

• Usar o ambiente de execução padrão
• Conecte-se a um ambiente de execução
• Criar um ambiente de execução

Usar o ambiente de execução padrão

Nesta seção, descrevemos como se conectar ao ambiente de execução padrão.

Funções exigidas

Para garantir que sua conta de usuário tenha as permissões necessárias para se conectar ao ambiente de execução padrão em um bloco do Colab Enterprise, peça ao administrador para conceder à sua conta de usuário o papel de usuário do Colab Enterprise (roles/aiplatform.colabEnterpriseUser) do IAM no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

O administrador também pode conceder à sua conta de usuário as permissões necessárias via funções personalizadas 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.

Conectar ao ambiente de execução padrão

Quando você executa o código em um notebook pela primeira vez, o Colab Enterprise se conecta automaticamente ao ambiente de execução padrão, a menos que você especifique um diferente.

Para se conectar ao ambiente de execução padrão sem executar o código, 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. Crie um notebook se ainda não tiver feito isso.

4. No seu notebook, clique em Connect.
   

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 por padrão. Para usar um ambiente de execução que não tenha acesso às credenciais do usuário, crie um modelo de ambiente de execução sem ativar as credenciais de usuário final.

   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.

O Colab Enterprise se conecta ao ambiente de execução padrão. Se o ambiente de execução padrão não estiver em execução, o Colab Enterprise iniciará o ambiente de execução padrão e se conectará a ele.

Conecte-se a um ambiente de execução

Nesta seção, descrevemos como se conectar a um ambiente de execução atual usando a caixa de diálogo Conectar ao ambiente de execução da Vertex AI.

Funções exigidas

Para garantir que sua conta de usuário tenha as permissões necessárias para se conectar a um ambiente de execução atual em um bloco do Colab Enterprise, peça ao administrador para conceder à sua conta de usuário o papel de usuário do Colab Enterprise (roles/aiplatform.colabEnterpriseUser) do IAM no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

O administrador também pode conceder à sua conta de usuário as permissões necessárias via funções personalizadas 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.

Conectar ao ambiente de execução atual

Para se conectar a um ambiente de execução atual:

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. Crie um notebook se ainda não tiver feito isso.

4. No seu notebook, clique na seta de expansão Opções de conexão adicionais e selecione Conectar a um ambiente de execução.
   

   A caixa de diálogo Conectar ao ambiente de execução da Vertex AI é aberta.

5. Em Selecionar um ambiente de execução, selecione Conectar a um ambiente de execução atual.

6. Em Selecionar uma opção de ambiente de execução existente, selecione o ambiente de execução ao qual você quer se conectar. Se não houver ambientes de execução na lista, crie um ambiente de execução ou conecte-se ao ambiente de execução padrão.

7. Clique em Conectar.

8. Se o ambiente de execução tiver credenciais de usuário final ativadas e esta for a primeira vez que você se conecta a um ambiente de execução com essas credenciais ativadas, uma caixa de diálogo Fazer login será exibida.

   Para usar um ambiente de execução sem acesso às credenciais do usuário, crie um modelo de ambiente de execução sem ativar as credenciais de usuário final.

   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.

O Colab Enterprise se conecta ao ambiente de execução. Se o ambiente de execução não estiver em execução, o Colab Enterprise iniciará e se conectará a ele.

Criar um ambiente de execução

Nesta seção, descrevemos como criar um ambiente de execução e se conectar a ele usando a caixa de diálogo Conectar ao ambiente de execução da Vertex AI. Como alternativa, é possível criar um ambiente de execução na guia Ambientes de execução.

Funções exigidas

Para garantir que sua conta de usuário tenha as permissões necessárias para criar um ambiente de execução no Colab Enterprise, peça para seu administrador conceder à sua conta de usuário o papel de Administrador do Colab Enterprise (roles/aiplatform.colabEnterpriseAdmin) do IAM no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

O administrador também pode conceder à sua conta de usuário as permissões necessárias via funções personalizadas 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 ambiente de execução e se conectar a ele

Para criar um ambiente de execução e se conectar a ele usando a caixa de diálogo Conectar ao ambiente de execução da Vertex AI:

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. Crie um notebook se ainda não tiver feito isso.

4. No seu notebook, clique na seta de expansão Opções de conexão adicionais e selecione Conectar a um ambiente de execução.
   

   A caixa de diálogo Conectar ao ambiente de execução da Vertex AI é aberta.

5. Em Selecionar um ambiente de execução, selecione Criar novo ambiente de execução.

6. No menu Modelo de execução, selecione um modelo de ambiente de execução. Se não houver modelos de ambiente de execução listados, crie um modelo de ambiente de execução.

7. No campo Nome do ambiente de execução, insira um nome para o ambiente de execução.

8. Clique em Conectar.

9. Se o modelo de ambiente de execução selecionado tiver credenciais de usuário final ativadas e esta for a primeira vez que você se conecta a um ambiente de execução com essas credenciais ativadas, uma caixa de diálogo Fazer login será exibida.

   Para usar um ambiente de execução sem acesso às credenciais do usuário, crie um modelo de ambiente de execução sem ativar as credenciais de usuário final.

   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.

O Colab Enterprise inicia o ambiente de execução padrão e se conecta a ele.

Resolver problemas

Nesta seção, mostramos como resolver problemas de conexão com ambientes de execução no Colab Enterprise.

Não é possível se conectar a um ambiente de execução

Esse problema ocorre por vários motivos. As causas mais comuns são:

O navegador bloqueia cookies de terceiros

O navegador que você está usando está bloqueando um cookie de terceiros que o Colab Enterprise usa para estabelecer uma conexão HTTPS com o ambiente de execução.

Para resolver esse problema, defina as configurações do seu navegador para permitir o cookie de terceiros DATALAB_TUNNEL_TOKEN do domínio *.aiplatform-notebook.googleusercontent.com.

A rede bloqueia o tráfego de saída para domínios de notebook

As regras de firewall da rede bloqueiam o tráfego de saída para *.aiplatform-notebook.cloud.google.com ou *aiplatform.googleapis.com.

Para resolver esse problema, configure as regras de firewall da rede para permitir o tráfego de saída para *.aiplatform-notebook.cloud.google.com e *aiplatform.googleapis.com.

A seguir

• Saiba mais sobre ambientes de execução e modelos de ambiente de execução.
• Crie um modelo de ambiente de execução.