Tempos de execução e modelos de tempo de execução

Esta página descreve os tempos de execução e os modelos de tempo de execução do Colab Enterprise.

Um tempo de execução é uma máquina virtual (VM) aprovisionada pela Google que pode executar o código no seu bloco de notas (ficheiro IPYNB).

Um modelo de tempo de execução é uma configuração de VM que especifica um tipo de máquina e outras características da VM, bem como definições comuns, como a rede e se o acesso público à Internet está ativado. Quando cria um tempo de execução, a respetiva VM é criada de acordo com as especificações de um modelo de tempo de execução.

Fluxo de trabalho

Pode criar um bloco de notas do Colab Enterprise e executar código no mesmo sem ter de compreender os tempos de execução. Quando executa o código pela primeira vez, o Colab Enterprise aprovisiona um tempo de execução predefinido e executa o código no mesmo. O Colab Enterprise continua a usar o tempo de execução predefinido até se ligar a um tempo de execução diferente.

Para configurar um tempo de execução para necessidades específicas, tem de:

  1. Crie um modelo de tempo de execução com a configuração de que precisa.

  2. Crie um tempo de execução com base nesse modelo.

  3. Ligue-se ao tempo de execução a partir do bloco de notas e execute o código.

Tempos de execução

Esta secção descreve as caraterísticas dos tempos de execução.

Tempo de execução predefinido

Se não criar um tempo de execução, é criado um tempo de execução sem aceleradores para si na primeira vez que executar código ou se ligar ao tempo de execução predefinido. Pode usar o tempo de execução predefinido sem aceleradores ou mudar para um tempo de execução predefinido que inclua aceleradores.

Quando o Colab Enterprise cria um tempo de execução predefinido, cria primeiro um modelo de tempo de execução predefinido correspondente. O tempo de execução e o modelo de tempo de execução aparecem na Google Cloud consola, onde pode obter informações sobre os mesmos.

Se usar tempos de execução predefinidos sem aceleradores, o Colab Enterprise cria um tempo de execução predefinido sem aceleradores e o respetivo modelo de tempo de execução, por projeto e por região.

Se usar tempos de execução predefinidos com aceleradores, o Colab Enterprise cria um tempo de execução predefinido com aceleradores e o respetivo modelo de tempo de execução correspondente, por projeto e por região.

Especificações de tempo de execução predefinidas

Os tempos de execução predefinidos e os respetivos modelos de tempo de execução predefinidos incluem as seguintes especificações:

Especificação Predefinição Predefinição com GPU
Versão do Python Mais recente disponível (atualmente, Python 3.11) Mais recente disponível (atualmente, Python 3.11)
Tipo de máquina e2-standard-4 Depende da disponibilidade regional. Consulte as Especificações.
Accelerator Nenhum Depende da disponibilidade regional. Consulte as Especificações.
Disco de arranque Disco persistente SSD de 100 GiB (pd-ssd) Disco persistente SSD de 100 GiB (pd-ssd)
Disco de dados Disco persistente padrão de 100 GiB (pd-standard) Depende da disponibilidade regional. Consulte as Especificações.
Encerramento por inatividade Ativada, definida para 180 minutos Ativada, definida para 180 minutos
Rede A rede de nuvem privada virtual predefinida do seu projeto A rede de nuvem privada virtual predefinida do seu projeto
Acesso público à Internet Ativado Ativado
Autenticação de credenciais de utilizador final Ativado Ativado
Eliminação automática Eliminação automática 18 horas após a criação Eliminação automática 18 horas após a criação

Versões do Python

A partir de maio de 2025, quando o Colab Enterprise criar um modelo de tempo de execução predefinido, este é configurado para usar a versão mais recente do Python (atualmente, o Python 3.11). Isto significa que, quando uma nova versão do Python estiver disponível no Colab Enterprise, os novos tempos de execução criados a partir do modelo de tempo de execução predefinido vão usar a versão mais recente do Python.

Se os seus modelos de tempo de execução predefinidos foram criados em maio de 2025 ou antes, podem estar configurados para usar o Python 3.10. Para atualizar um modelo de tempo de execução predefinido para usar a versão mais recente do Python, tem de eliminar o modelo de tempo de execução predefinido. Em seguida, quando for criado um novo modelo de tempo de execução predefinido, este é configurado para usar a versão mais recente do Python.

Para atualizar a versão do Python de um modelo de tempo de execução que criou, consulte o artigo Altere a versão do Python de um modelo de tempo de execução.

A versão do Python dos tempos de execução existentes não é alterada automaticamente, mesmo quando está disponível uma nova versão do Python no Colab Enterprise. A alteração da versão do Python de um tempo de execução existente não é suportada. Em alternativa, tem de criar um novo tempo de execução derivado de um modelo de tempo de execução que use a versão do Python pretendida.

Altere a versão do Python de um modelo de ambiente de execução

Para alterar a versão do Python de um modelo de tempo de execução, pode usar a API REST.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • REGION: a região onde o modelo de tempo de execução está localizado.
  • PROJECT_ID: o ID do seu projeto.
  • NOTEBOOK_RUNTIME_TEMPLATE_ID: o ID do modelo de ambiente de execução.
  • RELEASE_NAME: o nome de lançamento da imagem que quer usar. Por exemplo, py311 é o nome da versão da imagem do Python 3.11. Para definir a imagem como Latest, deixe RELEASE_NAME vazio.

Método HTTP e URL: 

PATCH https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimeTemplates/NOTEBOOK_RUNTIME_TEMPLATE_ID?updateMask=software_config.colab_image.release_name

Corpo JSON do pedido: 

{
  softwareConfig: {
    colabImage: {
      releaseName: "RELEASE_NAME"
    }
  }
}

Para enviar o seu pedido, escolha uma destas opções:

curl

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando: 

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimeTemplates/NOTEBOOK_RUNTIME_TEMPLATE_ID?updateMask=software_config.colab_image.release_name"

PowerShell

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimeTemplates/NOTEBOOK_RUNTIME_TEMPLATE_ID?updateMask=software_config.colab_image.release_name" | Select-Object -Expand Content
Se for bem-sucedido, o corpo da resposta contém uma instância de Operation.

Para mais informações, consulte a notebookRuntimeTemplates.patch documentação da API REST.

Os tempos de execução são regionais

Os tempos de execução são regionais e têm de estar localizados na mesma região que o seu bloco de notas.

Os tempos de execução são exclusivos de um utilizador

Os tempos de execução são exclusivos de um utilizador. Não pode partilhar os seus tempos de execução com outras pessoas nem usar os tempos de execução de outras pessoas. Mesmo que partilhe um notebook com alguém, essa pessoa não tem acesso ao seu tempo de execução e tem de executar o notebook no respetivo tempo de execução.

No entanto, os utilizadores podem criar os seus próprios tempos de execução com base no mesmo modelo de tempo de execução. Consulte o artigo Os modelos de tempo de execução podem ser partilhados com os utilizadores.

Gerir os ficheiros do tempo de execução

Pode aceder e modificar ficheiros no seu tempo de execução através do botão  Ficheiros no Colab Enterprise. Também pode carregar ficheiros para o seu ambiente de execução.

Quando o tempo de execução é eliminado, todos os ficheiros que carregar são eliminados. Se tiver modificado ficheiros, estes revertem para o estado original quando é criado um novo tempo de execução. Veja o período de eliminação automática na secção Predefinições de tempo de execução.

Os tempos de execução podem ser partilhados por blocos de notas

Pode associar mais do que um bloco de notas ao mesmo tempo de execução, mas não é recomendado. Vários notebooks que partilham o mesmo tempo de execução podem causar problemas, incluindo:

  • Os blocos de notas podem ser executados lentamente porque estão a partilhar os recursos de computação do tempo de execução.

  • O código num bloco de notas pode afetar o estado da VM do tempo de execução para o outro bloco de notas. Por exemplo, se instalar a versão 1.3 de um pacote num bloco de notas, mas o outro bloco de notas exigir a versão 1.2, pode ter uma incompatibilidade de versões quando executar o segundo bloco de notas.

Em vez de executar código de vários blocos de notas no mesmo tempo de execução, pode criar um tempo de execução para cada bloco de notas com base no mesmo modelo de tempo de execução. Veja Pode criar vários tempos de execução a partir do mesmo modelo de tempo de execução.

Cobranças de tempo de execução

A cobrança do processamento do tempo de execução baseia-se no tipo de máquina e nos aceleradores que usa. Também lhe é cobrado o armazenamento do disco de arranque e do disco de dados. Os discos de arranque e os discos de dados são eliminados quando os tempos de execução são eliminados.

Os tempos de execução incluem sempre um disco persistente SSD de 100 GiB, além do disco de dados especificado no modelo de tempo de execução. O disco de arranque não é configurável.

Enquanto os tempos de execução estão encerrados:

  • Não são geradas cobranças de computação porque não existe utilização da CPU nem da GPU.
  • O armazenamento do disco de arranque e do disco de dados é cobrado.

Para mais informações, consulte os preços do Colab Enterprise.

Pode criar vários tempos de execução a partir do mesmo modelo de tempo de execução

Pode criar vários tempos de execução a partir de um único modelo de tempo de execução não predefinido. Desta forma, pode executar vários notebooks em VMs com a mesma configuração sem partilhar os recursos dessa VM.

Modelos do ambiente de execução

Esta secção descreve as caraterísticas dos modelos de tempo de execução.

Os modelos do ambiente de execução são regionais

Os modelos do ambiente de execução são regionais. Quando cria um tempo de execução, este encontra-se na mesma região que o modelo de tempo de execução e só pode ser usado com blocos de notas nessa região.

Os modelos de tempo de execução podem ser partilhados com os utilizadores

Pode partilhar um modelo de tempo de execução com outros utilizadores. Deste modo, cada utilizador pode criar o seu próprio tempo de execução com base no mesmo modelo de tempo de execução e, por isso, vários utilizadores podem executar o mesmo bloco de notas na mesma configuração de VM.

Para saber mais, consulte o artigo Faça a gestão do acesso a um modelo de tempo de execução.

Configuração

Os modelos de tempo de execução determinam a configuração da VM do tempo de execução. Pode especificar qualquer um dos seguintes elementos:

Região

Escolha a região onde o bloco de notas se encontra. Os tempos de execução criados a partir de modelos de tempo de execução estão na mesma região que o modelo de tempo de execução. Para que o bloco de notas execute código no tempo de execução, o bloco de notas e o tempo de execução têm de estar na mesma região.

Tipo de máquina

Pode configurar o tipo de máquina do modelo de tempo de execução. Para obter informações sobre os tipos de máquinas, consulte o recurso de famílias de máquinas e o guia de comparação.

Disco de dados

Pode configurar o tipo e o tamanho do disco de dados no modelo de tempo de execução.

Quando o tempo de execução é criado, também inclui um disco de arranque. O disco de arranque é um disco persistente SSD de 100 GiB e não pode ser configurado.

Aceleradores

Pode adicionar aceleradores à configuração do modelo de tempo de execução. A disponibilidade dos aceleradores baseia-se no tipo de máquina e na região.

Rede

Especifique a sua rede ou use a rede de nuvem virtual privada predefinida do projeto.

Encerramento por inatividade

O Colab Enterprise ativa o encerramento por inatividade por predefinição. Esta definição encerra a instância após 180 minutos de inatividade. Pode alterar o número de minutos de inatividade antes do encerramento ou desativar o encerramento por inatividade.

Acesso público à Internet

Para ter mais controlo sobre a segurança do seu notebook e outros recursos, pode desativar o acesso público à Internet. Se configurar o modelo de tempo de execução desta forma, os blocos de notas que usam tempos de execução criados a partir do modelo de tempo de execução não têm acesso à Internet pública.

Autenticação de credenciais do utilizador final

Por predefinição, os modelos de tempo de execução usam a autenticação de credenciais do utilizador final para dar ao seu bloco de notas acesso às credenciais padrão da aplicação (ADC). Pode usar este acesso ao ADC para executar código no seu bloco de notas que interage com o Vertex AI e outros Google Cloud serviços. Quando as credenciais do utilizador final estão ativadas, o seu bloco de notas usa as credenciais de quem executa o bloco de notas para determinar o acesso aos Google Cloud recursos.

Se as credenciais do utilizador final não estiverem ativadas, pode aceder ao ADC autenticando o utilizador através do código do seu bloco de notas. Para saber mais, consulte a secção "Credenciais do utilizador" do artigo Configure o ADC para um ambiente de desenvolvimento local.

Custos do modelo do ambiente de execução

Não existem custos financeiros para criar nem armazenar modelos de tempo de execução. Consulte também Encargos de tempo de execução.

O que se segue?