Programar uma execução de notebooks gerenciados
Nesta página, mostramos como usar o executor de notebooks gerenciados do Vertex AI Workbench para executar um arquivo de notebook do Python a cada hora.
Antes de começar
- Faça login na sua conta do Google Cloud. Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Verifique se a cobrança está ativada para o seu projeto do Google Cloud.
-
Enable the Notebooks and Vertex AI APIs.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Verifique se a cobrança está ativada para o seu projeto do Google Cloud.
-
Enable the Notebooks and Vertex AI APIs.
Funções exigidas
Para garantir que a conta de serviço da instância tenha as permissões necessárias para interagir com o executor do Vertex AI Workbench, peça ao administrador para conceder à conta de serviço da instância o papel de visualizador de notebooks do IAM no projeto.
-
Leitor do Notebooks (
roles/notebooks.viewer
) -
Usuário da Vertex AI (
roles/aiplatform.user
) -
Administrador do Storage (
roles/storage.admin
)
Para mais informações sobre como conceder papéis, consulte Gerenciar acesso.
O administrador também pode conceder à conta de serviço da instância as permissões necessárias por meio de papéis personalizados ou de outros papéis predefinidos
Criar uma instância de notebook gerenciado e um exemplo de arquivo de notebook
Na primeira célula do arquivo de notebook, digite o seguinte:
# Import datetime import datetime # Get the time and print it datetime.datetime.now() print(datetime.datetime.now())
Para garantir que o arquivo de notebook esteja salvo, selecione Arquivo > Salvar notebook.
Programar uma execução
No Console do Google Cloud, acesse a página Notebooks gerenciados.
Ao lado da instância de notebooks gerenciados que você quer usar, clique em Abrir JupyterLab.
Sua instância de notebooks gerenciados abre o JupyterLab.
No navegador de arquivos
, clique duas vezes no arquivo de notebook do exemplo para abri-lo.Clique no botão
Executar.Na caixa de diálogo Enviar notebooks para Executor, no campo Tipo, selecione Execuções recorrentes baseadas em programação.
Por padrão, o executor executa o arquivo de notebook a cada hora, no minuto
00
da hora.Em Opções avançadas, selecione a Região em que você quer executar o notebook.
No campo Bucket do Cloud Storage, insira um nome para o bucket e clique em Criar e selecionar. O executor armazena a saída do notebook no bucket do Cloud Storage.
Selecione Enviar.
O arquivo de notebook é executado automaticamente de acordo com a programação que você definir.
Ao concluir as tarefas descritas neste documento, é possível evitar o faturamento contínuo excluindo os recursos criados. Saiba mais em Limpeza.
Visualizar, compartilhar e importar um arquivo de notebook executado
Ao usar a interface JupyterLab da instância de notebooks gerenciados, é possível visualizar a saída do notebook, compartilhar os resultados com outras pessoas e importar o arquivo do notebook executado para o JupyterLab.
Ver os resultados da execução
No menu de navegação do JupyterLab, clique no botão
Executor do notebook.Clique na guia Executions.
Na execução que você quer visualizar, clique em Ver resultado.
O Executor abre o resultado em uma nova guia do navegador.
Compartilhar os resultados da execução
Na interface do usuário do JupyterLab da instância de notebooks gerenciados, no menu de navegação, clique no botão
Executor de notebook.Clique na guia Executions.
Ao lado da execução que você quer compartilhar, clique no menu de opções
e selecione Compartilhar resultado da execução.Siga as instruções na caixa de diálogo para conceder aos usuários acesso ao resultado da execução.
Importar o notebook executado para o JupyterLab
Na interface do usuário do JupyterLab da instância de notebooks gerenciados, no menu de navegação, clique no botão
Executor de notebook.Clique na guia Executions.
Ao lado da execução que você quer importar, clique no menu de opções
e selecione Importar notebook executado.Se a caixa de diálogo Selecionar kernel for exibida, selecione o kernel que você quer abrir no notebook.
O executor abre o arquivo de notebook executado no JupyterLab e o armazena no navegador de arquivos do JupyterLab em uma pasta chamada imported_notebook_jobs.
Ver ou excluir uma programação
É possível visualizar e excluir programações usando o console do Google Cloud ou a interface de usuário do JupyterLab da instância de notebooks gerenciados.
Ver uma programação
Visualize uma programação para ver as configurações de frequência dela ou os cinco resultados mais recentes da execução do arquivo de notebook.
Console
No Console do Google Cloud, acesse a página programação.
Selecione a Região em que você quer ver as programações.
Na página Detalhes da programação que você quer abrir, clique no nome da programação.
Na página Detalhes da programação, é possível ver as últimas cinco execuções da programação.
Ao lado de um nome de execução, clique em Ver resultado para abrir o arquivo de notebook executado.
O Executor abre o resultado em uma nova guia do navegador.
JupyterLab
Na interface do usuário do JupyterLab da instância de notebooks gerenciados, no menu de navegação, clique no botão Executor de notebook
.Clique na guia Programações.
Na execução que você quer visualizar, clique em Ver o resultado mais recente.
O Executor abre o resultado em uma nova guia do navegador.
Excluir uma programação
Excluir uma programação não exclui as execuções que foram geradas a partir dela.
Console
No Console do Google Cloud, acesse a página programação.
Selecione a Região que contém a programação que você quer excluir.
Selecione a programação que você quer excluir.
Clique em
Excluir.
JupyterLab
Na interface do usuário do JupyterLab da instância de notebooks gerenciados, no menu de navegação, clique no botão Executor de notebook
.Clique na guia Programações.
No final do nome da programação, clique em
Abrir em um novo ícone. A página Detalhes da programação é aberta no console do Google Cloud.Clique
Excluir.
Limpar
Para evitar cobranças na conta do Google Cloud pelos recursos usados nesta página, siga estas etapas.
Excluir a instância
No Console do Google Cloud, acesse a página Notebooks gerenciados.
Selecione a Região que contém a instância.
Selecione a instância de notebooks gerenciados que você quer excluir.
Clique
Excluir.
Excluir o projeto
Se você usou recursos fora da instância de notebooks gerenciado, como o bucket do Cloud Storage necessário para criar uma programação, exclua o projeto para evitar outras cobranças.
- In the Google Cloud console, go to the Manage resources page.
- In the project list, select the project that you want to delete, and then click Delete.
- In the dialog, type the project ID, and then click Shut down to delete the project.
A seguir
- Saiba mais sobre como criar uma instância de notebooks gerenciados.