Fazer upgrade do ambiente de uma instância

As instâncias do Vertex AI Workbench são Deep Learning VM Images com ambientes de notebook do JupyterLab ativados e prontos para uso. Nesta página, descrevemos como fazer upgrade do ambiente de uma instância do Vertex AI Workbench.

Motivos do upgrade

Talvez você queira fazer upgrade do ambiente da instância do Vertex AI Workbench por qualquer um dos seguintes motivos:

  • Para usar os novos recursos que estão disponíveis apenas em uma versão mais recente do ambiente.

  • Para aproveitar as atualizações de framework e de pacote, além de correções de bugs que foram implementadas em uma versão mais recente do ambiente.

Métodos de upgrade

Há duas maneiras de fazer upgrade de uma instância do Vertex AI Workbench:

  • Upgrade automático: ative o upgrade automático ao criar uma instância do Vertex AI Workbench. Durante um período recorrente especificado, o Vertex AI Workbench verificará se é possível fazer upgrade da instância. Em caso afirmativo, o Vertex AI Workbench fará o upgrade da instância.

  • Upgrade manual: se uma instância atual do Vertex AI Workbench atender aos requisitos para upgrade, será possível fazer upgrade da instância manualmente.

Requisitos e limitações

A compatibilidade com versões anteriores do Vertex AI Workbench não é garantida. Faça uma cópia dos dados antes de fazer upgrade de uma instância do Vertex AI Workbench.

Para determinar se é possível fazer upgrade de uma instância específica do Vertex AI Workbench, consulte os requisitos e limitações a seguir:

  • A API Notebooks precisa ser ativada no projeto do Google Cloud da instância. Para mais informações, consulte Listar serviços ativados e Ativar uma API.

  • Se a instância do Vertex AI Workbench for baseada em contêiner, o Vertex AI Workbench fará upgrade do SO. A versão da imagem depende da imagem específica extraída pelo Dockerfile.

    Para garantir que o upgrade use a versão mais recente da imagem, use a tag latest no Dockerfile.

Se o upgrade da instância não for uma opção para você, considere migrar seus dados para uma nova instância do Vertex AI Workbench.

Como o upgrade funciona

As instâncias do Vertex AI Workbench que podem receber upgrade são discos duplos, com um disco de inicialização e um de dados. O processo de upgrade atualiza o disco de inicialização para uma nova imagem e preserva seus dados no disco.

Quais componentes são atualizados ou preservados?

A tabela a seguir mostra quais componentes da instância do Vertex AI Workbench foram atualizados e preservados.

Componente Resultado do upgrade
Frameworks de machine learning Com upgrade
Dados de machine learning Preservado
Dependências pré-instaladas Upgrade concluído
Bibliotecas instaladas pelo usuário Por padrão, precisa ser reinstalado (consulte Bibliotecas instaladas pelo usuário)
Arquivos locais no diretório /home/jupyter Preservado
Arquivos locais em qualquer outro diretório /home/ Não preservado.
Pacotes de sistema operacional pré-instalados Com upgrade
Pacotes de sistema operacional instalados pelo usuário Não preservado.
Drivers de GPU Com upgrade
Notebooks Preservado
Configurações do usuário Preservado

Bibliotecas instaladas pelo usuário

Por padrão, as instâncias do Vertex AI Workbench armazenam as bibliotecas pip e Conda no disco de inicialização, que é substituída durante um upgrade. Ao instalar bibliotecas pip, é possível incluir a sinalização --user para instalá-las no diretório /home/jupyter/, em que elas são preservadas durante um upgrade.

Por padrão, se você instalar bibliotecas pip ou Conda em um kernel criado a partir de um contêiner personalizado, as bibliotecas só persistirão enquanto o kernel estiver em execução. Sempre que o kernel for reiniciado, essas bibliotecas precisarão ser reinstaladas. Para instalar bibliotecas permanentes em um contêiner personalizado, inclua as instalações da biblioteca no Dockerfile. Ao instalar bibliotecas pip em um kernel criado a partir de um contêiner personalizado, é possível incluir a sinalização --user para que as bibliotecas persistam até a reinicialização da instância.

Versões do ambiente

Sua instância do Vertex AI Workbench tem um número de versão do ambiente que pode ser verificado:

  1. No Console do Google Cloud, acesse a página Instâncias.

    Acesse "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 da versão da VM de aprendizado profundo (em inglês), mas a cada versão lançada, nem todos os ambientes são atualizados. O Vertex AI Workbench só faz upgrade de uma instância se houver uma versão de ambiente mais recente para a imagem de VM em que a instância é baseada.

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

Antes de começar

Antes de fazer upgrade, siga estas etapas.

  1. Consulte asnotas da versão para ver as mudanças das novas versões.

  2. Faça uma cópia dos dados como backup.

Upgrade automático

O Vertex AI Workbench pode fazer upgrade automaticamente das instâncias que estiverem em execução. Se a instância estiver interrompida, o upgrade não será feito automaticamente, mesmo que você tenha ativado o upgrade automático ao criá-la.

Ao ativar upgrades automáticos do ambiente, você especifica um período recorrente em que o Vertex AI Workbench verifica se a instância pode ser atualizada e, se puder, faz upgrade da instância.

O período especificado é armazenado como uma entrada de metadados notebook-upgrade-schedule, no formato unix-cron, Horário do Meridiano de Greenwich (GMT)

Para verificar se é possível fazer upgrade de uma instância, o Vertex AI Workbench usa o método de API checkUpgradability. Esse método verifica se há uma versão mais recente da imagem no disco de inicialização da instância.

Se for possível fazer upgrade da instância, o Vertex AI Workbench usará um método de upgrade interno para fazer upgrade.

Criar uma instância do Vertex AI Workbench com o upgrade automático ativado

Para criar uma instância do Vertex AI Workbench com o upgrade automático ativado, marque a caixa de seleção Ativar upgrade automático do ambiente e defina uma programação ao criar a instância.

É possível especificar o upgrade automático usando o console do Google Cloud.

  1. No Console do Google Cloud, acesse a página Instâncias.

    Acesse "Instâncias"

  2. Clique em Criar.

  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 seção Detalhes, insira as seguintes informações sobre a nova instância:

    • Nome: forneça um nome para a nova instância.
    • Região e Zona: selecione uma região e zona para a nova instância. Para ter o melhor desempenho de rede, selecione a região mais próxima de você. Veja os locais disponíveis do Vertex AI Workbench.

  5. Na seção Integridade do sistema, selecione Upgrade automático do ambiente.

  6. Escolha se você quer fazer upgrade do notebook semanal ou mensal.

  7. No campo Weekday, selecione a opção que você quer.

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

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

Editar a programação do upgrade automático

Para editar a programação de upgrade automático depois de criar a instância do Vertex AI Workbench, siga estas etapas:

  1. No Console do Google Cloud, acesse a página Instâncias.

    Acesse "Instâncias"

  2. Clique no nome da instância que precisa ser alterada.

  3. Na página Detalhes da instância, na seção Upgrade automático do ambiente, edite a programação.

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

Upgrade manual

É possível fazer upgrade manual das instâncias do Vertex AI Workbench que atendam aos requisitos.

Verificar se há uma versão mais recente do ambiente da instância

Para verificar se uma versão mais recente do ambiente da instância está disponível, acesse a instância no console do Google Cloud.

  1. No Console do Google Cloud, acesse a página Instâncias.

    Acesse "Instâncias"

  2. Clique no nome da instância que você quer verificar a disponibilidade de uma versão mais recente do ambiente.

  3. Na página Detalhes da instância, ao lado de Detalhes da VM, clique em Ver no Compute Engine.

    Se uma versão mais recente do ambiente estiver disponível, a mensagem "Esta instância precisa de upgrade" será exibida.

Fazer upgrade do ambiente da instância para uma versão mais recente

É possível fazer upgrade manual de uma instância do Vertex AI Workbench no Console do Google Cloud.

  1. No Console do Google Cloud, acesse a página Instâncias.

    Acesse "Instâncias"

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

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

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

  5. Verifique se você fez uma cópia dos dados na instância antes de continuar.

  6. Após o backup dos dados, clique em Fazer upgrade. O Vertex AI Workbench faz upgrade e inicia sua instância.

Reverter um upgrade

Para reverter um upgrade, siga estas etapas:

  1. No Console do Google Cloud, acesse a página Instâncias.

    Acesse "Instâncias"

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

  3. Na página Detalhes do notebook, em Histórico de upgrade, clique em Reverter.

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