Von verwalteten Notebooks zu Vertex AI Workbench-Instanzen migrieren

Auf dieser Seite wird beschrieben, wie Sie von einer verwalteten Notebooks-Instanz zu einer Vertex AI Workbench-Instanz migrieren. Sie können die Migration mit dem Vertex AI Workbench-Migrationstool durchführen oder die Daten und Dateien der Instanz manuell migrieren.

Übersicht über das Migrationstool

Vertex AI Workbench bietet ein Migrationstool für die Migration von einer verwalteten Notebooks-Instanz zu einer Vertex AI Workbench-Instanz.

Das Migrationstool erstellt eine Vertex AI Workbench-Instanz mit einer Konfiguration, die der verwalteten Notebooks-Instanz, die Sie migrieren möchten, ähnelt. Beispielsweise erstellt das Migrationstool eine Instanz mit demselben oder einem ähnlichen Maschinentyp, der Netzwerkkonfiguration, den Einstellungen für das Herunterfahren bei Inaktivität sowie anderen Spezifikationen. Anschließend werden die Dateien auf dem Datenlaufwerk der verwalteten Notebooks-Instanz in die Vertex AI Workbench-Instanz kopiert.

Vertex AI Workbench löscht oder ändert Ihre verwaltete Notebooks-Instanz nicht. Nach der Migration können Sie sie also weiterhin verwenden. Wenn Sie die verwaltete Notebooks-Instanz nicht mehr benötigen, löschen Sie sie, um weitere Gebühren für diese Instanz zu vermeiden.

Abrechnung

Wenn Ihre verwaltete Notebooks-Instanz extrem nichtflüchtige Speicher verwendet, fallen für die Migration Kosten für E/A-Vorgänge an. Weitere Informationen finden Sie unter "Bereitgestellte Extrem-IOPS" im Abschnitt "Preise für Persistent Disk und Hyperdisk" der Laufwerkspreise.

Nach der Migration ist die verwaltete Notebooks-Instanz noch vorhanden und verursacht wie zuvor Gebühren. Wenn Sie die verwaltete Notebooks-Instanz nicht mehr benötigen, löschen Sie sie, um weitere Gebühren für diese Instanz zu vermeiden.

Standardverhalten des Migrationstools

Das Vertex AI Workbench-Migrationstool versucht, Ihre verwaltete Notebooks-Instanz zu einer Vertex AI Workbench-Instanz mit übereinstimmenden Spezifikationen zu migrieren. Wenn in Vertex AI Workbench-Instanzen eine Spezifikation in Ihrer verwalteten Notebooks-Instanz nicht verfügbar ist, verwendet Vertex AI Workbench eine Standardspezifikation, sofern möglich. Wenn das Migrationstool eine Spezifikation Ihrer verwalteten Notebookinstanz nicht migrieren kann, wird die Instanz nicht migriert.

In der folgenden Tabelle sind einige der wichtigsten Standardverhaltensweisen für die Migration des Migrationstools aufgeführt.

Kategorie	Spezifikation für verwaltete Notebooks	Migrationsergebnis
Betriebssystem	Jede Ubuntu-Version	Debian 11
Betriebssystem	Jede Debian-Version	Debian 11
Framework	Jede CUDA-Version	CUDA 11.3
	Jede Python-Version	Python 3.10
	Jede PyTorch-Version	PyTorch 1.13
	Jede TensorFlow-Versi	TensorFlow 2.11
	Jede R-Version	Nicht migriert; siehe Conda-Umgebung hinzufügen
	Jede lokale PySpark-Version	Nicht migriert; siehe Conda-Umgebung hinzufügen
	Jede XGBoost-Version	Nicht migriert; siehe Conda-Umgebung hinzufügen
	Jede Kaggle Python-Version	Nicht migriert; siehe Conda-Umgebung hinzufügen
	Jede Jax-Version	Nicht migriert; siehe Conda-Umgebung hinzufügen
	Jede Apache Beam-Version	Nicht migriert; siehe Conda-Umgebung hinzufügen
Maschinentyp	Ein unterstützter Maschinentyp	Identischer Maschinentyp
Maschinentyp	Ein nicht unterstützter Maschinentyp	`e2-standard-4`
Beschleuniger	Unterstützte Beschleuniger	Identische Beschleuniger
Beschleuniger	Nicht unterstützte Beschleuniger	Migration enthält keine Beschleuniger
Einstellung	Herunterfahren bei Inaktivität	Migriert
	Über Papierkorb löschen	Migriert
	`nbconvert`	Migriert
	Download von Dateien	Migriert
	Terminalzugriff	Migriert
Sonstiges	IAM-Berechtigungen (Identity and Access Management)	Migriert, aber möglicherweise sind neue Berechtigungen für die Verwendung der Vertex AI Workbench-Instanz erforderlich
	Zugriffsmodus	Migriert; Instanzen, die den JupyterLab-Zugriffsmodus für einen einzelnen Nutzer verwenden, müssen die Option `serviceAccount` angeben.
	Netzwerk	Migriert; Instanzen, die eine von Google verwaltete Virtual Private Cloud verwenden, müssen die Optionen `network` und `subnet` angeben.
	Post-Startskript	Bei Verwendung der Google Cloud Console wird die Instanz ohne das Post-Startscript migriert. Wenn Sie die Instanz mit dem Post-Startscript migrieren möchten, verwenden Sie die Google Cloud CLI oder die REST API, um die Option `PostStartupScriptOption` anzugeben.
	Dataproc-Hub	Nicht migriert; muss manuell migriert werden

Optionen angeben

In den folgenden Abschnitten werden Fälle beschrieben, in denen die Angabe einer Option zum Migrieren Ihrer verwalteten Notebooks-Instanz zu einer Vertex AI Workbench-Instanz erforderlich ist.

Instanzen, die den Zugriffsmodus für einen einzelnen Nutzer verwenden

Verwaltete Notebooks-Instanzen, die den Zugriffsmodus für einen einzelnen Nutzer verwenden, müssen zu einer Instanz mit der angegebenen Option serviceAccount migriert werden. Die Vertex AI Workbench-Instanz, zu der Sie migrieren, beschränkt den Zugriff auf JupyterLab auf den einzelnen Nutzer, verwendet jedoch ein Dienstkonto für die Interaktion mit Google Cloud-Diensten und -APIs.

Instanzen, die eine von Google verwaltete VPC verwenden

Verwaltete Notebooks-Instanzen, die eine von Google verwaltete VPC verwenden, müssen zu einer Instanz migriert werden, für die die Optionen network und subnet angegeben sind. Die Option zur Verwendung einer von Google verwalteten VPC wird in Vertex AI Workbench-Instanzen nicht unterstützt. Daher muss ein anderes Netzwerk angegeben werden.

Instanzen, die ein Post-Startscript verwenden

Verwaltete Notebooks-Instanzen, die ein Post-Startscript verwenden, müssen zu einer Instanz mit der angegebenen PostStartupScriptOption-Option migriert werden. Verwenden Sie diese Option, um anzugeben, ob Sie das Post-Startscript in der neuen Vertex AI Workbench-Instanz überspringen oder noch einmal ausführen möchten.

Die Angabe der Option PostStartupScriptOption wird in der Google Cloud Console nicht unterstützt. Wenn Sie Option PostStartupScriptOption bei der Migration Ihrer verwalteten Notebooks-Instanz angeben möchten, müssen Sie die Google Cloud CLI oder die REST API verwenden.

Hinweise

Melden Sie sich bei Ihrem Google Cloud-Konto an. Wenn Sie mit Google Cloud noch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

Zur Projektauswahl

Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.

Notebooks API aktivieren.

Aktivieren Sie die API

Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

Zur Projektauswahl

Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.

Notebooks API aktivieren.

Aktivieren Sie die API

Falls noch nicht geschehen, erstellen Sie eine verwaltete Notebookinstanz.

Erforderliche Rollen

Um sicherzugehen, dass Ihr Nutzerkonto die erforderlichen Berechtigungen hat, um eine verwaltete Notebooks-Instanz zu einer Vertex AI Workbench-Instanz zu migrieren, bitten Sie Ihren Administrator, Ihrem Nutzerkonto die IAM-Rolle "Notebooks-Ausführer" (roles/notebooks.runner) für das Projekt zu erteilen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Migrieren einer verwalteten Notebooks-Instanz zu einer Vertex AI Workbench-Instanz erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um eine verwaltete Notebooks-Instanz zu einer Vertex AI Workbench-Instanz zu migrieren:

notebooks.runtimes.create
notebooks.runtimes.get

Ihr Administrator kann Ihrem Nutzerkonto möglicherweise diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erteilen.

Prüfung vor der Migration

Prüfen Sie, bevor Sie migrieren, die Voraussetzungen für Ihre Migration der verwalteten Notebooks-Instanz. Listen Sie dazu Ihre Instanzen auf und prüfen Sie die Ausgabe auf jedwede Warnungen oder Fehler bezüglich der Migration.

Instanzen auflisten

Verwenden Sie die Methode projects.locations.runtimes.list mit dem Filter migrated:false, um die noch nicht migrierten verwalteten Notebooks-Instanzen aufzulisten. Sie können sie mithilfe der gcloud CLI oder der REST API auflisten:

gcloud

Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

PROJECT_ID: Ihre Projekt-ID
LOCATION: Die Region, in der sich Ihre verwaltete Notebooks-Instanz befindet, oder - verwenden, um Instanzen aus allen Regionen aufzulisten

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

gcloud notebooks runtimes list --project=PROJECT_ID \
    --location=LOCATION --filter=migrated:false --format=default

Windows (PowerShell)

gcloud notebooks runtimes list --project=PROJECT_ID `
    --location=LOCATION --filter=migrated:false --format=default

Windows (cmd.exe)

gcloud notebooks runtimes list --project=PROJECT_ID ^
    --location=LOCATION --filter=migrated:false --format=default

REST

Ersetzen Sie dabei folgende Werte für die Anfragedaten:

PROJECT_ID: Ihre Projekt-ID
LOCATION: Die Region, in der sich Ihre verwaltete Notebooks-Instanz befindet, oder - verwenden, um Instanzen aus allen Regionen aufzulisten

HTTP-Methode und URL:

GET https://notebooks.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/runtimes?filter=migrated:false

Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

curl

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://notebooks.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/runtimes?filter=migrated:false"

PowerShell

Führen Sie folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://notebooks.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/runtimes?filter=migrated:false" | Select-Object -Expand Content

Ausgabe auf Warnungen oder Fehler prüfen

Wenn Warnungen oder Fehler bezüglich der Migration erkannt werden, enthält die Ausgabe der Methode projects.locations.runtimes.list diese Informationen.

Warnungen werden angezeigt, wenn bestimmte Komponenten in der Konfiguration Ihrer verwalteten Notebooks-Instanz nicht zur selben Spezifikation in einer Vertex AI Workbench-Instanz migriert werden. Wenn Ihre verwaltete Notebooks-Instanz beispielsweise einen nicht unterstützten Beschleuniger verwendet, wird in der Ausgabe eine Warnung angezeigt. In diesem Fall wird die Instanz ohne Beschleuniger migriert. Sie können Beschleuniger nach der Migration anhängen. Überprüfen Sie die Warnungen in der Ausgabe, berücksichtigen Sie das Standardverhalten des Migrationstools und prüfen Sie, ob das Migrationstool für Ihre Migration akzeptabel ist.

Ein oder mehrere Fehler in der Ausgabe bedeuten, dass Sie die verwaltete Notebooks-Instanz nicht mit dem Migrationstool migrieren können. Sie müssen die Instanz manuell migrieren.

Weitere Informationen zu Warnungen und Fehlern bezüglich Migrationen finden Sie unter Warnungen und Fehler in der Dokumentation zu RuntimeMigrationEligibility.

Mit dem Migrationstool migrieren

Sie können Ihre verwaltete Notebooks-Instanz mithilfe der Google Cloud Console, der gcloud CLI oder der REST API migrieren.

Console

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

Zu "Verwaltete Notebooks"
Klicken Sie auf die Schaltfläche Migrieren. Die Seite Verwaltete Notebooks zu Instanzen migrieren wird geöffnet.
Wenn Sie Instanzen migrieren möchten, für die keine Optionen angegeben sind, klicken Sie auf den Tab Bereit, wählen Sie die zu migrierenden Instanzen aus und klicken Sie dann auf Migrieren.
Klicken Sie zum Migrieren von Instanzen, für die Optionen angegeben werden müssen, auf den Tab Eingabe erforderlich, wählen Sie die zu migrierenden Instanzen aus und klicken Sie dann auf Migrieren.
1. Geben Sie im Dialogfeld Eingabe für Migration bereitstellen ein Netzwerk und ein Dienstkonto an, das für die neuen ausgewählten Vertex AI Workbench-Instanzen verwendet werden soll.
2. Klicken Sie auf Senden.
Rufen Sie nach Abschluss der Migrationen die Seite Instanzen auf, um Ihre neuen Vertex AI Workbench-Instanzen anzusehen.

Zur Seite „VM-Instanzen“

gcloud

Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

PROJECT_ID: Ihre Projekt-ID
LOCATION: Die Region, in der sich Ihre verwaltete Notebooks-Instanz befindet
RUNTIME_ID: Die ID der verwalteten Notebooks-Instanz
NETWORK: Optional: Das Netzwerk, in das Sie die Instanz migrieren möchten.
SUBNET: Optional: Das Subnetz, in das Sie die Instanz migrieren möchten
SERVICE_ACCOUNT: Optional: Die E-Mail-Adresse des Dienstkontos, das Sie nutzen möchten
POST_STARTUP_SCRIPT_OPTION: Optional: Eine der Post-Startscript-Optionen

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

gcloud notebooks runtimes migrate RUNTIME_ID \
    --project=PROJECT_ID \
    --location=LOCATION \
    --network=NETWORK \
    --subnet=SUBNET \
    --service-account=SERVICE_ACCOUNT \
    --post-startup-script-option=POST_STARTUP_SCRIPT_OPTION

Windows (PowerShell)

gcloud notebooks runtimes migrate RUNTIME_ID `
    --project=PROJECT_ID `
    --location=LOCATION `
    --network=NETWORK `
    --subnet=SUBNET `
    --service-account=SERVICE_ACCOUNT `
    --post-startup-script-option=POST_STARTUP_SCRIPT_OPTION

Windows (cmd.exe)

gcloud notebooks runtimes migrate RUNTIME_ID ^
    --project=PROJECT_ID ^
    --location=LOCATION ^
    --network=NETWORK ^
    --subnet=SUBNET ^
    --service-account=SERVICE_ACCOUNT ^
    --post-startup-script-option=POST_STARTUP_SCRIPT_OPTION

REST

Ersetzen Sie dabei folgende Werte für die Anfragedaten:

PROJECT_ID: Ihre Projekt-ID
LOCATION: Die Region, in der sich Ihre verwaltete Notebooks-Instanz befindet
RUNTIME_ID: Die ID der verwalteten Notebooks-Instanz
NETWORK: Optional: Das Netzwerk, in das Sie die Instanz migrieren möchten.
SUBNET: Optional: Das Subnetz, in das Sie die Instanz migrieren möchten
SERVICE_ACCOUNT: Optional: Die E-Mail-Adresse des Dienstkontos, das Sie nutzen möchten
POST_STARTUP_SCRIPT_OPTION: Optional: Eine der Post-Startscript-Optionen

HTTP-Methode und URL:

POST https://notebooks.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/runtimes/RUNTIME_ID:migrate

JSON-Text der Anfrage:

{
  "network": NETWORK,
  "subnet": SUBNET,
  "serviceAccount": SERVICE_ACCOUNT_EMAIL_ADDRESS,
  "postStartupScriptOption": (POST_STARTUP_SCRIPT_OPTION)
}

Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

curl

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    -d @request.json \
    "https://notebooks.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/runtimes/RUNTIME_ID:migrate"

PowerShell

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://notebooks.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/runtimes/RUNTIME_ID:migrate" | Select-Object -Expand Content

Manuell migrieren

Um Ihre Instanz manuell zu einer Vertex AI Workbench-Instanz zu migrieren, verwenden Sie die folgenden Methoden:

Cloud Storage und das Terminal verwenden: Kopieren Sie Ihre Daten und Dateien in Cloud Storage und dann über das Terminal in eine andere Instanz.
GitHub verwenden: Kopieren Sie Ihre Daten und Dateien mithilfe der Git-Erweiterung für JupyterLab in ein GitHub-Repository.

In dieser Anleitung wird beschrieben, wie Sie Daten und Dateien mithilfe von Cloud Storage und dem Terminal migrieren.

Voraussetzungen

Sie müssen Terminalzugriff auf Ihre verwaltete Notebookinstanz haben. Der Terminalzugriff wird beim Erstellen einer Instanz manuell festgelegt. Die Einstellung für den Terminalzugriff kann nach dem Erstellen der Instanz nicht mehr geändert werden.

Manuell mit Cloud Storage und dem Terminal migrieren

So migrieren Sie Daten und Dateien mithilfe von Cloud Storage und dem Terminal zu einer neuen Vertex AI Workbench-Instanz:

Erstellen Sie einen Cloud Storage-Bucket in dem Projekt, in dem sich Ihre verwaltete Notebookinstanz befindet.
Erstellen Sie in demselben Projekt eine Vertex AI Workbench-Instanz, in die Sie Ihre Daten migrieren möchten. Wenn Sie diese Instanz erstellen:
- Aktivieren Sie den Terminalzugriff.
- Geben Sie den Maschinentyp, das Netzwerk und andere Merkmale an, die Ihren Anforderungen entsprechen.
Wählen Sie auf der JupyterLab-Benutzeroberfläche Ihrer verwalteten Notebookinstanz Datei > Neu > Terminal aus, um ein Terminalfenster zu öffnen.
Verwenden Sie gsutil tool, um Ihre Nutzerdaten in einen Cloud Storage-Bucket zu kopieren. Mit dem folgenden Beispielbefehl werden alle Dateien aus dem Verzeichnis /home/jupyter/ Ihrer Instanz in ein Verzeichnis in einem Cloud Storage-Bucket kopiert.
```
gsutil cp -R /home/jupyter/* gs://BUCKET_NAMEPATH
```
Ersetzen Sie Folgendes:
- BUCKET_NAME: Der Name Ihres Cloud Storage-Buckets
- PATH: Der Pfad zu dem Verzeichnis, in das Sie Ihre Dateien kopieren möchten, z. B.: /copy/jupyter/
Wählen Sie auf der JupyterLab-Benutzeroberfläche Ihrer neuen Vertex AI Workbench-Instanz Datei > Neu > Terminal aus, um ein Terminalfenster zu öffnen.
Verwenden Sie das gsutil tool, um Ihre Daten in die neue Instanz zu kopieren. Mit dem folgenden Beispielbefehl werden alle Dateien aus einem Cloud Storage-Verzeichnis in das Verzeichnis /home/jupyter/ Ihrer neuen Instanz kopiert.
```
gsutil cp gs://BUCKET_NAMEPATH* /home/jupyter/
```

Migration prüfen

Nach der Migration funktioniert die ursprüngliche verwaltete Notebooks-Instanz weiterhin wie zuvor. Bestätigen Sie, dass die Migration erfolgreich war, bevor Sie die ursprüngliche Instanz löschen.

Verwaltete Notebooks-Instanz löschen

Wenn Sie die verwaltete Notebooks-Instanz, von der Sie migriert haben, nicht benötigen, löschen Sie sie, um weitere Gebühren für diese Instanz zu vermeiden.

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

Zu "Verwaltete Notebooks"
Wählen Sie die Tabellen aus, die Sie löschen möchten.
Klicken Sie auf Löschen. Je nach Größe des Fensters befindet sich die Schaltfläche Löschen möglicherweise im Optionsmenü .
Klicken Sie zur Bestätigung auf Löschen.

Fehlerbehebung

Methoden zum Diagnostizieren und Beheben von Migrationsproblemen finden Sie unter Fehlerbehebung bei Vertex AI Workbench.

Nächste Schritte

Weitere Informationen zu Vertex AI Workbench-Instanzen