Von nutzerverwalteten Notebooks zu Vertex AI Workbench-Instanzen migrieren

Auf dieser Seite wird beschrieben, wie Sie von einer nutzerverwalteten 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 nutzerverwalteten Notebooks-Instanz zu einer Vertex AI Workbench-Instanz.

Das Migrationstool erstellt eine Vertex AI Workbench-Instanz mit einer Konfiguration, die der nutzerverwalteten Notebookinstanz, 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 nutzerverwalteten Notebookinstanz in die Vertex AI Workbench-Instanz kopiert.

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

Abrechnung

Wenn Ihre nutzerverwaltete Notebookinstanz extrem nichtflüchtige Speicher verwendet, fallen bei der Migration Gebühren für E/A-Vorgänge an. Weitere Informationen finden Sie im Abschnitt zu Preisen für nichtflüchtigen Speicher und Hyperdisks auf der Seite „Laufwerkspreise“ unter „Bereitgestellte Extrem-IOPS“.

Nach der Migration ist die nutzerverwaltete Notebookinstanz noch vorhanden und verursacht wie zuvor Gebühren. Wenn Sie die nutzerverwaltete Notebookinstanz 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 nutzerverwaltete Notebookinstanz mit einer übereinstimmenden Spezifikation zu einer Vertex AI Workbench-Instanz zu migrieren. Wenn in Ihrer nutzerverwalteten Notebookinstanz keine Spezifikation in Vertex AI Workbench-Instanzen verfügbar ist, verwendet Vertex AI Workbench nach Möglichkeit eine Standardspezifikation. Wenn das Migrationstool keine Spezifikation Ihrer nutzerverwalteten Notebookinstanz migrieren kann, wird die Instanz nicht migriert.

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

Post-Startscript angeben

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 bei der Migration Ihrer nutzerverwalteten Notebookinstanz die Option PostStartupScriptOption angeben möchten, müssen Sie die Google Cloud CLI oder die REST API verwenden.

Hinweise

1. 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.

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

   Zur Projektauswahl

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

4. Notebooks API aktivieren.

   Aktivieren Sie die API

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

   Zur Projektauswahl

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

7. Notebooks API aktivieren.

   Aktivieren Sie die API

8. Falls noch nicht geschehen, erstellen Sie eine nutzerverwaltete Notebookinstanz.

Erforderliche Rollen

Um sicherzugehen, dass Ihr Nutzerkonto die erforderlichen Berechtigungen hat, um eine nutzerverwaltete 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 nutzerverwalteten Notebookinstanz zu einer Vertex AI Workbench-Instanz erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:

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

Vor der Migration prüfen

Prüfen Sie vor der Migration die Migrationsberechtigung Ihrer nutzerverwalteten Notebookinstanz. Listen Sie dazu Ihre Instanzen auf und prüfen Sie die Ausgabe auf Warnungen oder Fehler bei der Migration.

Instanzen auflisten

Verwenden Sie die Methode projects.locations.instances.list mit dem Filter migrated:false, um die nutzerverwalteten Notebookinstanzen aufzulisten, die noch nicht migriert wurden. Sie können sie mithilfe der gcloud CLI oder der REST API auflisten:

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

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

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

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

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

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "http://notebooks.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances?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.instances.list diese Informationen.

Warnungen werden angezeigt, wenn bestimmte Komponenten in der Konfiguration Ihrer nutzerverwalteten Notebookinstanz nicht zur selben Spezifikation in einer Vertex AI Workbench-Instanz migriert werden. Wenn Ihre nutzerverwaltete Notebookinstanz 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 nutzerverwaltete Notebookinstanz 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 InstanceMigrationEligibility.

Mit dem Migrationstool migrieren

Sie können Ihre nutzerverwaltete Notebookinstanz mithilfe der Google Cloud Console, der gcloud CLI oder der REST API migrieren.

gcloud notebooks instances migrate RUNTIME_ID \
    --project=PROJECT_ID \
    --location=LOCATION \
    --post-startup-script-option=POST_STARTUP_SCRIPT_OPTION

gcloud notebooks instances migrate RUNTIME_ID `
    --project=PROJECT_ID `
    --location=LOCATION `
    --post-startup-script-option=POST_STARTUP_SCRIPT_OPTION

gcloud notebooks instances migrate RUNTIME_ID ^
    --project=PROJECT_ID ^
    --location=LOCATION ^
    --post-startup-script-option=POST_STARTUP_SCRIPT_OPTION

POST http://notebooks.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID:migrate

{
  "postStartupScriptOption": (POST_STARTUP_SCRIPT_OPTION)
}

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

$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 "http://notebooks.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_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 vom Nutzer 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:

1. Erstellen Sie einen Cloud Storage-Bucket in dem Projekt, in dem sich Ihre nutzerverwaltete Notebookinstanz befindet.

2. 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.

3. Wählen Sie auf der JupyterLab-Benutzeroberfläche Ihrer nutzerverwalteten Notebookinstanz Datei > Neu > Terminal aus, um ein Terminalfenster zu öffnen.

4. 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/

5. Wählen Sie auf der JupyterLab-Benutzeroberfläche Ihrer neuen Vertex AI Workbench-Instanz Datei > Neu > Terminal aus, um ein Terminalfenster zu öffnen.

6. 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 nutzerverwaltete Notebookinstanz wie zuvor. Bestätigen Sie, dass die Migration erfolgreich war, bevor Sie die ursprüngliche Instanz löschen.

Nutzerverwaltete Notebook-Instanz löschen

Wenn Sie die nutzerverwaltete Notebookinstanz, aus der Sie migriert haben, nicht benötigen, löschen Sie sie, um weitere Gebühren für diese Instanz zu vermeiden.

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

   Zu "Nutzerverwaltete Notebooks"

2. Wählen Sie die Instanz aus, die Sie löschen möchten.

3. Klicken Sie auf delete Löschen. Je nach Größe des Fensters befindet sich die Schaltfläche Löschen möglicherweise im Optionsmenü more_vert.

4. 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