Agende uma execução de notebooks geridos

Agende uma execução de notebooks geridos

Os blocos de notas geridos do Vertex AI Workbench foram descontinuados. A 14 de abril de 2025, o apoio técnico dos blocos de notas geridos terminou e a capacidade de criar instâncias de blocos de notas geridos foi removida. As instâncias existentes vão continuar a funcionar até 30 de março de 2026, mas os patches, as atualizações e as atualizações não vão estar disponíveis. Para continuar a usar o Vertex AI Workbench, recomendamos que migre as suas instâncias de notebooks geridos para instâncias do Vertex AI Workbench.

Esta página mostra como usar o executor de blocos de notas geridos do Vertex AI Workbench para executar um ficheiro de bloco de notas Python num horário de hora a hora.

Antes de começar

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.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

Verify that billing is enabled for your Google Cloud project.

Enable the Notebooks and Vertex AI APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

Verify that billing is enabled for your Google Cloud project.

Enable the Notebooks and Vertex AI APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Funções necessárias

Para garantir que a conta de serviço da sua instância tem as autorizações necessárias para interagir com o executor do Vertex AI Workbench, peça ao seu administrador para conceder à conta de serviço da sua instância as seguintes funções de IAM no projeto:

Importante: tem de conceder estas funções à conta de serviço da sua instância e não à sua conta de utilizador. Se não conceder as funções ao principal correto, podem ocorrer erros de autorização.
• Visualizador de blocos de notas (roles/notebooks.viewer)
• Utilizador do Vertex AI (roles/aiplatform.user)
• Administrador de armazenamento (roles/storage.admin)

Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

O administrador também pode conceder à conta de serviço da sua instância as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

Crie uma instância de blocos de notas geridos e um ficheiro de bloco de notas de exemplo

1. Crie uma instância de notebooks geridos.

2. Abra o JupyterLab.

3. Abra um novo ficheiro de notebook.

4. Na primeira célula do ficheiro do bloco de notas, introduza o seguinte:

   # Import datetime
   import datetime
   
   # Get the time and print it
   datetime.datetime.now()
   print(datetime.datetime.now())

5. Para garantir que o ficheiro do bloco de notas é guardado, selecione Ficheiro > Guardar bloco de notas.

Agende uma execução

1. Na Google Cloud consola, aceda à página Blocos de notas geridos.

   Aceda a notebooks geridos

2. Junto à instância de blocos de notas geridos que quer usar, clique em Abrir JupyterLab.

   A sua instância de blocos de notas geridos abre o JupyterLab.

3. No  explorador de ficheiros, clique duas vezes no ficheiro de exemplo do bloco de notas para o abrir.

4. Clique no botão  Executar.

5. Na caixa de diálogo Enviar blocos de notas para o Executor, no campo Tipo, selecione Execuções recorrentes baseadas em agendamento.

   Por predefinição, o executor executa o ficheiro de bloco de notas a cada hora, ao minuto 00 da hora.

6. Em Opções avançadas, selecione a Região onde quer executar o seu bloco de notas.

7. No campo Bucket do Cloud Storage, introduza um nome para o bucket e, de seguida, clique em Criar e selecionar. O executor armazena a saída do bloco de notas no contentor do Cloud Storage.

8. Clique em Enviar.

   O ficheiro do bloco de notas é executado automaticamente no horário que definiu.

Nota: se a instância de blocos de notas geridos estiver encerrada, o executor continua a executar o ficheiro do bloco de notas de acordo com o agendamento.

Quando terminar as tarefas descritas neste documento, pode evitar a faturação contínua eliminando os recursos que criou. Para mais informações, consulte o artigo Limpe.

Veja, partilhe e importe um ficheiro de bloco de notas executado

Ao usar a interface do JupyterLab da instância de notebooks geridos, pode ver o resultado do notebook, partilhar os resultados com outras pessoas e importar o ficheiro do notebook executado para o JupyterLab.

Nota: para usar a Google Cloud consola para ver e partilhar os resultados da execução, na página Execuções, clique em Execuções.

Veja os resultados da execução

1. No menu de navegação do JupyterLab, clique no botão  Notebook Executor.

2. Clique no separador Execuções.

3. Na execução que quer ver, clique em Ver resultado.

   O Executor abre o resultado num novo separador do navegador.

Partilhe os resultados da execução

1. Na interface do utilizador do JupyterLab da instância de blocos de notas geridos, no menu de navegação, clique no botão  Notebook Executor.

2. Clique no separador Execuções.

3. Junto à execução que quer partilhar, clique no  menu de opções e selecione Partilhar resultado da execução.

4. Siga as instruções na caixa de diálogo para conceder aos utilizadores acesso ao resultado da execução.

Importe o bloco de notas executado para o JupyterLab

1. Na interface do utilizador do JupyterLab da instância de blocos de notas geridos, no menu de navegação, clique no botão  Notebook Executor.

2. Clique no separador Execuções.

3. Junto à execução que quer importar, clique no  menu de opções e selecione Importar bloco de notas executado.

4. Se for apresentada a caixa de diálogo Selecionar kernel, selecione o kernel com o qual quer abrir o bloco de notas.

   O executor abre o ficheiro do bloco de notas executado no JupyterLab e armazena este ficheiro do bloco de notas no explorador de ficheiros do JupyterLab numa pasta denominada imported_notebook_jobs.

Veja ou elimine uma programação

Pode ver e eliminar agendamentos através da Google Cloud consola ou da interface do utilizador do JupyterLab da instância de blocos de notas gerida.

Veja um horário

Veja um agendamento para ver as definições de frequência do agendamento ou para ver os cinco resultados mais recentes da execução do ficheiro de bloco de notas.

Consola

1. Na Google Cloud consola, aceda à página Agendamentos.

   Aceda a Agendas

2. Selecione a região onde quer ver as programações.

3. Na página Detalhes da programação que quer abrir, clique no nome da programação.

   Na página Detalhes da programação, pode ver as últimas cinco execuções da programação.

4. Junto ao nome de uma execução, clique em Ver resultado para abrir o ficheiro de bloco de notas executado.

   O Executor abre o resultado num novo separador do navegador.

JupyterLab

1. Na interface do utilizador do JupyterLab da instância de blocos de notas geridos, no menu de navegação, clique no botão  Notebook Executor.

2. Clique no separador Programações.

3. Na execução que quer ver, clique em Ver o resultado da execução mais recente.

   O Executor abre o resultado num novo separador do navegador.

Elimine um agendamento

A eliminação de um horário não elimina as execuções que foram geradas a partir desse horário.

Consola

1. Na Google Cloud consola, aceda à página Agendamentos.

   Aceda a Agendas

2. Selecione a região que contém o horário que quer eliminar.

3. Selecione o horário que quer eliminar.

4. Clique em  Eliminar.

JupyterLab

1. Na interface do utilizador do JupyterLab da instância de blocos de notas geridos, no menu de navegação, clique no botão  Notebook Executor.

2. Clique no separador Programações.

3. No final do nome da programação, clique no ícone  Abrir num novo. É apresentada a página Detalhes do agendamento para esse agendamento na Google Cloud consola.

4. Clique em  Eliminar.

Limpar

Para evitar incorrer em cobranças na sua Google Cloud conta pelos recursos usados nesta página, siga estes passos.

Elimine a instância

1. Na Google Cloud consola, aceda à página Blocos de notas geridos.

   Aceda a notebooks geridos

2. Selecione a região que contém a sua instância.

3. Selecione a instância de blocos de notas geridos que quer eliminar.

4. Clique em  Eliminar.

Elimine o projeto

Se usou recursos fora da instância de blocos de notas geridos, como o contentor do Cloud Storage necessário para criar uma agenda, é recomendável eliminar o projeto para evitar custos adicionais.

Atenção: a eliminação de um projeto tem os seguintes efeitos:

• Tudo no projeto é eliminado. Se usou um projeto existente para as tarefas neste documento, quando o elimina, também elimina qualquer outro trabalho que tenha feito no projeto.
• Os IDs dos projetos personalizados são perdidos. Quando criou este projeto, pode ter criado um ID do projeto personalizado que quer usar no futuro. Para preservar os URLs que usam o ID do projeto, como um URL appspot.com, elimine os recursos selecionados no projeto em vez de eliminar o projeto inteiro.

Se planeia explorar várias arquiteturas, tutoriais ou inícios rápidos, a reutilização de projetos pode ajudar a evitar exceder os limites de quota de projetos.

1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

O que se segue?

• Saiba como criar uma instância de blocos de notas geridos.