Bestimmte Version einer nutzerverwalteten Notebookinstanz erstellen

Bestimmte Version einer nutzerverwalteten Notebookinstanz erstellen

Von Nutzern verwaltete Vertex AI Workbench-Notebooks wurden verworfen. Am 14. April 2025 wurde die Unterstützung für nutzerverwaltete Notebooks eingestellt und die Möglichkeit zum Erstellen von nutzerverwalteten Notebookinstanzen wurde entfernt. Vorhandene Instanzen funktionieren bis zum 30. März 2026 weiterhin, aber Patches, Updates und Upgrades sind nicht verfügbar. Um Vertex AI Workbench weiterhin zu verwenden, empfehlen wir Ihnen, Ihre nutzerverwalteten Notebooks-Instanzen zu Vertex AI Workbench-Instanzen zu migrieren.

Auf dieser Seite wird beschrieben, wie Sie eine nutzerverwaltete Notebookinstanz basierend auf einer bestimmten Version von Deep Learning VM Images erstellen können.

Warum Sie eine Bestimmte Version erstellen sollten

Damit Ihre vom Nutzer verwaltete Notebooks-Instanz Software hat, die mit Ihrem Code oder Ihrer Anwendung kompatibel ist, sollten Sie eine bestimmte Version erstellen.

Nutzerverwaltete Notebookinstanzen werden mit Deep Learning VM Images erstellt. Deep Learning VM Images werden häufig aktualisiert und bestimmte Versionen von vorinstallierter Software und Pakete variieren von Version zu Version.

Weitere Informationen zu bestimmten Deep-Learning-VM-Versionen finden Sie in den Versionshinweisen zu Deep-Learning-VMs.

Nachdem Sie eine bestimmte Version einer nutzerverwalteten Notebookinstanz erstellt haben, können Sie ein Upgrade ausführen. Beim Upgrade der Instanz werden die vorinstallierte Software und die Pakete aktualisiert. Weitere Informationen finden Sie unter Umgebung einer nutzerverwalteten Notebookinstanz aktualisieren.

Hinweise

Bevor Sie eine nutzerverwaltete Notebookinstanz erstellen können, müssen Sie einGoogle Cloud -Projekt haben und die Notebooks API für dieses Projekt aktivieren.

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Notebooks API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Notebooks API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

1. Wenn Sie GPUs mit Ihrer nutzerverwalteten Notebooks-Instanz verwenden möchten, prüfen Sie auf der Seite „Kontingente“ in der Google Cloud Console, ob in Ihrem Projekt genügend GPUs verfügbar sind. Wenn auf der Seite "Kontingente" keine GPUs aufgeführt sind oder Sie zusätzliche GPU-Kontingente benötigen, können Sie eine Erhöhung des Kontingents beantragen. Weitere Informationen finden Sie auf der Compute Engine-Seite Ressourcenkontingente unter Ein höheres Kontingent anfordern.

Erforderliche Rollen

Wenn Sie das Projekt erstellt haben, haben Sie die IAM-Rolle „Inhaber“ (roles/owner) für das Projekt, die alle erforderlichen Berechtigungen enthält. Überspringen Sie diesen Abschnitt und beginnen Sie mit der Erstellung Ihrer nutzerverwalteten Notebookinstanz. Wenn Sie das Projekt nicht selbst erstellt haben, fahren Sie mit diesem Abschnitt fort.

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Projekt zuzuweisen, damit Sie die Berechtigungen erhalten, die Sie zum Erstellen einer nutzerverwalteten Notebookinstanz von Vertex AI Workbench benötigen:

• Notebooks-Administrator (roles/notebooks.admin)
• Service Account User (roles/iam.serviceAccountUser)

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Gewünschte Version suchen

Wenn Sie eine nutzerverwaltete Notebooks-Instanz basierend auf einer bestimmten Deep Learning-VM-Version erstellen möchten, müssen Sie den Image-Namen der jeweiligen Deep Learning-VM-Version kennen, die Sie verwenden möchten.

Jeder Deep-Learning-VM-Release enthält Aktualisierungen für viele verschiedene Images. Jedes Image im Release hat einen eigenen Image-Namen.

So finden Sie den gewünschten Image-Namen:

1. Suchen Sie die Deep Learning-VM-Releasenummer, für die Sie Image-Namen abrufen möchten. Die Releasenummern finden Sie in den Versionshinweisen zu Deep-Learning-VMs. Releasenummern haben beginnen mit M, gefolgt von der Releasenummer, z. B. M79.

2. Führen Sie den folgenden Befehl aus, um die Image-Namen für einen bestimmten Deep-Learning-VM-Release aufzulisten.

   gcloud compute images list --project="deeplearning-platform-release" \
       --format="value(name)" \
       --filter="labels.release=RELEASE_NUMBER" \
       --show-deprecated

   Ersetzen Sie RELEASE_NUMBER durch eine Deep-Learning-VM-Releasenummer wie M79.

3. Suchen Sie nach dem Image-Namen, den Sie verwenden möchten.

Bestimmte Version über die Befehlszeile erstellen

Führen Sie die folgenden Schritte aus, um eine bestimmte Version einer nutzerverwalteten Notebookinstanz über die Befehlszeile zu erstellen:

1. Führen Sie dazu diesen gcloud notebooks-Befehl aus:

   gcloud notebooks instances create INSTANCE_NAME \
       --vm-image-project="deeplearning-platform-release" \
       --vm-image-name=VM_IMAGE_NAME \
       --machine-type=MACHINE_TYPE \
       --location=LOCATION

   Dabei gilt:

   • INSTANCE_NAME: Name der neuen Instanz
   • VM_IMAGE_NAME: Image-Name, den Sie zum Erstellen Ihrer Instanz verwenden möchten
   • MACHINE_TYPE: der Maschinentyp der VM-Instanz
   • LOCATION: der Google Cloud Standort, an dem Ihre neue Instanz erstellt werden soll

2. Greifen Sie über die Google Cloud -Konsole auf Ihre Instanz zu.

Nächste Schritte

• Upgrade von nutzerverwalteten Notebookinstanzen durchführen, damit die Instanz nur dann aktualisiert wird, wenn Sie bereit sind

• Abhängigkeiten auf Ihrer neuen nutzerverwalteten Notebookinstanz installieren

• Weitere Informationen zu Deep Learning-VM-Instanzen finden Sie in der Deep Learning-VM-Dokumentation.

• Status Ihrer nutzerverwalteten Notebookinstanz überwachen.