Ligue-se a um tempo de execução

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

1. 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.

   Go to project selector

2. Verify that billing is enabled for your Google Cloud project.

3. 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.

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 tempo de execução 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.

   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.

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 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.

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 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.

Mude para um tempo de execução predefinido com GPUs

Se o seu administrador tiver ativado tempos de execução predefinidos com GPU ou se a sua conta de utilizador tiver a autorização aiplatform.notebookRuntimeTemplates.create, pode mudar para um tempo de execução com GPUs depois de se ligar ao tempo de execução predefinido.

No bloco de notas, clique em Mudar para GPU.

Para saber como ativar os tempos de execução predefinidos com GPUs, consulte o artigo Ative os tempos de execução predefinidos com GPUs.

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. Veja também Não é possível ligar a um tempo de execução predefinido. 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.

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

O seguinte erro ocorre quando tenta estabelecer ligação a um tempo de execução predefinido quando não existe um modelo de tempo de execução predefinido.

Failed to connect to runtime

Quando se liga a um tempo de execução predefinido que ainda não foi criado, o Colab Enterprise cria primeiro um modelo de tempo de execução predefinido, e, em seguida, usa esse modelo de tempo de execução predefinido para gerar o tempo de execução predefinido. No entanto, se não tiver as autorizações necessárias para criar um modelo de tempo de execução, o Colab Enterprise não pode criar o modelo de tempo de execução predefinido nem o tempo de execução predefinido.

Para resolver este problema, peça ao administrador para lhe conceder uma função que inclua a autorização aiplatform.notebookRuntimeTemplates.create.

O notebook demora a ligar-se ao tempo de execução

Alguns minutos após iniciar uma ligação a um tempo de execução, a mensagem Connecting continua no canto superior direito do bloco de notas e o Colab Enterprise ainda não se ligou ao tempo de execução.

Para resolver este problema, aguarde mais alguns minutos. O Colab Enterprise continua a estabelecer ligação a um tempo de execução. A ligação a um tempo de execução que ainda não esteja em execução pode demorar alguns minutos, uma vez que o Vertex AI está a atribuir uma nova instância de máquina virtual (VM).

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

Este problema ocorre quando não consegue criar um tempo de execução. Veja também Não é possível criar um tempo de execução predefinido. As causas mais comuns são:

Recursos indisponíveis

O seguinte erro ocorre quando tenta criar um tempo de execução.

No available zone found for runtime RUNTIME_ID
for machine type MACHINE_TYPE
with accelerator type: ACCELERATOR. Please try again later.

Este erro ocorre se não existirem recursos disponíveis para a configuração do tipo de máquina na região do seu bloco de notas.

Para resolver este problema, experimente qualquer uma das seguintes opções:

• Crie um tempo de execução numa região diferente.
• Crie um modelo de tempo de execução com uma configuração de tipo de máquina diferente e, em seguida, crie um tempo de execução com base no novo modelo de tempo de execução.

O tempo de execução predefinido já existe

O seguinte erro ocorre quando tenta criar um tempo de execução a partir do modelo de tempo de execução predefinido quando o tempo de execução predefinido já existe.

Failed to create runtime

One click runtime already exists.

Se tentar criar um tempo de execução a partir de um modelo de tempo de execução predefinido, o Colab Enterprise tenta criar um tempo de execução predefinido. Só pode existir um tempo de execução predefinido por utilizador, projeto e região. Se o tempo de execução predefinido já existir, o Colab Enterprise não consegue criar outro tempo de execução predefinido.

Para resolver este problema, ligue-se ao tempo de execução predefinido existente ou crie um tempo de execução a partir de um modelo de tempo de execução não predefinido.

Não é possível criar um tempo de execução predefinido

Quando o Colab Enterprise cria um tempo de execução predefinido, cria primeiro um modelo de tempo de execução predefinido que usa para gerar o tempo de execução predefinido. Se tentar criar um tempo de execução predefinido sem as autorizações necessárias para criar um modelo de tempo de execução, o Colab Enterprise não consegue criar o tempo de execução predefinido.

Para resolver este problema, peça ao administrador para lhe conceder uma função que inclua a autorização aiplatform.notebookRuntimeTemplates.create.

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.