Ambientes de execução e modelos de ambiente de execução

Ambientes de execução e modelos de ambiente de execução

Nesta página, descrevemos os ambientes de execução e os modelos de ambiente de execução do Colab Enterprise.

Um ambiente de execução é uma máquina virtual (VM) provisionada pelo Google que pode executar códigos no seu notebook (arquivo IPYNB).

Um modelo de ambiente de execução é uma configuração de VM que especifica o tipo de máquina e outras características da VM, além de definições comuns, como a rede e ativação do acesso à Internet pública. Quando você cria um ambiente de execução, a VM dele é criada de acordo com as especificações de um modelo.

Fluxo de trabalho

Você pode criar um notebook do Colab Enterprise e executar código nele sem precisar entender de ambientes de execução. Quando você executa o código em um notebook pela primeira vez, o Colab Enterprise provisiona um ambiente de execução padrão e executa o código nele. O Colab Enterprise continua usando o ambiente de execução padrão até que você se conecte a um ambiente diferente.

Para configurar um ambiente de execução para necessidades específicas, é preciso:

1. Crie um modelo de ambiente de execução com a configuração necessária.

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

3. Conecte-se ao ambiente de execução pelo notebook e execute o código.

Ambientes de execução

Nesta seção, descrevemos as características dos ambientes de execução.

Ambiente de execução padrão

Se você não criar um ambiente de execução, um ambiente sem aceleradores será criado para você na primeira vez que executar o código ou se conectar ao ambiente de execução padrão. É possível usar o ambiente de execução padrão sem aceleradores ou mudar para um ambiente de execução padrão que inclua aceleradores.

Cada usuário pode ter apenas um ambiente de execução padrão sem aceleradores e um com aceleradores por projeto e regiã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 correspondente se o projeto ainda não tiver um na região. O ambiente de execução padrão e o modelo de ambiente de execução aparecem no console do Google Cloud , onde é possível encontrar informações sobre eles.

Observação: a função de usuário corporativo do Colab Enterprise (roles/aiplatform.colabEnterpriseUser) não inclui uma permissão necessária para criar um modelo de ambiente de execução padrão (aiplatform.notebookRuntimeTemplates.create). Isso significa que, para criar um ambiente de execução padrão, se não houver um modelo padrão, os usuários com a função de usuário corporativo do Colab Enterprise também precisarão ter um papel que inclua a permissão aiplatform.notebookRuntimeTemplates.create.

Se você usar ambientes de execução padrão sem aceleradores, o Colab Enterprise vai criar um ambiente de execução padrão sem aceleradores e o modelo de ambiente de execução correspondente, se não houver um modelo de ambiente de execução padrão, por projeto e por região.

Se você usar ambientes de execução padrão com aceleradores, o Colab Enterprise vai criar um ambiente de execução padrão com aceleradores e o modelo de ambiente de execução correspondente se não houver um modelo de ambiente de execução padrão com aceleradores, por projeto e por região.

Especificações de ambiente de execução padrão

Os ambientes de execução padrão e os modelos de ambiente de execução padrão criados automaticamente incluem as seguintes especificações:

Especificação	Padrão	Padrão com GPU
Versão do Python	Mais recente disponível (atualmente Python 3.13)	Mais recente disponível (atualmente Python 3.13)
Tipo de máquina	e2-standard-4	Depende da disponibilidade regional. Consulte Especificações.
Accelerator	Nenhum	Depende da disponibilidade regional. Consulte Especificações.
Disco de inicialização	Disco permanente SSD de 100 GiB (pd-ssd)	Disco permanente SSD de 100 GiB (pd-ssd)
Disco de dados	Disco permanente padrão de 100 GiB (pd-standard)	Depende da disponibilidade regional. Consulte Especificações.
Encerramento por inatividade	Ativado, definido como 180 minutos	Ativado, definido como 180 minutos
Rede	A rede de nuvem privada virtual padrão do seu projeto	A rede de nuvem privada virtual padrão do seu projeto
Acesso público à Internet	Ativado	Ativado
Autenticação de credenciais do usuário final	Ativado	Ativado
Exclusão automática	Exclusão automática 18 horas após a criação	Exclusão automática 18 horas após a criação

Observação: quando o ambiente de execução é excluído, o Colab Enterprise não preserva as mudanças feitas nos arquivos dele. Além disso, todos os arquivos que você enviou para o ambiente de execução são excluídos.

Definir um modelo de ambiente de execução como padrão

É possível definir um modelo de ambiente de execução atual como o modelo padrão para seu projeto e região. Quando você define um modelo de ambiente de execução como padrão, os novos ambientes de execução padrão criados no projeto e na região atuais usam a configuração desse modelo. Os ambientes de execução atuais não serão afetados.

Depois que um modelo de ambiente de execução é definido como padrão, todos os novos ambientes de execução criados com base nele são excluídos automaticamente 18 horas após a criação.

Cada combinação de região e projeto pode ter apenas um modelo de ambiente de execução padrão sem aceleradores e um modelo de ambiente de execução padrão com aceleradores. Os modelos de ambiente de execução que antes eram os modelos padrão se tornam modelos definidos pelo usuário, e os novos ambientes de execução criados com base neles são excluídos automaticamente após 6 meses.

É possível definir um modelo de ambiente de execução padrão sem aceleradores e um modelo de ambiente de execução padrão com aceleradores.

Observação: para definir um modelo de ambiente de execução como padrão, é preciso ter a permissão aiplatform.notebookRuntimeTemplates.setDefault. Essa permissão está incluída em papéis como Administrador do Colab Enterprise (roles/aiplatform.colabEnterpriseAdmin) e Administrador do ambiente de execução de notebooks (roles/aiplatform.notebookRuntimeAdmin).

Para definir um modelo de ambiente de execução como padrão, use o console doGoogle Cloud . É possível fazer isso na página Modelos de ambiente de execução ou na página de detalhes de um modelo de ambiente de execução.

Na página de modelos de ambiente de execução:

1. No console do Google Cloud , acesse a página Modelos de ambiente de execução do Colab Enterprise.

   Acessar "Modelos de ambiente de execução"

2. No menu Região, selecione a região que contém o modelo de ambiente de execução.

3. Na linha do modelo de ambiente de execução que você quer definir como padrão, clique em  Ações.

4. Dependendo se o modelo inclui aceleradores:

   • Para um modelo sem aceleradores, clique em Definir como padrão.
   • Para um modelo com aceleradores, clique em Definir como padrão com GPU.

5. Na caixa de diálogo de confirmação, clique em Definir como padrão ou Definir como padrão com GPU para confirmar.

Na página de detalhes do modelo de ambiente de execução:

1. No console do Google Cloud , acesse a página Modelos de ambiente de execução do Colab Enterprise.

   Acessar "Modelos de ambiente de execução"

2. No menu Região, selecione a região que contém o modelo de ambiente de execução.

3. Na coluna ID, clique no ID do modelo de ambiente de execução que você quer definir como padrão.

4. Na barra de ações na parte de cima da página, clique em  Definir como padrão ou  Definir como padrão com GPU.

5. Na caixa de diálogo de confirmação, clique em Definir como padrão ou Definir como padrão com GPU para confirmar.

Versões do Python

Quando o Colab Enterprise cria um modelo de ambiente de execução padrão, ele é configurado para usar a versão mais recente disponível do Python (atualmente, Python 3.13). Isso significa que, quando uma nova versão do Python estiver disponível no Colab Enterprise, os novos ambientes de execução criados com base no modelo padrão vão usar a versão mais recente do Python.

Se os modelos de ambiente de execução padrão foram criados em maio de 2025 ou antes, eles podem estar configurados para usar o Python 3.10. Para atualizar um modelo de ambiente de execução padrão para usar a versão mais recente do Python, exclua o modelo de ambiente de execução padrão. Assim, quando um novo modelo de ambiente de execução padrão for criado, ele será configurado para usar a versão mais recente do Python.

Para atualizar a versão do Python de um modelo de ambiente de execução que você criou, consulte Gerenciar modelos de ambiente de execução.

A versão do Python dos ambientes de execução atuais não muda automaticamente, mesmo quando uma nova versão do Python está disponível no Colab Enterprise. Não é possível mudar a versão do Python de um ambiente de execução. Em vez disso, crie um novo ambiente de execução derivado de um modelo de ambiente de execução que use a versão do Python que você quer.

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

Para mudar a versão do Python de um modelo de ambiente de execução, use o console do Google Cloud ou a API REST.

Console

Para editar um modelo de ambiente de execução, faça o seguinte:

1. No console do Google Cloud , acesse a página Modelos de ambiente de execução do Colab Enterprise.

   Acessar "Modelos de ambiente de execução"

2. No menu Região, selecione a região que contém o modelo de ambiente de execução.

3. Na coluna ID, clique no número de ID do modelo de ambiente de execução que você quer editar.

4. Clique em  Editar.

5. No painel Editar modelo de ambiente de execução, faça as mudanças necessárias.

6. Clique em Atualizar.

REST

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

• REGION: a região em que o modelo de ambiente 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 da versão da imagem que você 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 da solicitação:

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

Para enviar a solicitação, escolha uma destas opções:

curl

Observação: o comando a seguir pressupõe que você tenha feito login na gcloud CLI com sua conta de usuário executando gcloud init ou gcloud auth login ou usando o Cloud Shell, que faz login automaticamente na gcloud CLI. Para saber qual é a conta ativa no momento, execute o comando gcloud auth list.

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando abaixo:

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

Observação: o comando a seguir pressupõe que você fez login na gcloud CLI com sua conta de usuário executando gcloud init ou gcloud auth login. Para saber qual é a conta ativa no momento, execute o comando gcloud auth list.

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

$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 a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Operation.

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

Versões compatíveis do Python

O Colab Enterprise oferece suporte a versões do Python por períodos específicos.

A tabela a seguir lista a data de término do patch e do suporte e a data de disponibilidade para cada versão compatível do Python. Para saber mais sobre essas datas, consulte Entender as datas de fim do suporte.

Versão do Python	Fim do patch e da data de suporte	Data de término da disponibilidade
Python 3.13	A ser determinado	A ser determinado
Python 3.12	A ser determinado	A ser determinado
Python 3.11	A ser determinado	A ser determinado
Python 3.10	23 de fevereiro de 2026	17 de agosto de 2026

Entender as datas de fim do suporte

O suporte a uma versão do Python termina de acordo com as seguintes datas:

• Fim do patch e da data de suporte: após essa data, as seguintes alterações vão ocorrer:

  • Não é possível criar modelos de ambiente de execução que usem essa versão do Python.
  • Todos os modelos de ambiente de execução que usam essa versão do Python são atualizados automaticamente para usar a versão mais recente disponível.
  • Não é mais possível fazer upgrade dos ambientes de execução atuais.
  • Os ambientes de execução deixam de funcionar seis meses após o upgrade mais recente ou, se não forem atualizados, seis meses após a criação.

  Para solicitar uma extensão para usar essa versão do Python até o fim da data de disponibilidade, entre em contato com o representante da sua conta do Google Cloud .

• Data de término da disponibilidade: após essa data, as seguintes alterações vão ocorrer:

  • Essa versão do Python não está disponível no Colab Enterprise, mesmo para usuários que receberam uma extensão.
  • Todos os modelos de ambiente de execução que usam essa versão do Python são atualizados automaticamente para usar a versão mais recente disponível.

Os ambientes de execução são regionais

Os ambientes de execução são regionais e precisam estar localizados na mesma região do notebook.

Os ambientes de execução são exclusivos de um usuário

Os ambientes de execução são exclusivos de um usuário. Não é possível compartilhar seus ambientes de execução com outras pessoas, nem usar os ambientes de execução delas. Mesmo que você compartilhe um notebook com alguém, essa pessoa não terá acesso ao seu ambiente de execução e precisará executar o notebook no próprio ambiente de execução.

No entanto, os usuários podem criar os próprios ambientes de execução com base no mesmo modelo. Consulte Os modelos de ambiente de execução podem ser compartilhados com os usuários.

Como gerenciar os arquivos do ambiente de execução

É possível acessar e modificar arquivos no ambiente de execução usando o botão  Arquivos no Colab Enterprise. Também é possível fazer upload de arquivos para o ambiente de execução.

Quando o ambiente de execução é excluído, todos os arquivos que você enviou por upload são excluídos. Se você tiver modificado arquivos, eles vão voltar ao estado original quando um novo ambiente de execução for criado. Consulte o período de exclusão automática na seção de especificações de ambiente de execução padrão.

Os ambientes de execução podem ser compartilhados por notebooks

É possível conectar mais de um notebook ao mesmo ambiente de execução, mas isso não é recomendado. Vários notebooks que compartilham o mesmo ambiente de execução podem causar problemas, incluindo:

• Os notebooks podem ser executados lentamente porque estão compartilhando os recursos de computação do ambiente de execução.

• O código em um notebook pode afetar o estado da VM do ambiente de execução para o outro notebook. Por exemplo, se você instalar a versão 1.3 de um pacote em um notebook, mas o outro notebook exigir a versão 1.2, poderá haver uma incompatibilidade de versão ao executar o segundo notebook.

Em vez de executar o código de vários notebooks no mesmo ambiente de execução, é possível criar um ambiente de execução para cada notebook com base no mesmo modelo de ambiente de execução. Consulte É possível criar vários ambientes de execução com base no mesmo modelo de ambiente de execução.

Cobranças do ambiente de execução

A cobrança é feita pelo processamento de execução com base no tipo de máquina e nos aceleradores que você usa. Também há cobranças pelo armazenamento de discos de inicialização e de dados. Os discos de inicialização e de dados são excluídos quando os ambientes de execução são excluídos.

Os ambientes de execução sempre incluem um disco permanente SSD de 100 GiB, além do disco de dados especificado no modelo de ambiente de execução. O disco de inicialização não é configurável.

Enquanto os ambientes de execução estiverem desativados:

• As cobranças de computação não são geradas porque não há uso de CPU ou GPU.
• O armazenamento do disco de inicialização e de dados é cobrado.

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

É possível criar vários ambientes de execução com base no mesmo modelo de ambiente de execução.

É possível criar vários ambientes de execução com base em um único modelo de ambiente de execução não padrão. Dessa forma, é possível executar vários notebooks em VMs com a mesma configuração sem compartilhar os recursos dessa VM.

Modelos de ambiente de execução

Nesta seção, descrevemos as características dos modelos de ambiente de execução.

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

Os modelos de ambiente de execução são regionais. Quando você cria um ambiente de execução, ele fica na mesma região que o modelo de ambiente de execução, e o ambiente de execução só pode ser usado com notebooks nessa região.

Os modelos de ambiente de execução podem ser compartilhados com os usuários

É possível compartilhar um modelo de ambiente de execução com outros usuários. Dessa forma, cada usuário pode criar o próprio ambiente de execução com base no mesmo modelo de ambiente de execução. Assim, vários usuários podem executar o mesmo notebook na mesma configuração de VM.

Para saber mais, consulte Gerenciar o acesso a um modelo de ambiente de execução.

Configuração

Os modelos de ambiente de execução determinam a configuração da VM do ambiente de execução. É possível especificar qualquer uma das seguintes opções:

Região

Escolha a região em que o notebook está. Os ambientes de execução criados com base em modelos de ambiente de execução estão na mesma região que o modelo. Para que o notebook execute o código no ambiente de execução, ambos precisam estar na mesma região.

Tipo de máquina

É possível configurar o tipo de máquina do modelo de ambiente de execução. Para informações sobre tipos de máquina, consulte o guia de comparação e recursos das famílias de máquinas.

Disco de dados

É possível configurar o tipo e o tamanho do disco de dados no modelo de ambiente de execução.

Quando o ambiente de execução é criado, ele também inclui um disco de inicialização. O disco de inicialização é um disco permanente SSD de 100 GiB e não pode ser configurado.

Aceleradores

É possível adicionar aceleradores à configuração do modelo de ambiente de execução. A disponibilidade do acelerador é baseada no tipo de máquina e na região.

Rede

Especifique sua rede ou use a rede de nuvem privada virtual padrão do projeto.

Encerramento por inatividade

O Colab Enterprise ativa o encerramento por inatividade por padrão. Essa configuração encerra a instância após 180 minutos de inatividade. É possível alterar o número de minutos de inatividade antes do encerramento ou desativar o desligamento.

Acesso público à Internet

Para ter mais controle sobre a segurança do notebook e de outros recursos, desative o acesso à internet público. Se você configurar o modelo de ambiente de execução dessa forma, os notebooks que usam ambientes de execução criados com base no modelo de ambiente de execução não terão acesso à Internet pública.

Autenticação de credenciais do usuário final

Por padrão, os modelos de ambiente de execução usam a autenticação de credenciais de usuário final para dar ao notebook acesso ao Application Default Credentials (ADC). É possível usar esse acesso ao ADC para executar códigos no notebook que interagem com a Agent Platform e outros serviços do Google Cloud . Quando as credenciais do usuário final estão ativadas, o notebook usa as credenciais de quem o executa para determinar o acesso aos recursos do Google Cloud .

Se as credenciais de usuário final não estiverem ativadas, será possível acessar o ADC autenticando o usuário pelo código do notebook. Para saber mais, consulte a seção "Credenciais do usuário" de Configurar o ADC para um ambiente de desenvolvimento local.

Cobranças de modelos de ambiente de execução

Não há cobranças para criar ou armazenar modelos de ambiente de execução. Consulte também Cobranças do ambiente de execução.

A seguir

• Crie um ambiente de execução com base em um modelo de ambiente de execução.
• Conecte-se a um ambiente de execução.
• Crie um modelo de ambiente de execução.