Atualize o ambiente de uma instância

As instâncias do Vertex AI Workbench são instâncias de imagens de VMs de aprendizagem avançada com ambientes de blocos de notas do JupyterLab ativados e prontos a usar. Esta página descreve como atualizar o ambiente de uma instância do Vertex AI Workbench.

Motivos para atualizar

Pode querer atualizar o ambiente da instância do Vertex AI Workbench por qualquer um dos seguintes motivos:

  • Para usar novas capacidades que só estão disponíveis numa versão mais recente do seu ambiente.

  • Para beneficiar das atualizações da framework, das atualizações de pacotes e das correções de erros que foram implementadas numa versão mais recente do seu ambiente.

Métodos de atualização

Existem duas formas de atualizar uma instância do Vertex AI Workbench:

  • Atualização automática: ative a atualização automática quando criar uma instância do Vertex AI Workbench. Durante um período recorrente especificado, o Vertex AI Workbench verifica se a sua instância pode ser atualizada e, em caso afirmativo, atualiza-a.

  • Atualização manual: se uma instância do Vertex AI Workbench existente cumprir os requisitos para a atualização, pode atualizar a instância manualmente.

Requisitos e limitações

A retrocompatibilidade com o Vertex AI Workbench não é garantida. Faça uma cópia dos seus dados antes de atualizar uma instância do Vertex AI Workbench.

Para determinar se pode atualizar uma instância específica do Vertex AI Workbench, consulte os seguintes requisitos e limitações:

  • A API Notebooks tem de estar ativada no projetoGoogle Cloud da instância. Para mais informações, consulte os artigos Liste os serviços ativados e Ative uma API.

  • Se a sua instância do Vertex AI Workbench for baseada em contentores, o Vertex AI Workbench atualiza o SO. A versão da imagem depende da imagem específica extraída pelo seu Dockerfile.

    Para ajudar a garantir que a atualização usa a versão mais recente da imagem, considere usar a etiqueta latest no seu Dockerfile.

Se a atualização da sua instância não for uma opção para si, considere migrar os seus dados para uma nova instância do Vertex AI Workbench.

Como funciona a atualização

As instâncias do Vertex AI Workbench que podem ser atualizadas têm dois discos, um disco de arranque e um disco de dados. O processo de atualização atualiza o disco de arranque para uma nova imagem, ao mesmo tempo que preserva os seus dados no disco de dados.

Que componentes são atualizados ou preservados?

A tabela seguinte mostra que componentes da instância do Vertex AI Workbench são atualizados e quais são preservados.

Componente Resultado da atualização
Frameworks de aprendizagem automática Atualizado
Dados de aprendizagem automática Preservados
Dependências pré-instaladas Atualizado
Bibliotecas instaladas pelo utilizador Por predefinição, tem de ser reinstalada (consulte Bibliotecas instaladas pelo utilizador)
Ficheiros locais no diretório /home/jupyter Preservados
Ficheiros locais em qualquer outro diretório /home/ Não preservado
Pacotes de sistemas operativos pré-instalados Atualizado
Pacotes de sistemas operativos instalados pelo utilizador Não preservado
Controladores da GPU Atualizado
Blocos de notas Preservados
Configurações do utilizador Preservados

Bibliotecas instaladas pelo utilizador

Por predefinição, as instâncias do Vertex AI Workbench armazenam as bibliotecas pip e Conda no disco de arranque, que é substituído durante uma atualização. Quando instala bibliotecas pip, pode incluir a flag --user para as instalar no diretório /home/jupyter/, onde são preservadas durante uma atualização.

Por predefinição, se instalar bibliotecas pip ou Conda num kernel criado a partir de um contentor personalizado, as bibliotecas só persistem enquanto o kernel estiver em execução. Sempre que o kernel é reiniciado, essas bibliotecas têm de ser reinstaladas. Para instalar bibliotecas persistentes num contentor personalizado, inclua as instalações de bibliotecas no seu Dockerfile. Quando instala bibliotecas pip num kernel criado a partir de um contentor personalizado, pode incluir a flag --user para que as bibliotecas persistam até ao reinício da instância.

Versões do ambiente

A sua instância do Vertex AI Workbench tem um número de versão do ambiente que pode validar:

  1. Na Google Cloud consola, aceda à página Instâncias.

    Aceda a Instâncias

  2. Na lista de instâncias, encontre o número da versão do ambiente da instância na coluna Versão.

O Vertex AI Workbench atualiza os ambientes regularmente (consulte as notas de lançamento da VM de aprendizagem profunda), mas nem todos os ambientes são atualizados com cada versão lançada. O Vertex AI Workbench só atualiza uma instância se existir uma versão do ambiente mais recente para a imagem de VM na qual a sua instância se baseia.

Para obter informações sobre como usar uma versão específica para criar uma instância do Vertex AI Workbench, consulte o artigo Crie uma versão específica de uma instância do Vertex AI Workbench.

Antes de começar

Antes de fazer a atualização, conclua os seguintes passos.

  1. Consulte as notas de lançamento para saber mais sobre as atualizações para versões mais recentes.

  2. Crie uma cópia dos seus dados como cópia de segurança.

Atualização automática

O Vertex AI Workbench pode atualizar automaticamente as instâncias em execução. Se a sua instância estiver parada, não é atualizada automaticamente, mesmo que tenha ativado a atualização automática quando a criou.

Quando ativa as atualizações automáticas do ambiente, especifica um período recorrente durante o qual o Vertex AI Workbench verifica se a instância pode ser atualizada e, se puder, atualiza-a.

O período especificado é armazenado como uma entrada de notebook-upgrade-schedulemetadados no formato unix-cron, Hora do Meridiano de Greenwich (GMT).

Para verificar se uma instância pode ser atualizada, o Vertex AI Workbench usa o método API checkUpgradability. Este método procura uma versão mais recente da imagem no disco de arranque da instância.

Se for possível atualizar a instância, o Vertex AI Workbench usa um método de atualização interno para atualizar a instância.

Crie uma instância do Vertex AI Workbench com a atualização automática ativada

Para criar uma instância do Vertex AI Workbench com a atualização automática ativada, selecione a caixa de verificação Ativar atualização automática do ambiente e defina um horário quando criar a instância.

Pode especificar a atualização automática através da Google Cloud consola.

  1. Na Google Cloud consola, aceda à página Instâncias.

    Aceda a Instâncias

  2. Clique em  Criar novo.

  3. Na caixa de diálogo Nova instância, clique em Opções avançadas.

  4. Na caixa de diálogo Criar instância, na secção Detalhes, faculte as seguintes informações para a sua nova instância:

    • Nome: indique um nome para a nova instância.
    • Região e Zona: selecione uma região e uma zona para a nova instância. Para o melhor desempenho da rede, selecione a região geograficamente mais próxima de si. Consulte as localizações do Vertex AI Workbench disponíveis.

  5. Na secção Estado do sistema, selecione Atualização automática do ambiente.

  6. Escolha se quer atualizar o seu bloco de notas semanalmente ou mensalmente.

  7. No campo Dia da semana, selecione a opção pretendida.

  8. No campo Hora, escolha uma hora do dia.

  9. Conclua o resto da caixa de diálogo de criação da instância e, de seguida, clique em Criar.

Edite a programação da atualização automática

Para editar a programação da atualização automática depois de criar a instância do Vertex AI Workbench, conclua os seguintes passos:

  1. Na Google Cloud consola, aceda à página Instâncias.

    Aceda a Instâncias

  2. Clique no nome da instância que precisa da alteração de horário.

  3. Na página Detalhes da instância, na secção Atualização automática do ambiente, edite o agendamento.

  4. Clique em Enviar para guardar as alterações.

Atualização manual

Pode atualizar manualmente as instâncias do Vertex AI Workbench que cumprem os requisitos.

Verifique se existe uma versão mais recente do ambiente da sua instância

Para verificar se está disponível uma versão mais recente do ambiente da sua instância, aceda à instância a partir da consola Google Cloud .

  1. Na Google Cloud consola, aceda à página Instâncias.

    Aceda a Instâncias

  2. Clique no nome da instância que quer verificar para saber se existe uma versão mais recente do ambiente.

  3. Na página Detalhes da instância, junto a Detalhes da VM, clique em Ver no Compute Engine.

    Se estiver disponível uma versão mais recente do ambiente, é apresentada a mensagem "Esta instância tem de ser atualizada".

Atualize o ambiente da sua instância para uma versão mais recente

Pode atualizar manualmente uma instância do Vertex AI Workbench na Google Cloud consola.

  1. Na Google Cloud consola, aceda à página Instâncias.

    Aceda a Instâncias

  2. Se a instância não estiver em execução, inicie a instância. O Vertex AI Workbench só pode atualizar instâncias quando estão em execução.

  3. Clique no nome da instância que quer atualizar.

  4. Na página Detalhes da instância, clique em  Atualizar.

  5. Certifique-se de que fez uma cópia dos dados na sua instância antes de continuar.

  6. Depois de fazer uma cópia de segurança dos dados, clique em Atualizar. O Vertex AI Workbench atualiza e inicia a sua instância.

Reverta uma atualização

Para reverter uma atualização, conclua os seguintes passos:

  1. Na Google Cloud consola, aceda à página Instâncias.

    Aceda a Instâncias

  2. Clique no nome da instância que quer reverter.

  3. Na página Detalhes da instância, em Histórico de atualizações, clique em Reverter.

  4. O Vertex AI Workbench reverte a instância para a versão anterior.