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 o código 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 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 outro.

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 no notebook e execute o código.

Ambientes de execução

Nesta seção, descrevemos as características dos runtimes.

Ambiente de execução padrão

Se você não criar um ambiente de execução, um ambiente sem aceleradores será criado na primeira vez que você 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.

Só é permitido um ambiente de execução padrão sem aceleradores e um ambiente de execução padrão com aceleradores para cada usuário 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 você pode encontrar informações sobre eles.

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 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 correspondentes criados automaticamente incluem as seguintes especificações:

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

É possível definir um modelo de ambiente de execução atual como o 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 do 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 eram os modelos padrão passam a ser definidos pelo usuário, e os novos ambientes de execução criados com base neles são excluídos automaticamente após seis 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.

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 "Modelos de ambiente de execução":

1. No console 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 more_vert Ações.

4. Dependendo de o modelo incluir 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 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 execução que você quer definir como padrão.

4. Na barra de ações na parte de cima da página, clique em done Definir como padrão ou done 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

A partir de maio de 2025, quando o Colab Enterprise criar um modelo de ambiente de execução padrão, ele será configurado para usar a versão mais recente do Python (atualmente Python 3.12). 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 de ambiente de execução padrão usarão 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 atual. Em vez disso, crie um novo ambiente de execução derivado de um modelo 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 tempo de execução, use o console do Google Cloud ou a API REST.

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

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

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

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.

Entender as datas de fim do suporte

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

• Data de fim do patch e do suporte: após essa data, as seguintes mudanças vão ocorrer:

  • Não é possível criar modelos de ambiente de execução que usam essa versão do Python.
  • Todos os seus modelos de ambiente de execução atuais que usam essa versão do Python receberão um upgrade automático para 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 param de funcionar seis meses após o upgrade mais recente ou, se não forem atualizados, seis meses após a criação.

  Para pedir uma extensão do uso dessa versão do Python até a data de fim da disponibilidade, entre em contato com o representante da sua conta Google Cloud.

• Data de término da disponibilidade: após essa data, as seguintes mudanças vão acontecer:

  • Essa versão do Python não está disponível no Colab Enterprise, nem 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 tempos de execução com outras pessoas nem usar os tempos 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.

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.

Gerenciar os arquivos do ambiente de execução

Para acessar e modificar arquivos no ambiente de execução, use o botão  Arquivos no Colab Enterprise. Você também pode fazer upload de arquivos para seu tempo de execução.

Quando o ambiente de execução é excluído, todos os arquivos enviados por upload também 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 Especificações 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 compartilhando 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 exigir a versão 1.2, poderá haver uma incompatibilidade de versão ao executar o segundo notebook.

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

Taxas de execução

A cobrança é feita pelo processamento de execução com base no tipo de máquina e nos aceleradores usados. Também há cobranças pelo armazenamento de disco de inicialização e de dados. Os discos de inicialização e de dados são excluídos quando os tempos 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 são desligados:

• Não há cobranças de computação porque não há uso de CPU ou GPU.
• O armazenamento de 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.

É possível criar vários ambientes de execução com base em um único modelo de ambiente de execução não padrão. Assim, você pode 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 só pode ser usado com notebooks nessa região.

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

Você pode compartilhar um modelo de execução com outros usuários. Assim, cada usuário pode criar o próprio ambiente de execução com base no mesmo modelo, e 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. Você pode 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 do modelo. Para que o notebook execute o código no ambiente de execução, eles 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 desligamento por inatividade por padrão. Essa configuração encerra a instância após 180 minutos de inatividade. É possível mudar 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ública. 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 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 seu notebook acesso às Application Default Credentials (ADC). É possível usar esse acesso ao ADC para executar um código no notebook que interage com a Agent Platform e outros serviços do Google Cloud . Quando as credenciais de 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, você poderá acessar o ADC autenticando o usuário pelo código do notebook. Para saber mais, consulte a seção "Credenciais do usuário" em Configurar o ADC para um ambiente de desenvolvimento local.

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

Não há cobranças pela criação ou armazenamento de modelos de ambiente de execução. Consulte também Custos 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.