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:

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.12). 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 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 de lançamento 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 -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"

$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

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

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.