Registe uma instância antiga com a API Notebooks

Esta página mostra como migrar e registar uma instância de blocos de notas geridos pelo utilizador antiga com a API Notebooks. As instâncias criadas através da API Compute Engine são denominadas instâncias antigas. As instâncias antigas não têm as atualizações mais recentes de funcionalidades.

Para usar a nova funcionalidade e as funcionalidades disponíveis com a API Notebooks, tem de registar as suas instâncias antigas na API Notebooks. Antes de registar as suas instâncias antigas, verifique se cumprem os requisitos. Pode migrate instâncias que não cumprem os requisitos.

Se ativar a Notebooks API antes de registar as suas instâncias antigas, o processo de ativação da Notebooks API tenta registar automaticamente as suas instâncias antigas existentes.

Requisitos e limitações

Antes de registar as suas instâncias antigas na Notebooks API, considere os seguintes requisitos e limitações.

  • As zonas de origem e de destino têm de corresponder e ser uma zona válida para a API Notebooks.

    Por exemplo, uma instância de blocos de notas gerida pelo utilizador antiga em us-west1-a permanece em us-west1-a quando é registada na API Notebooks. No entanto, uma instância de notebooks geridos pelo utilizador antiga em us-central1-f não é registada na API Notebooks porque us-central1-f não é uma zona válida para a API Notebooks.

    Para obter uma lista das zonas válidas para as instâncias de blocos de notas da API Notebooks, execute o seguinte comando através da CLI do Google Cloud no seu terminal preferido ou na Cloud Shell:

    gcloud notebooks locations list

    Se a zona da sua instância antiga não for uma zona válida para a API Notebooks, pode contactar o apoio técnico ou o seu gestor de conta, ou pode migrar a instância antiga para uma nova instância de notebooks geridos pelo utilizador.

  • Apenas as instâncias com dois discos podem usar todas as funcionalidades dos blocos de notas geridos pelo utilizador.

    As instâncias antigas de disco único não podem usar algumas funcionalidades dos blocos de notas geridos pelo utilizador, como a atualização automática, mesmo depois de serem registadas na Notebooks API. Para permitir que a sua instância antiga com um único disco use todas as funcionalidades disponíveis, tem de migrar a instância com um único disco para uma instância com dois discos.

    Pode migrar a sua instância de disco único para uma instância de disco duplo como parte da migração de uma instância antiga para uma instância registada na API Notebooks. Se já registou a instância antiga na API Notebooks, ainda pode migrar a instância para uma instância de disco duplo nova para resolver o problema.

    Para validar o número de discos, conclua os seguintes passos.

    Consola

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

      Aceder às instâncias de VM

    2. Encontre a sua instância atual de blocos de notas geridos pelo utilizador antigos.

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

    4. Nas secções disco de arranque e discos adicionais, verifique quantos discos estão associados à VM.

    gcloud

    1. No Cloud Shell ou em qualquer ambiente onde a CLI do Google Cloud esteja instalada, introduza o seguinte comando da CLI do Google Cloud:

      gcloud compute instances describe MY_INSTANCE_NAME \
    --zone=MY_ZONE

      Substitua o seguinte:

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

    2. Reveja as informações que se seguem a disks: e verifique quantos discos estão associados à VM.

Migre uma instância antiga para uma nova instância de blocos de notas geridos pelo utilizador

Se a sua instância de blocos de notas geridos pelo utilizador antiga estiver numa zona que não seja uma zona válida para a API Notebooks ou se quiser migrar de uma instância de disco único para uma instância de disco duplo, tem de criar uma instância de blocos de notas geridos pelo utilizador e copiar os seus dados de utilizador da instância antiga para a nova instância.

Para criar uma instância de blocos de notas gerida pelo utilizador e copiar os dados do utilizador da instância antiga para a nova instância, conclua os seguintes passos:

  1. Para usar o ssh para estabelecer ligação à sua instância antiga, no Cloud Shell ou em qualquer ambiente onde a CLI do Google Cloud esteja instalada, introduza o seguinte comando da CLI do Google Cloud:

    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 o seguinte:

    • MY_PROJECT_ID: o ID do seu Google Cloud projeto
    • MY_ZONE: a zona da sua instância
    • MY_INSTANCE: o nome da sua instância com as informações relevantes.

  2. Para copiar o conteúdo da instância antiga para um contentor do Cloud Storage, use gcloud storage. O comando de exemplo seguinte copia todos os ficheiros do bloco de notas (.ipynb) do diretório predefinido /home/jupyter/ para um diretório do Cloud Storage denominado my-bucket/legacy-notebooks.

    gcloud storage cp /home/jupyter/*.ipynb gs://my-bucket/legacy-notebooks/ --recursive

  3. Crie uma instância de blocos de notas gerida pelo utilizador com as mesmas especificações de hardware que a instância antiga. Pode criar a instância através da Google Cloud consola ou da CLI do Google Cloud.

    Neste exemplo, o Vertex AI Workbench cria uma instância de notebooks geridos pelo utilizador denominada new-notebook no projeto example com 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 onde a CLI do Google Cloud esteja instalada, introduza o seguinte comando da CLI do Google Cloud:

    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 blocos de notas geridos pelo utilizador tem dois discos. Tem um disco de arranque e um disco de dados.

  4. Use ssh para estabelecer ligação à instância de blocos de notas geridos pelo utilizador que acabou de criar.

  5. Para copiar o conteúdo da instância antiga do contentor do Cloud Storage para a nova instância, use gcloud storage. O comando de exemplo seguinte copia todos os ficheiros de notebook (.ipynb) do diretório do Cloud Storage para o diretório /home/jupyter/ da nova instância.

    gcloud storage cp gs://my-bucket/legacy-notebooks/*.ipynb  /home/jupyter/ --recursive

  6. Na nova instância de blocos de notas gerida pelo utilizador, abra o JupyterLab e confirme que os dados e os recursos do utilizador foram copiados com êxito.

  7. Opcional: elimine a instância antiga.

Registe uma instância antiga com a API Notebooks

Para usar a API Notebooks para gerir as suas instâncias antigas, tem de registar as suas instâncias antigas na API Notebooks.

Se ativar a Notebooks API antes de registar as suas instâncias antigas, o processo de ativação da Notebooks API tenta registar automaticamente as suas instâncias antigas existentes. Se criar instâncias antigas depois de a Notebooks API ser ativada, tem de as registar manualmente através de um dos seguintes métodos.

Para registar a sua instância antiga na API Notebooks, pode usar a Google Cloud consola ou a API Notebooks.

Consola

Para usar a opção Registar tudo na Google Cloud consola, conclua os seguintes passos:

  1. Na Google Cloud consola, aceda à página Blocos de notas geridos pelo utilizador.

    Aceda aos blocos de notas geridos pelo utilizador

  2. Se tiver uma ou mais instâncias de notebooks geridas pelo utilizador antigas, é apresentada uma mensagem a indicar que tem de as registar na API Notebooks. Junto a esta mensagem, clique em Registar tudo.

  3. Se não tiver instâncias de blocos de notas geridas pelo utilizador antigas, mas ainda não tiver ativado a API Notebooks, clique em Ativar API Notebooks para garantir que as novas instâncias de blocos de notas geridas pelo utilizador são criadas através da API Notebooks.

API Notebooks

Para usar o método register fornecido pela API Notebooks, no Cloud Shell ou em qualquer ambiente onde a CLI Google Cloud esteja instalada, introduza o seguinte comando da CLI Google Cloud:

gcloud notebooks instances register MY_INSTANCE_NAME \
    --location=MY_ZONE

Substitua o seguinte:

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

O que se segue?