Conectar-se a um ambiente de execução

Conectar-se a um ambiente de execução

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

Gerenciamento do ambiente de execução

Por padrão, quando você cria um ambiente de execução, recebe automaticamente as permissões necessárias para excluir (aiplatform.googleapis.com/notebookRuntimes.delete) e iniciar (aiplatform.googleapis.com/notebookRuntimes.start) esse ambiente.

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. Consulte também Não é possível se conectar a um ambiente de execução padrão. 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.

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

O erro a seguir ocorre quando você tenta se conectar a um ambiente de execução padrão quando não há um modelo de ambiente de execução padrão.

Failed to connect to runtime

Quando você se conecta a um ambiente de execução padrão que ainda não foi criado, o Colab Enterprise primeiro cria um modelo de ambiente de execução padrão e, em seguida, usa esse modelo para gerar o ambiente de execução padrão. No entanto, se você não tiver as permissões necessárias para criar um modelo de ambiente de execução, o Colab Enterprise não poderá criar o modelo de ambiente de execução padrão nem o ambiente de execução padrão.

Para resolver esse problema, peça ao administrador para conceder a você um papel que inclua a permissão aiplatform.notebookRuntimeTemplates.create.

O notebook demora para se conectar ao ambiente de execução

Alguns minutos após iniciar uma conexão com um ambiente de execução, a mensagem Connecting ainda está no canto superior direito do notebook, e o Colab Enterprise ainda não se conectou ao ambiente de execução.

Para resolver esse problema, aguarde mais alguns minutos. O Colab Enterprise ainda está se conectando a um ambiente de execução. A conexão com um ambiente de execução que ainda não está em execução pode levar alguns minutos porque o Vertex AI está alocando uma nova instância de máquina virtual (VM).

Não foi possível criar um ambiente de execução

Esse problema ocorre quando não é possível criar um ambiente de execução. Consulte também Não é possível criar um ambiente de execução padrão. As causas mais comuns são:

Recursos indisponíveis

O seguinte erro ocorre quando você 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.

Esse erro ocorrerá se não houver recursos disponíveis para a configuração do tipo de máquina na região do seu notebook.

Para resolver esse problema, teste um ambiente de execução com uma configuração de tipo de máquina diferente ou tente novamente mais tarde.

O ambiente de execução padrão já existe

O erro a seguir ocorre quando você tenta criar um ambiente de execução usando o modelo padrão quando o ambiente de execução padrão já existe.

Failed to create runtime

One click runtime already exists.

Se você tentar criar um ambiente de execução usando um modelo padrão, o Colab Enterprise vai tentar criar um ambiente de execução padrão. Só pode haver um ambiente de execução padrão por usuário, projeto e região. Se o ambiente de execução padrão já existir, o Colab Enterprise não vai conseguir criar outro ambiente de execução padrão.

Para resolver esse problema, conecte-se ao ambiente de execução padrão atual ou crie um ambiente de execução usando um modelo de ambiente de execução não padrão.

Não foi possível criar um ambiente de execução padrão

Quando o Colab Enterprise cria um ambiente de execução padrão, ele primeiro cria um modelo de ambiente de execução padrão que usa para gerar o ambiente de execução padrão. Se você tentar criar um ambiente de execução padrão sem as permissões necessárias, o Colab Enterprise não poderá criar o ambiente de execução padrão.

Para resolver esse problema, peça ao administrador para conceder a você um papel que inclua a permissão aiplatform.notebookRuntimeTemplates.create.

A seguir

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