Fazer upgrade do ambiente de uma instância
As instâncias do Gemini Enterprise Agent Platform Workbench são instâncias de imagens de VM de aprendizado profundo 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 Workbench da Plataforma de Agentes.
Motivos do upgrade
Talvez você queira fazer upgrade do ambiente da instância do Workbench da Plataforma de Agentes 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 Agent Platform Workbench:
Upgrade automático: ative o upgrade automático ao criar uma instância do Agent Platform Workbench. Durante um período recorrente especificado, o Workbench do Agent Platform verifica se é possível fazer upgrade da instância. Em caso afirmativo, o Workbench do Agent Platform faz o upgrade da instância.
Upgrade manual: se uma instância atual do Workbench da Agent Platform atender aos requisitos para upgrade, será possível fazer upgrade da instância manualmente.
Requisitos e limitações
A compatibilidade com versões anteriores com o Agent Platform Workbench não é garantida. Faça uma cópia dos dados antes de fazer upgrade de uma instância do Agent Platform Workbench.
Para determinar se é possível fazer upgrade de uma instância específica do Workbench da Agent Platform, consulte os requisitos e limitações a seguir:
A API Notebooks precisa estar ativada no projetoGoogle Cloud da instância. Para mais informações, consulte Listar serviços ativados e Ativar uma API.
Se a instância do Workbench da Agent Platform for baseada em contêiner, o Workbench da Agent Platform 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
latestno 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 Workbench da Plataforma de Agentes.
Como o upgrade funciona
As instâncias do Workbench da Agent Platform que podem ser atualizadas 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 Agent Platform Workbench foram atualizados e preservados.
| Componente | Resultado do upgrade |
|---|---|
| Frameworks de machine learning | Com upgrade |
| Dados de machine learning | Preservado |
| Dependências pré-instaladas | Com upgrade |
| 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 Workbench da Agent Platform armazenam as bibliotecas pip e Conda no disco de inicialização, que é substituído 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 Agent Platform Workbench tem um número de versão do ambiente que pode ser verificado:
No console do Google Cloud , acesse a página Instâncias.
Na lista de instâncias, encontre o número da versão do ambiente da instância na coluna Versão.
O Workbench da Agent Platform atualiza os ambientes regularmente (consulte as Notas de lançamento), mas a cada versão lançada, nem todos os ambientes são atualizados. O Agent Platform 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 Workbench da Agent Platform, consulte Criar uma versão específica de uma instância do Workbench da Agent Platform.
Antes de começar
Antes de fazer upgrade, siga estas etapas.
Consulte asnotas da versão para ver as mudanças das novas versões.
Faça uma cópia dos dados como backup.
Upgrade automático
O Workbench da Agent Platform 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 Agent Platform 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 uma instância pode ser atualizada,
o Agent Platform Workbench usa o método da 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 Agent Platform Workbench usará um método de upgrade interno para fazer upgrade.
Criar uma instância do Agent Platform Workbench com o upgrade automático ativado
Para criar uma instância do Agent Platform 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 Google Cloud .
No console do Google Cloud , acesse a página Instâncias.
Clique em Criar.
Na caixa de diálogo Nova instância, clique em Opções avançadas.
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ê. Confira os locais disponíveis do Workbench da Agent Platform.
Na seção Integridade do sistema, selecione Upgrade automático do ambiente.
Escolha se você quer fazer upgrade do notebook semanal ou mensal.
No campo Weekday, selecione a opção que você quer.
No campo Hora, escolha uma hora do dia.
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 Agent Platform Workbench, siga estas etapas:
No console do Google Cloud , acesse a página Instâncias.
Clique no nome da instância que precisa ser alterada.
Na página Detalhes da instância, na seção Upgrade automático do ambiente, edite a programação.
Clique em Enviar para salvar as alterações.
Upgrade manual
É possível fazer upgrade manual das instâncias do Workbench da plataforma do agente 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 Google Cloud console.
No console do Google Cloud , acesse a página Instâncias.
Clique no nome da instância que você quer verificar a disponibilidade de uma versão mais recente do ambiente.
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 Agent Platform Workbench no console Google Cloud .
No console do Google Cloud , acesse a página Instâncias.
Se a instância não estiver em execução, inicie-a. O Workbench da Plataforma de Agentes só pode fazer upgrade de instâncias quando elas estão em execução.
Clique no nome da instância que você quer atualizar.
Na página Detalhes da instância, clique em Fazer upgrade.
Verifique se você fez uma cópia dos dados na instância antes de continuar.
Após o backup dos dados, clique em Fazer upgrade. O Workbench da Plataforma de Agentes faz upgrade e inicia sua instância.
Fazer upgrade.Reverter um upgrade
Para reverter um upgrade, siga estas etapas:
No console do Google Cloud , acesse a página Instâncias.
Clique no nome da instância que você quer reverter.
Na página Detalhes do notebook, em Histórico de upgrade, clique em Reverter.
O Agent Platform Workbench reverte sua instância para a versão anterior.