Legacy-Instanz bei der Notebooks API registrieren

Auf dieser Seite wird erläutert, wie Sie eine veraltete nutzerverwaltete Notebookinstanz in der Notebooks API migrieren und registrieren. Mit der Compute Engine API erstellte Instanzen werden als Legacy-Instanzen bezeichnet. Legacy-Instanzen haben nicht die neuesten Updates für Funktionalität und Features.

Damit Sie die neuen Funktionen und Features der Notebooks API nutzen können, müssen Sie Ihre Legacy-Instanzen bei der Notebooks API registrieren. Prüfen Sie vor der Registrierung Ihrer Legacy-Instanzen, ob sie die Anforderungen erfüllen. Sie können Instanzen migrieren, die die Anforderungen nicht erfüllen.

Wenn Sie die Notebooks API aktivieren, bevor Sie Ihre Legacy-Instanzen registrieren, versucht der Notebooks API-Aktivierungsprozess, Ihre vorhandenen Legacy-Instanzen automatisch zu registrieren.

Anforderungen und Einschränkungen

Beachten Sie vor der Registrierung Ihrer Legacy-Instanzen bei der Notebooks API die folgenden Anforderungen und Einschränkungen.

Die Quell- und Zielzonen müssen übereinstimmen und eine gültige Zone für die Notebooks API sein.

Beispiel: Eine nutzerverwaltete Legacy-Notebookinstanz in us-west1-a verbleibt in us-west1-a, wenn sie bei der Notebooks API registriert wird. Eine nutzerverwaltete Legacy-Notebookinstanz in us-central1-f kann jedoch nicht bei der Notebooks API registriert werden, da us-central1-f keine gültige Zone für die Notebooks API ist.

Führen Sie den folgenden Befehl mithilfe des Google Cloud CLI in Ihrem bevorzugten Terminal oder in Cloud Shell aus, um eine Liste der gültigen Zonen für die Notebookinstanzen der Notebooks API abzurufen:
```
gcloud notebooks locations list
```
Wenn die Zone Ihrer Legacy-Instanzen keine gültige Zone für die Notebooks API ist, können Sie sich anSupport oder Ihrem Account Manager wenden, oder Sie können die Legacy-Instanz zu einer neuen, vom Nutzer verwalteten Notebook-Instanz migrieren.
Nur Instanzen mit zwei Laufwerken können alle nutzerverwalteten Notebook-Features verwenden.

Legacy-Instanzen mit einem einzelnen Laufwerk können nicht alle Features von nutzerverwalteten Notebooks verwenden, wie automatische Upgrades, auch wenn sie bei der Notebooks API registriert wurden. Damit Ihre Legacy-Instanz mit einem einzelnen Laufwerk alle verfügbaren Features nutzen kann, müssen Sie die Instanz mit einem einzelnen Laufwerk zu einer Instanz mit zwei Laufwerken migrieren.

Sie können Ihre Instanz mit einem einzelnen Laufwerk zu einer Instanz mit zwei Laufwerken als Teil Ihrer Migration von einer Legacy-Instanz zu einer bei der Notebooks API registrierten Instanz migrieren. Wenn Sie die Legacy-Instanz bereits bei der Notebooks API registriert haben, können Sie die Instanz trotzdem zu einer neuen Instanz mit zwei Laufwerken migrieren, um das Problem zu beheben.

Gehen Sie folgendermaßen vor, um die Anzahl der Laufwerke zu prüfen.
Console
1. Rufen Sie in der Google Cloud Console die Seite VM-Instanzen auf.
  
  Zu Seite „VM-Instanzen“
2. Suchen Sie Ihre aktuelle nutzerverwaltete Legacy-Notebookinstanz.
3. Klicken Sie auf den Instanznamen, um die Seite VM-Instanzdetails zu öffnen.
4. Prüfen Sie unter Bootlaufwerk und Zusätzliche Laufwerke, wie viele Laufwerke mit der VM verbunden sind.
gcloud
1. Geben Sie in Cloud Shell oder in einer Umgebung, in der Google Cloud-CLI installiert ist, die den folgenden Google Cloud-CLI-Befehl ein.
```
gcloud compute instances describe MY_INSTANCE_NAME
    --zone=MY_ZONE
```
  Dabei gilt:
  - MY_INSTANCE_NAME: durch den Namen der Instanz
  - MY_ZONE: die Zone Ihrer Instanz.
2. Sehen Sie sich die Informationen unter disks: an und prüfen Sie, wie viele Laufwerke mit der VM verbunden sind.

Legacy-Instanz zu einer neuen nutzerverwalteten Notebookinstanz migrieren

Wenn sich die Legacy-Instanz mit vom Nutzer verwalteten Notebooks in einer Zone befindet, die keine gültige Zone für die Notebooks API ist, oder wenn Sie von einer Instanz mit einem einzelnen Laufwerk zu einer Instanz mit zwei Laufwerken migrieren möchten, müssen Sie eine vom Nutzer verwaltete Notebookinstanz erstellen und Ihre Nutzerdaten von der Legacy-Instanz in die neue Instanz kopieren.

Führen Sie die folgenden Schritte aus, um eine nutzerverwaltete Notebookinstanz zu erstellen und Ihre Nutzerdaten von der Legacy-Instanz in die neue Instanz zu kopieren:

Wenn Sie eine ssh-Verbindung zu Ihrer Legacy-Instanz herstellen möchten, geben Sie in Cloud Shell oder in einer Umgebung, in der das Google Cloud CLI installiert ist, den folgenden Google Cloud CLI-Befehl ein:
```
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
```
Dabei gilt:
- MY_PROJECT_ID ist die ID Ihres Google Cloud-Projekts
- MY_ZONE: die Zone Ihrer Instanz.
- MY_INSTANCE: der Name Ihrer Instanz mit den relevanten Informationen.
Verwenden Sie gsutil, um den Inhalt der Legacy-Instanz in einen Cloud Storage-Bucket zu kopieren. Mit dem folgenden Beispielbefehl werden alle Notebook-Dateien (.ipynb) aus dem Standardverzeichnis /home/jupyter/ in ein Cloud Storage-Verzeichnis mit dem Namen my-bucket/legacy-notebooks kopiert.
```
gsutil cp -R /home/jupyter/*.ipynb gs://my-bucket/legacy-notebooks/
```
Erstellen Sie eine nutzerverwaltete Notebookinstanz mit denselben Hardwarespezifikationen wie bei der Legacy-Instanz. Sie können die Instanz mithilfe der Google Cloud Console oder der Google Cloud CLI erstellen.

In diesem Beispiel erstellt Vertex AI Workbench eine nutzerverwaltete Notebookinstanz new-notebook im Projekt example. Dabei wird das neueste TensorFlow 2-Image mit einem n1-standard-1-Maschinentyp in der Zone us-west1-a verwendet.

Geben Sie in Cloud Shell oder in einer Umgebung, in der Google Cloud-CLI installiert ist, die den folgenden Google Cloud-CLI-Befehl ein.
```
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
```
Die neue nutzerverwaltete Notebookinstanz hat zwei Laufwerke: ein Bootlaufwerk und ein Datenlaufwerk.
Stellen Sie mit ssh eine SSH-Verbindung zu der Instanz her, die Sie gerade erstellt haben.
Verwenden Sie gsutil, um den Inhalt der Legacy-Instanz aus dem Cloud Storage-Bucket in die neue Instanz zu kopieren. Mit dem folgenden Beispielbefehl werden alle Notebook-Dateien (.ipynb) aus dem Cloud Storage-Verzeichnis in das Verzeichnis /home/jupyter/ der neuen Instanz kopiert.
```
gsutil cp -R gs://my-bucket/legacy-notebooks/*.ipynb  /home/jupyter/
```
Öffnen Sie in der neuen nutzerverwalteten Notebookinstanz JupyterLab und prüfen Sie, ob die Nutzerdaten und Assets erfolgreich kopiert wurden.
Optional: Löschen Sie die Legacy-Instanz.

Legacy-Instanz bei der Notebooks API registrieren

Damit Sie die Notebooks API zur Verwaltung Ihrer Legacy-Instanzen verwenden können, müssen Sie Ihre Legacy-Instanzen bei der Notebooks API registrieren.

Wenn Sie die Notebooks API aktivieren, bevor Sie Ihre Legacy-Instanzen registrieren, versucht der Notebooks API-Aktivierungsprozess, Ihre vorhandenen Legacy-Instanzen automatisch zu registrieren. Wenn Sie Legacy-Instanzen erstellen, nachdem die Notebooks API aktiviert wurde, müssen Sie diese manuell mit einer der folgenden Methoden registrieren.

Verwenden Sie zur Registrierung Ihrer Legacy-Instanz bei der Notebooks API die Google Cloud Console oder die Notebooks API.

Console

Gehen Sie folgendermaßen vor, um die Option Alle registrieren in der Google Cloud Console zu verwenden:

Rufen Sie in der Google Cloud Console die Seite Nutzerverwaltete Notebooks auf.

Zu "Nutzerverwaltete Notebooks"
Wenn Sie eine oder mehrere nutzerverwaltete Legacy-Notebookinstanzen haben, wird eine Meldung angezeigt, dass Sie diese bei der Notebooks API registrieren müssen. Klicken Sie neben dieser Meldung auf Alle registrieren.
Wenn Sie keine nutzerverwalteten Legacy-Notebookinstanzen haben, die Notebooks API jedoch noch nicht aktiviert haben, klicken Sie auf Notebooks API aktivieren, um sicherzustellen, dass neue nutzerverwaltete Notebookinstanzen mit der Notebooks API erstellt werden.

Notebooks API

Verwenden Sie die von der Notebooks API bereitgestellte Methode register in Cloud Shell oder einer Umgebung, in der die Google Cloud CLI installiert ist und geben Sie den folgenden Google Cloud CLI-Befehl ein:

gcloud notebooks instances register MY_INSTANCE_NAME
    --location=MY_ZONE

Dabei gilt:

MY_INSTANCE_NAME: durch den Namen der Instanz
MY_ZONE: die Zone Ihrer Instanz.

Nächste Schritte

Nutzerverwaltete Notebookinstanz über benutzerdefinierten Container erstellen