Registrar uma instância legada com a API Notebooks

Nesta página, mostramos como migrar e registrar uma instância legada de notebooks gerenciados pelo usuário com a API Notebooks. As instâncias criadas com a API Compute Engine são chamadas de instâncias legadas. As instâncias legadas não têm as atualizações mais recentes de funcionalidade e recursos.

Para usar as novas funcionalidades e recursos disponíveis com a API Notebooks, é preciso registrar instâncias legadas na API Notebooks. Antes de registrar suas instâncias legadas, verifique se elas atendem aos requisitos. É possível migrar instâncias que não atendam aos requisitos.

Se você ativar a API Notebooks antes de registrar suas instâncias legadas, o processo de ativação da API Notebooks tentará registrar as instâncias legadas atuais automaticamente.

Requisitos e limitações

Antes de registrar suas instâncias legadas com a API Notebooks, considere os seguintes requisitos e limitações.

  • As zonas de origem e de destino precisam ser correspondentes e ser uma zona válida para a API Notebooks.

    Por exemplo, uma instância legada de notebooks gerenciados pelo usuário em us-west1-a continuará em us-west1-a quando for registrada com a API Notebooks. No entanto, uma instância de notebooks gerenciada pelo usuário legada em us-central1-f não será registrada com a API Notebooks porque us-central1-f não é uma zona válida para a API Notebooks.

    Para ver uma lista das zonas válidas para as instâncias de notebooks da API Notebooks, execute o seguinte comando usando a ferramenta de linha de comando no seu terminal preferido ou no Cloud Shell:

    gcloud notebooks locations list
    

    Se a zona da instância legada não for válida para a API Notebooks, entre em contato com aSuporte ou seu gerente de contas ou você pode migrar a instância legada para uma nova instância de notebooks gerenciados pelo usuário.

  • Somente instâncias de dois discos podem usar todos os recursos de notebooks gerenciados pelo usuário.

    As instâncias legadas de disco único não podem usar alguns recursos de notebooks gerenciados pelo usuário, como o upgrade automático, mesmo depois de serem registradas com a API Notebooks. Para permitir que a instância legada de disco único use todos os recursos disponíveis, migre a instância de disco único para a instância de disco duplo.

    A migração de uma instância de disco único para uma de dois discos faz parte da migração de uma instância legada para uma instância registrada na API Notebooks. Se você já registrou a instância legada com a API Notebooks, ainda poderá migrar a instância para uma nova instância de dois discos para resolver o problema.

    Para verificar o número de discos, conclua os passos a seguir.

    Console

    1. No console do Google Cloud, acesse a página Instâncias de VMs.

      Acessar instâncias de VM

    2. Encontre sua instância atual de notebooks gerenciados pelo usuário.

    3. Clique no nome da instância para abrir a página Detalhes da instância de VM.

    4. Nas seções Disco de inicialização e Discos adicionais, verifique quantos discos estão anexados à VM.

    gcloud

    1. No Cloud Shell ou em qualquer ambiente em que a Google Cloud CLI esteja instalada, insira os comandos da Google Cloud CLI a seguir.

      gcloud compute instances describe MY_INSTANCE_NAME \
          --zone=MY_ZONE
      

      Substitua:

      • MY_INSTANCE_NAME: o nome da instância
      • MY_ZONE: a zona da instância
    2. Analise as informações que aparecem após disks: e verifique quantos discos estão anexados à VM.

Migrar uma instância legada para uma nova instância de notebooks gerenciada pelo usuário

Se a instância de notebooks gerenciada pelo usuário legado estiver em uma zona que não é uma zona válida para a API Notebooks ou se quiser migrar de uma instância de disco único para uma de disco duplo, crie uma instância de notebooks gerenciada pelo usuário e copie os dados do usuário da instância legada para a nova instância.

Para criar uma instância de notebooks gerenciada pelo usuário e copiar os dados do usuário da instância legada para a nova instância, conclua as etapas a seguir:

  1. Para usar o ssh para se conectar à instância legada no Cloud Shell ou em qualquer ambiente em que a Google Cloud CLI esteja instalada, faça o seguinte: digite o seguinte comando da Google Cloud CLI:

    export PROJECT_ID="MY_PROJECT_ID"
    export ZONE="MY_ZONE"
    export INSTANCE_NAME="MY_INSTANCE"
    gcloud compute ssh \
        --project $PROJECT_ID \
        --zone $ZONE $INSTANCE_NAME \
        -- -L 8080:localhost:8080
    

    Substitua:

    • MY_PROJECT_ID: o ID do seu projeto do Google Cloud;
    • MY_ZONE: a zona da instância
    • MY_INSTANCE: o nome da instância com as informações relevantes.
  2. Para copiar o conteúdo da instância legada para um bucket do Cloud Storage, use gsutil. O comando de exemplo a seguir copia todos os arquivos do notebook (.ipynb) do diretório padrão /home/jupyter/ para um diretório do Cloud Storage chamado my-bucket/legacy-notebooks.

    gsutil cp -R /home/jupyter/*.ipynb gs://my-bucket/legacy-notebooks/
    
  3. Crie uma nova instância de notebooks gerenciados pelo usuário com as mesmas especificações de hardware da instância legada. É possível criar a instância usando o console do Google Cloud ou a CLI do Google Cloud.

    Neste exemplo, o Vertex AI Workbench cria uma nova instância de notebooks gerenciados pelo usuário chamada new-notebook no projeto example usando a imagem mais recente do TensorFlow 2, com um tipo de máquina n1-standard-1, na zona us-west1-a.

    No Cloud Shell ou em qualquer ambiente em que a Google Cloud CLI esteja instalada, insira os comandos da Google Cloud CLI a seguir.

    gcloud notebooks instances create new-notebook \
        --vm-image-project=example \
        --vm-image-family=tf-latest-cpu \
        --machine-type=n1-standard-1 \
        --location=us-west1-a
    

    A nova instância de notebooks gerenciados pelo usuário é de disco duplo. Ela tem um disco de inicialização e outro de dados.

  4. Use ssh para se conectar à instância de notebooks gerenciados pelo usuário que você acabou de criar.

  5. Para copiar o conteúdo da instância legada do bucket do Cloud Storage para a nova instância, use gsutil. O comando de exemplo a seguir copia todos os arquivos do notebook (.ipynb) do diretório do Cloud Storage para o diretório /home/jupyter/ da nova instância.

    gsutil cp -R gs://my-bucket/legacy-notebooks/*.ipynb  /home/jupyter/
    
  6. Na nova instância de notebooks, gerenciados pelo usuário, abra o JupyterLab e confirme se os dados e recursos do usuário foram copiados.

  7. Opcional: exclua a instância legada.

Registrar uma instância legada com a API Notebooks

Para usar a API Notebooks para gerenciar suas instâncias legadas, é preciso registrar as instâncias legadas com a API Notebooks.

Se você ativar a API Notebooks antes de registrar suas instâncias legadas, o processo de ativação da API Notebooks tentará registrar as instâncias legadas atuais automaticamente. Se você criar instâncias legadas depois que a API Notebooks estiver ativada, registre-as manualmente usando um dos métodos a seguir.

Para registrar sua instância legada com a API Notebooks, use o Console do Google Cloud ou a API Notebooks.

Console

Para usar a opção Registrar tudo no Console do Google Cloud, conclua as etapas a seguir.

  1. No Console do Google Cloud, acesse a página Notebooks gerenciados pelo usuário.

    Acesse Notebooks gerenciados pelo usuário

  2. Se você tiver uma ou mais instâncias legadas de notebooks gerenciados pelo usuário, uma mensagem será exibida indicando que você precisa registrá-las com a API Notebooks. Ao lado dessa mensagem, clique em Registrar todos.

  3. Se você não tiver nenhuma instância legada de notebooks gerenciados pelo usuário, mas ainda não ativou a API Notebooks, clique em Ativar API Notebooks para garantir que as novas instâncias de notebooks gerenciados pelo usuário sejam criadas com a API Notebooks.

API Notebooks

Para usar o método register fornecido pela API Notebooks, no Cloud Shell ou em qualquer ambiente em que a CLI do Google Cloud está instalado, digite o seguinte comando da CLI do Google Cloud:

gcloud notebooks instances register MY_INSTANCE_NAME \
    --location=MY_ZONE

Substitua:

  • MY_INSTANCE_NAME: o nome da instância
  • MY_ZONE: a zona da instância

A seguir