Usar reservas

Usar reservas

Private preview

This feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

For information about access to this release, see the access request page.

Para garantir que os recursos da VM estejam disponíveis quando os ambientes de execução do Colab Enterprise precisarem deles, use reservas do Compute Engine. As reservas fornecem um nível alto de garantia da capacidade dos recursos zonais do Compute Engine.

Visão geral

Para usar uma reserva com o Colab Enterprise, execute as seguintes tarefas:

1. Crie uma reserva.

2. Adicione sua reserva a um novo modelo de ambiente de execução.

3. Use a reserva executando o código em um ambiente de execução derivado do modelo.

Limitações e requisitos

Todas as limitações das reservas do Compute Engine se aplicam quando os ambientes de execução do Colab Enterprise consomem reservas. Saiba Como funcionam as reservas.

Além disso, ao usar reservas com o Colab Enterprise, as seguintes limitações e requisitos se aplicam:

• As reservas para o Colab Enterprise estão em pré-lançamento particular. Para solicitar acesso, consulte a página de solicitação de acesso.

• Os descontos por compromisso de uso não se aplicam.

• Sua reserva precisa estar no mesmo projeto que o notebook e o ambiente de execução do Colab Enterprise.

• O tipo de máquina da reserva precisa corresponder ao tipo de máquina do modelo de execução.

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

Funções exigidas

Para garantir que sua conta de usuário tenha as permissões necessárias para usar reservas com o Colab Enterprise, peça para o administrador conceder à sua conta de usuário os seguintes papéis do IAM no projeto:

• Usuário do Colab Enterprise (roles/aiplatform.colabEnterpriseUser)
• Administrador do Compute (roles/compute.admin)

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 uma reserva

Crie uma reserva do Compute Engine. Pode ser uma reserva de projeto único ou compartilhada. Confira mais informações nestes documentos:

• Criar uma reserva para um único projeto
• Criar uma reserva compartilhada

A reserva pode incluir aceleradores de GPU.

Adicionar sua reserva a um novo modelo de ambiente de execução

Para criar um modelo de ambiente de execução que use sua reserva, 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. Clique em  Novo modelo.

   A caixa de diálogo Criar novo modelo de ambiente de execução será exibida.

3. Na seção Fundamentos do ambiente de execução, insira um Nome de exibição.

4. No menu Região, selecione a região em que você quer o modelo de ambiente de execução.

5. Na seção Configurar computação, no menu Tipo de máquina, selecione um tipo de máquina. O tipo de máquina do modelo de execução precisa corresponder ao tipo de máquina da reserva.

   Se os tipos de máquina da sua reserva e do modelo de ambiente de execução não corresponderem, o Colab Enterprise não vai conseguir criar um ambiente de execução com base nesse modelo.

6. No menu Reservas, selecione a reserva específica que você quer usar ou selecione Usar reservas selecionadas automaticamente.

   Para mais informações sobre como consumir reservas selecionadas automaticamente ou segmentadas especificamente, consulte a seção Tipo de consumo de Como funcionam as reservas.

7. Preencha o restante da caixa de diálogo e clique em Criar.

   Seu modelo de ambiente de execução aparece na lista da guia Modelos de ambiente de execução.

Usar sua reserva

Para usar sua reserva, faça o seguinte:

1. Crie um ambiente de execução com o novo modelo de ambiente de execução.

2. Abra ou crie um notebook.

3. No notebook, conecte-se ao ambiente de execução e execute o código.

Parar de usar sua reserva

Para deixar de usar sua reserva, exclua-a.

Se você quiser continuar usando sua reserva com outros recursos, mas não quiser que seus notebooks do Colab Enterprise a usem, exclua o ambiente de execução e o modelo de ambiente de execução associados à reserva.

Faturamento

Os recursos reservados de VM do Compute Engine são cobrados pelo Colab Enterprise enquanto o ambiente de execução do Colab Enterprise está em execução e são cobrados pelo Compute Engine quando os recursos da VM não estão sendo usados pelo Colab Enterprise.

Resolver problemas

Esta seção mostra como resolver problemas ao usar reservas no Colab Enterprise.

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

Um erro semelhante ao seguinte ocorre quando você tenta criar um ambiente de execução.

Failed to create notebook runtime with error: Invalid value for field
'resource.reservationAffinity': '{"consumeReservationType":
"SPECIFIC_ALLOCATION", "key": "compute.googleapis.com/reservation-name...'.
No available resources in specified reservations.

Esse erro ocorre quando os tipos de máquina do modelo de execução e da reserva não correspondem.

Para resolver esse problema, crie um modelo de ambiente de execução com um tipo de máquina que corresponda ao tipo de máquina da reserva.

A seguir

• Para conceder acesso de principal ao modelo de ambiente de execução, consulte Gerenciar o acesso a um modelo de ambiente de execução.

• Saiba mais sobre as reservas do Compute Engine em Reservas de recursos zonais do Compute Engine.