Ligue-se a um tempo de execução no Colab Enterprise

Esta página mostra como estabelecer ligação a um tempo de execução no Colab Enterprise.

Para executar código no seu bloco de notas, tem de estabelecer ligação a um tempo de execução. Um tempo de execução é um recurso de computação que executa o seu código.

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 Vertex AI, Dataform, and Compute Engine APIs.

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 APIs

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 Vertex AI, Dataform, and Compute Engine APIs.

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 APIs

Estabeleça ligação através de métodos diferentes

Esta página mostra como estabelecer ligação a um tempo de execução através dos seguintes métodos:

• Use o tempo de execução predefinido
• Associe a um tempo de execução existente
• Crie um tempo de execução

Use o tempo de execução predefinido

Esta secção descreve como estabelecer ligação ao tempo de execução predefinido.

Funções necessárias

Para receber as autorizações de que precisa para se ligar ao tempo de execução predefinido num bloco de notas do Colab Enterprise, peça ao seu administrador para lhe conceder a função de IAM Utilizador do Colab Enterprise (roles/aiplatform.colabEnterpriseUser) 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.

Uma ou mais das funções necessárias incluem a autorização dataform.repositories.list. Os utilizadores aos quais é concedida a autorização dataform.repositories.list ou a função Criador de código (roles/dataform.codeCreator) num projeto podem listar os nomes dos recursos de código nesse projeto através da API Dataform ou da interface de linha de comandos (CLI) do Dataform. Os não administradores que usam o BigQuery Studio só podem ver recursos de código que criaram ou que foram partilhados com eles.

Ligue-se ao tempo de execução predefinido

Quando executa código num bloco de notas pela primeira vez, o Colab Enterprise liga-se automaticamente ao tempo de execução predefinido, a menos que especifique um diferente.

Para associar ao tempo de execução predefinido sem executar código, faça o seguinte:

1. Na Google Cloud consola, aceda à página Os meus blocos de notas do Colab Enterprise.

   Aceda a Os meus notebooks

2. No menu Região, selecione a região que contém o seu bloco de notas.

3. Clique no bloco de notas que quer abrir. Se ainda não criou um bloco de notas, crie um bloco de notas.

4. No bloco de notas, clique em Associar.
   

5. Se esta for a primeira vez que se liga a um tempo de execução com as credenciais do utilizador final ativadas, é apresentada uma caixa de diálogo Iniciar sessão.

   O tempo de execução predefinido tem as credenciais do utilizador final ativadas por predefinição. Para usar um tempo de execução que não tenha acesso às suas credenciais de utilizador, crie um modelo de tempo de execução sem as credenciais do utilizador final ativadas.

   Para conceder ao Colab Enterprise acesso às suas credenciais de utilizador, conclua os seguintes passos:

   1. Na caixa de diálogo Iniciar sessão, clique na sua conta de utilizador.

   2. Selecione Ver, editar, configurar e eliminar os seus Google Cloud dados... para conceder ao Colab Enterprise acesso às suas credenciais de utilizador.

      

   3. Clique em Continuar.

O Colab Enterprise liga-se ao tempo de execução predefinido. Se o tempo de execução predefinido não estiver em execução, o Colab Enterprise inicia o tempo de execução predefinido e, em seguida, estabelece ligação ao mesmo.

Efetue a associação a um tempo de execução existente

Esta secção descreve como estabelecer ligação a um tempo de execução existente através da caixa de diálogo Estabelecer ligação ao tempo de execução do Vertex AI.

Funções necessárias

Para receber as autorizações de que precisa para se ligar a um tempo de execução existente num bloco de notas do Colab Enterprise, peça ao seu administrador para lhe conceder a função de IAM Utilizador do Colab Enterprise (roles/aiplatform.colabEnterpriseUser) 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.

Uma ou mais das funções necessárias incluem a autorização dataform.repositories.list. Os utilizadores aos quais é concedida a autorização dataform.repositories.list ou a função Criador de código (roles/dataform.codeCreator) num projeto podem listar os nomes dos recursos de código nesse projeto através da API Dataform ou da interface de linha de comandos (CLI) do Dataform. Os não administradores que usam o BigQuery Studio só podem ver recursos de código que criaram ou que foram partilhados com eles.

Ligue-se ao tempo de execução existente

Para estabelecer ligação a um tempo de execução existente:

1. Na Google Cloud consola, aceda à página Os meus blocos de notas do Colab Enterprise.

   Aceda a Os meus notebooks

2. No menu Região, selecione a região que contém o seu bloco de notas.

3. Clique no bloco de notas que quer abrir. Se ainda não criou um bloco de notas, crie um bloco de notas.

4. No bloco de notas, clique na seta do expansor Opções de ligação adicionais e, de seguida, selecione Ligar a um tempo de execução.
   

   É apresentada a caixa de diálogo Ligar ao tempo de execução do Vertex AI.

5. Para Selecionar um tempo de execução, selecione Ligar a um tempo de execução existente.

6. Para Selecionar uma opção de tempo de execução existente, selecione o tempo de execução ao qual quer estabelecer ligação. Se não existirem tempos de execução na lista, crie um tempo de execução ou ligue-se ao tempo de execução predefinido.

7. Clique em Ligar.

8. Se o seu tempo de execução tiver credenciais de utilizador final ativadas e esta for a primeira vez que se liga a um tempo de execução com credenciais de utilizador final ativadas, é apresentado um diálogo Iniciar sessão.

   Para usar um tempo de execução que não tenha acesso às suas credenciais de utilizador, crie um modelo de tempo de execução sem as credenciais do utilizador final ativadas.

   Para conceder ao Colab Enterprise acesso às suas credenciais de utilizador, conclua os seguintes passos:

   1. Na caixa de diálogo Iniciar sessão, clique na sua conta de utilizador.

   2. Selecione Ver, editar, configurar e eliminar os seus Google Cloud dados... para conceder ao Colab Enterprise acesso às suas credenciais de utilizador.

      

   3. Clique em Continuar.

O Colab Enterprise estabelece ligação ao tempo de execução. Se o tempo de execução não estiver em execução, o Colab Enterprise inicia o tempo de execução e, em seguida, estabelece ligação ao mesmo.

Crie um tempo de execução

Esta secção descreve como criar um tempo de execução e estabelecer ligação ao mesmo através da caixa de diálogo Estabelecer ligação ao tempo de execução do Vertex AI. Em alternativa, pode criar um tempo de execução a partir do separador Tempos de execução.

Funções necessárias

Para receber as autorizações de que precisa para criar um tempo de execução no Colab Enterprise, peça ao seu administrador para lhe conceder a função do IAM de administrador do Colab Enterprise (roles/aiplatform.colabEnterpriseAdmin) 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.

Uma ou mais das funções necessárias incluem a autorização dataform.repositories.list. Os utilizadores aos quais é concedida a autorização dataform.repositories.list ou a função Criador de código (roles/dataform.codeCreator) num projeto podem listar os nomes dos recursos de código nesse projeto através da API Dataform ou da interface de linha de comandos (CLI) do Dataform. Os não administradores que usam o BigQuery Studio só podem ver recursos de código que criaram ou que foram partilhados com eles.

Crie um tempo de execução e estabeleça ligação ao mesmo

Para criar um tempo de execução e estabelecer ligação ao mesmo através da caixa de diálogo Estabelecer ligação ao tempo de execução do Vertex AI:

1. Na Google Cloud consola, aceda à página Os meus blocos de notas do Colab Enterprise.

   Aceda a Os meus notebooks

2. No menu Região, selecione a região que contém o seu bloco de notas.

3. Clique no bloco de notas que quer abrir. Se ainda não criou um bloco de notas, crie um bloco de notas.

4. No bloco de notas, clique na seta do expansor Opções de ligação adicionais e, de seguida, selecione Ligar a um tempo de execução.
   

   É apresentada a caixa de diálogo Ligar ao tempo de execução do Vertex AI.

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

6. No menu Modelo de tempo de execução, selecione um modelo de tempo de execução. Se não forem apresentados modelos de tempo de execução, crie um modelo de tempo de execução.

7. No campo Nome de tempo de execução, introduza um nome para o tempo de execução.

8. Clique em Ligar.

9. Se o modelo de tempo de execução que selecionou tiver credenciais do utilizador final ativadas, e esta for a primeira vez que se liga a um tempo de execução com credenciais do utilizador final ativadas, é apresentada uma caixa de diálogo Iniciar sessão.

   Para usar um tempo de execução que não tenha acesso às suas credenciais de utilizador, crie um modelo de tempo de execução sem as credenciais do utilizador final ativadas.

   Para conceder ao Colab Enterprise acesso às suas credenciais de utilizador, conclua os seguintes passos:

   1. Na caixa de diálogo Iniciar sessão, clique na sua conta de utilizador.

   2. Selecione Ver, editar, configurar e eliminar os seus Google Cloud dados... para conceder ao Colab Enterprise acesso às suas credenciais de utilizador.

      

   3. Clique em Continuar.

O Colab Enterprise inicia o tempo de execução predefinido e, em seguida, estabelece ligação ao mesmo.

Gestão do tempo de execução

Por predefinição, quando cria um tempo de execução, tem automaticamente as autorizações necessárias para eliminar (aiplatform.googleapis.com/notebookRuntimes.delete) e iniciar (aiplatform.googleapis.com/notebookRuntimes.start) esse tempo de execução.

Para saber como gerir o tempo de execução, incluindo como eliminar, iniciar ou desligar do tempo de execução, consulte Gerir tempos de execução.

Resolver problemas

Esta secção mostra-lhe como resolver problemas de ligação a tempos de execução no Colab Enterprise.

Não é possível ligar a um tempo de execução

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

O navegador bloqueia cookies de terceiros

O navegador que está a usar está a bloquear um cookie de terceiros que o Colab Enterprise usa para estabelecer uma ligação HTTPS com o tempo de execução.

Para resolver este problema, configure as definições do navegador para permitir o DATALAB_TUNNEL_TOKEN cookie de terceiros do domínio *.aiplatform-notebook.googleusercontent.com.

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

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

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

O que se segue?

• Saiba mais acerca dos tempos de execução e dos modelos de tempo de execução.
• Crie um modelo de tempo de execução.
• Para encontrar um bloco de notas que possa ajudar a iniciar o seu projeto rapidamente, consulte a galeria de blocos de notas.