Migrar os dados para uma nova instância de notebooks gerenciados pelo usuário

Nesta página, descrevemos como migrar dados e arquivos de uma instância de notebooks gerenciados para uma nova.

Quando migrar

É possível migrar para uma nova instância de notebooks gerenciados por qualquer um dos motivos a seguir:

Para usar os novos recursos disponíveis apenas em uma versão mais recente.
Para se beneficiar das atualizações de framework, de pacote e de bug que foram implementadas em uma versão mais recente.
Se não for possível fazer upgrade do ambiente de uma instância atual. Consulte os requisitos para fazer upgrade do ambiente de uma instância de notebook gerenciada.

Opções de migração

Para migrar dados e arquivos de uma instância de notebooks gerenciados para outra, considere usar os seguintes métodos:

Usar o GitHub: copie seus dados e arquivos para um repositório do GitHub usando a extensão Git para JupyterLab.
Use o Cloud Storage e o terminal: copie seus dados e arquivos para o Cloud Storage e, em seguida, para outra instância usando o terminal.
Use o Cloud Storage nos notebooks do JupyterLab: copie seus dados e arquivos para o Cloud Storage e depois para outra instância executando comandos nas células de notebook das respectivas instâncias.

Neste guia, descrevemos como migrar dados e arquivos usando o Cloud Storage e o terminal.

Requisitos

Você precisa ter acesso ao terminal para a instância de notebooks gerenciados. O acesso ao terminal é definido manualmente durante a criação de uma instância. Não é possível alterar a configuração de acesso ao terminal após a criação da instância.

Antes de começar

Crie um bucket do Cloud Storage no mesmo projeto em que a instância de notebooks gerenciados pelo usuário está localizada.

Migrar os dados para uma nova instância de notebooks gerenciados pelo usuário

Para migrar dados e arquivos para uma nova instância de notebooks gerenciados usando o Cloud Storage e o terminal, conclua as etapas a seguir.

Na interface do JupyterLab da instância gerenciada pelos usuários, selecione File > New > Terminal para abrir uma janela de terminal.
Use a gcloud CLI para copiar os dados do usuário para um bucket do Cloud Storage. O exemplo de comando a seguir copia todos os arquivos do diretório /home/jupyter/ da instância para um diretório em um bucket do Cloud Storage.
```
gcloud storage cp /home/jupyter/* gs://BUCKET_NAMEPATH --recursive
```
Substitua:
- BUCKET_NAME: o nome do bucket do Cloud Storage
- PATH: o caminho para o diretório em que você quer copiar os arquivos, por exemplo: /copy/jupyter/
Criar uma instância de notebooks gerenciados.
Na interface da nova instância do Notebooks gerenciada pelo novo usuário do JupyterLab, selecione Arquivo > Novo > Terminal para abrir uma janela de terminal.
Use a gcloud CLI para restaurar os dados na nova instância. O comando de exemplo a seguir copia todos os arquivos de um diretório do Cloud Storage para o diretório /home/jupyter/ da sua nova instância.
```
gcloud storage cp gs://BUCKET_NAMEPATH* /home/jupyter/
```

A seguir

Saiba como fazer upgrade manual do ambiente de instâncias de notebooks gerenciados.