Upgrade einer Umgebung für eine nutzerverwaltete Notebookinstanz ausführen

Upgrade einer Umgebung für eine nutzerverwaltete Notebookinstanz ausführen

Von Nutzern verwaltete Vertex AI Workbench-Notebooks wurden verworfen. Am 30. Januar 2025 wird die Unterstützung für nutzerverwaltete Notebooks eingestellt und die Möglichkeit zum Erstellen von nutzerverwalteten Notebookinstanzen wird entfernt. Vorhandene Instanzen funktionieren 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.

Von Nutzern verwaltete Vertex AI Workbench-Notebook-Instanzen sind Deep Learning VM Image-Instanzen mit aktivierten JupyterLab-Notebook-Umgebungen, die sofort verwendet werden können. Auf dieser Seite wird beschrieben, wie Sie die Umgebung einer vom Nutzer verwalteten Notebookinstanz aktualisieren.

Gründe für ein Upgrade

Sie können die Umgebung Ihrer vom Nutzer verwalteten Notebook-Instanz aus einem der folgenden Gründe aktualisieren:

• Zum Verwenden neuer Funktionen, die nur in einer neueren Version Ihrer Umgebung verfügbar sind

• Damit Sie von Framework-Updates, Paketupdates und Fehlerkorrekturen profitieren, die in einer neueren Version Ihrer Umgebung implementiert wurden.

Upgrademethoden

Es gibt zwei Möglichkeiten, eine nutzerverwaltete Notebookinstanz zu aktualisieren:

• Automatisches Upgrade: Aktivieren Sie das automatische Upgrade, wenn Sie eine nutzerverwaltete Notebookinstanz erstellen. Während eines von Ihnen angegebenen wiederkehrenden Zeitraums prüft Vertex AI Workbench, ob Ihre Instanz aktualisiert werden kann. Wenn ja, aktualisiert Vertex AI Workbench Ihre Instanz.

• Manuelles Upgrade: Wenn eine vorhandene nutzerverwaltete Notebookinstanz die Anforderungen für das Upgrade erfüllt, können Sie die Instanz manuell aktualisieren.

Anforderungen und Einschränkungen

Abwärtskompatibilität mit Ihren nutzerverwalteten Notebooks ist nicht garantiert. Erstellen Sie eine Kopie Ihrer Daten, bevor Sie ein Upgrade einer vom Nutzer verwalteten Notebook-Instanz durchführen.

Informationen dazu, ob Sie eine bestimmte nutzerverwaltete Notebookinstanz aktualisieren können, finden Sie unter den folgenden Anforderungen und Einschränkungen:

• Die Notebooks API mussim Google Cloud-Projekt der Instanz aktiviert sein. Weitere Informationen finden Sie unter Aktivierte Dienste auflisten und API aktivieren.

• Die Umgebungsversion der nutzerverwalteten Notebooks-Instanz muss M54 oder höher sein.

• Die nutzerverwaltete Notebookinstanz muss mit der Notebooks API erstellt oder bei der Notebooks API registriert worden sein.

• Wenn Ihre nutzerverwaltete Notebookinstanz containerbasiert ist, aktualisiert Vertex AI Workbench das Betriebssystem. Die Imageversion hängt vom spezifischen Image ab, das von Ihrem Dockerfile abgerufen wird.

  Damit das Upgrade die neueste Version des Images verwendet, sollten Sie das Tag latest im Dockerfile verwenden.

Wenn das Upgrade Ihrer Instanz für Sie nicht möglich ist, sollten Sie Ihre Daten zu einer neuen nutzerverwalteten Notebookinstanz migrieren.

So funktioniert das Upgrade

Nutzerverwaltete Notebookinstanzen, die aktualisiert werden können, haben zwei Laufwerke: ein Bootlaufwerk und ein Datenlaufwerk. Beim Upgradeprozess wird das Bootlaufwerk auf ein neues Image aktualisiert und die Daten bleiben erhalten.

Welche Komponenten werden aktualisiert oder beibehalten?

In der folgenden Tabelle sehen Sie, welche Komponenten Ihrer nutzerverwalteten Notebookinstanz aktualisiert werden und welche beibehalten werden.

Komponente	Ergebnis der Aktualisierung
Frameworks für maschinelles Lernen	Aktualisiert
Daten zum maschinellen Lernen	Beibehalten
Vorinstallierte Abhängigkeiten	Aktualisiert
Vom Nutzer installierte Bibliotheken	Muss standardmäßig neu installiert werden (siehe Vom Nutzer installierte Bibliotheken).
Lokale Dateien im Verzeichnis /home/jupyter	Beibehalten
Lokale Dateien in einem anderen /home/-Verzeichnis	Nicht beibehalten
Vorinstallierte Betriebssystempakete	Aktualisiert
Vom Nutzer installierte Betriebssystempakete	Nicht beibehalten
GPU-Treiber	Aktualisiert
Notebooks	Beibehalten
Nutzerkonfigurationen	Beibehalten

Vom Nutzer installierte Bibliotheken

Standardmäßig speichern vom Nutzer verwaltete Notebook-Instanzen pip- und Conda-Bibliotheken auf dem Bootlaufwerk, das während eines Upgrades ersetzt wird. Wenn Sie pip-Bibliotheken installieren, können Sie das Flag --user einfügen, um sie im Verzeichnis /home/jupyter/ zu installieren, wo sie während eines Upgrades beibehalten werden.

Wenn Sie pip- oder Conda-Bibliotheken in einem Kernel installieren, der aus einem benutzerdefinierten Container erstellt wurde, bleiben die Bibliotheken standardmäßig nur erhalten, während der Kernel ausgeführt wird. Bei jedem Neustart des Kernels müssen diese Bibliotheken neu installiert werden. Wenn Sie nichtflüchtige Bibliotheken in einem benutzerdefinierten Container installieren möchten, fügen Sie die Bibliotheksinstallationen in Ihr Dockerfile ein. Wenn Sie pip-Bibliotheken in einem Kernel installieren, der aus einem benutzerdefinierten Container erstellt wurde, können Sie das Flag --user einfügen, damit die Bibliotheken bis zum Neustart der Instanz erhalten bleiben.

Umgebungsversionen

Vertex AI Workbench aktualisiert die Umgebungen regelmäßig (siehe Versionshinweise zu Deep Learning VM), aber mit jeder veröffentlichten Version werden nicht alle Umgebungen aktualisiert. Vertex AI Workbench aktualisiert eine Instanz nur, wenn für das VM-Image, auf dem Ihre Instanz basiert, eine neuere Umgebungsversion vorhanden ist.

Informationen zum Verwenden einer bestimmten Version zum Erstellen einer nutzerverwalteten Notebookinstanz finden Sie unter Bestimmte Version einer nutzerverwalteten Notebookinstanz erstellen.

Vor dem Aktualisieren

Führen Sie vor dem Upgrade die folgenden Schritte au:

1. In den Versionshinweisen finden Sie Informationen zu Updates für neuere Versionen.

2. Erstellen Sie eine Kopie Ihrer Daten als Sicherung.

Automatisches Upgrade

Vertex AI Workbench kann Instanzen, die ausgeführt werden, automatisch aktualisieren. Wenn Ihre Instanz gestoppt wird, wird sie nicht automatisch aktualisiert, auch wenn Sie die automatische Aktualisierung bei der Erstellung aktiviert haben.

Wenn Sie automatische Upgrades für Umgebungen aktivieren, geben Sie einen wiederkehrenden Zeitraum an, in dem Vertex AI Workbench prüft, ob die Instanz aktualisiert werden kann, und, sollte dies der Fall sein, das Upgrade der Instanz durchführt.

Der von Ihnen angegebene Zeitraum wird als Metadateneintrag notebook-upgrade-schedule im unix-cron-Format, Greenwich Mean Time (GMT), gespeichert.

Um zu prüfen, ob eine Instanz aktualisiert werden kann, verwendet Vertex AI Workbench die API-Methode isUpgradeable. Mit dieser Methode wird auf dem Bootlaufwerk der Instanz eine neuere Version des Images geprüft.

Wenn für die Instanz ein Upgrade durchgeführt werden kann, verwendet Vertex AI Workbench eine interne Upgrademethode, um die Instanz zu aktualisieren.

Nutzerverwaltete Notebookinstanz mit aktiviertem automatischen Upgrade erstellen

Klicken Sie das Kästchen Automatisches Upgrade der Umgebung aktivieren an und legen Sie beim Erstellen der Instanz einen Zeitplan fest, um eine nutzerverwaltete Notebookinstanz mit aktiviertem automatischen Upgrade zu erstellen.

Sie können automatische Upgrades entweder über die Google Cloud Console oder die Google Cloud CLI angeben.

Hinweise

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

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

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

   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

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Notebooks API.

   Enable the API

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

   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

6. Make sure that billing is enabled for your Google Cloud project.

7. Enable the Notebooks API.

   Enable the API

8. 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, Ihrem Nutzerkonto die folgenden IAM-Rollen für das Projekt zuzuweisen, damit Ihr Nutzerkonto die erforderlichen Berechtigungen zum Erstellen einer nutzerverwalteten Notebookinstanz von Vertex AI Workbench hat:

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

Ihr Administrator kann Ihrem Nutzerkonto möglicherweise auch die erforderlichen Berechtigungen über benutzerdefinierte Rollen oder andere vordefinierte Rollen erteilen.

Die Instanz erstellen

Console

1. Rufen Sie in der Google Cloud Console die Seite Nutzerverwaltete Notebooks auf. Rufen Sie alternativ notebook.new (https://notebook.new) auf und überspringen Sie den nächsten Schritt.

   Zu "Nutzerverwaltete Notebooks"

2. Klicken Sie auf  Neues Notebook und wählen Sie dann Anpassen aus.

3. Geben Sie auf der Seite Nutzerverwaltetes Notebook erstellen im Abschnitt Details die folgenden Informationen für Ihre neue Instanz ein:

   • Instanzname: Ein Name für die neue Instanz.
   • Region und Zone: Wählen Sie eine Region und eine Zone für die neue Instanz aus. Wählen Sie für eine optimale Netzwerkleistung die Region aus, die Ihnen geografisch am nächsten liegt. Prüfen Sie die verfügbaren Standorte für vom Nutzer verwaltete Notebooks.

4. Wählen Sie im Bereich Systemzustand die Option Automatisches Umgebungsupgrade aus.

5. Wählen Sie aus, ob Sie das Notebook wöchentlich oder monatlich aktualisieren möchten.

6. Wählen Sie im Feld Wochentag die gewünschte Option aus.

7. Wählen Sie im Feld Stunde eine Stunde des Tages aus.

8. Schließen Sie den Rest des Dialogfelds zur Instanzerstellung ab und klicken Sie dann auf Erstellen.

gcloud

1. Geben Sie in Cloud Shell oder in einer Umgebung, in der die Google Cloud CLI installiert ist, den folgenden Befehl der Google Cloud CLI ein:

   gcloud notebooks instances create INSTANCE_NAME
       --metadata=notebook-upgrade-schedule=SCHEDULE
       --vm-image-project=deeplearning-platform-release
       --vm-image-family=VM_IMAGE_FAMILY
       --machine-type=MACHINE_TYPE
       --location=LOCATION
   

   Dabei gilt:

   • INSTANCE_NAME: Name der neuen Instanz
   • SCHEDULE: den von Ihnen festgelegten wöchentlichen oder monatlichen Zeitplan im Unix-Cron-Format. Zum Beispiel bedeutet „00 19 * * MON“ bedeutet wöchentlich am Montag, um 1900 Uhr Greenwich Mean Time (GMT)
   • VM_IMAGE_FAMILY: der Image-Familienname, 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 Console auf Ihre Instanz zu.

Zeitplan für automatische Upgrades bearbeiten

Führen Sie die folgenden Schritte aus, um den Zeitplan für automatische Upgrades zu bearbeiten, nachdem Sie Ihre nutzerverwaltete Notebookinstanz erstellt haben:

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

   Zu "Nutzerverwaltete Notebooks"

2. Klicken Sie auf den Instanznamen, der die Änderung des Zeitplans erfordert.

3. Bearbeiten Sie auf der Seite Notebook-Details im Abschnitt Automatisches Upgrade der Umgebung den Zeitplan.

4. Klicken Sie auf Einreichen, um Ihre Änderungen zu speichern.

Manuelles Upgrade

Sie können ein Upgrade von nutzerverwalteten Notebookinstanzen manuell ausführen, wenn die Anforderungen erfüllt sind.

Nach einer neueren Version der Instanzumgebung suchen

Greifen Sie über die Cloud Console auf Ihre Instanz zu, wenn Sie prüfen möchten, ob eine neuere Version der Umgebung Ihrer Instanz verfügbar ist.

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

   Zu "Nutzerverwaltete Notebooks"

2. Wenn Ihre Instanz nicht ausgeführt wird, starten Sie die Instanz. Vertex AI Workbench kann Instanzen nur aktualisieren, wenn sie ausgeführt werden.

3. Klicken Sie auf den Instanznamen, für den Sie die Verfügbarkeit einer neueren Umgebungsversion prüfen möchten.

4. Klicken Sie auf der Seite Notebook-Details neben VM-Details auf In Compute Engine ansehen.

   Wenn eine neuere Version der Umgebung verfügbar ist, wird die Meldung „Diese Instanz muss aktualisiert werden“ angezeigt.

Upgrade der Umgebung Ihrer Instanz auf eine neuere Version ausführen

Sie haben die Möglichkeit, eine nutzerverwaltete Notebookinstanz in der Google Cloud Console oder mithilfe der Google Cloud CLI manuell zu aktualisieren.

Hinweis: Upgrades können Auswirkungen auf laufende Nutzervorgänge haben.

Console

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

   Zu "Nutzerverwaltete Notebooks"

2. Wenn Ihre Instanz nicht ausgeführt wird, starten Sie die Instanz. Vertex AI Workbench kann Instanzen nur aktualisieren, wenn sie ausgeführt werden.

3. Klicken Sie auf den Instanznamen, den Sie aktualisieren möchten.

4. Klicken Sie auf der Seite Notebook-Details auf Aktualisieren.

5. Prüfen Sie, ob Sie eine Kopie der Daten auf Ihrer Instanz erstellt haben, bevor Sie fortfahren.

6. Klicken Sie nach dem Sichern Ihrer Daten auf Upgrade. Vertex AI Workbench aktualisiert und startet Ihre Instanz.

gcloud

1. Prüfen Sie mit der API-Methode isUpgradeable, ob eine Instanz aktualisiert werden kann. Mit dieser Methode wird auf dem Bootlaufwerk der Instanz eine neuere Version des Images geprüft.

   gcloud notebooks instances is-upgradeable INSTANCE_NAME \
       --location=LOCATION
   

   Dabei gilt:

   • INSTANCE_NAME: der Name Ihrer Instanz
   • LOCATION: die Google Cloud-Standort, an dem sich die Instanz befindet

   Wenn die Instanz aktualisiert werden kann, lautet die Antwort true. Wenn die Antwort false lautet, kann die Instanz nicht aktualisiert werden. Sie können aber trotzdem versuchen, Ihre Daten in eine neue Instanz zu migrieren.

2. Wenn Ihre Instanz nicht ausgeführt wird, starten Sie die Instanz. Vertex AI Workbench kann Instanzen nur aktualisieren, wenn sie ausgeführt werden.

3. Prüfen Sie, ob Sie eine Kopie der Daten auf Ihrer Instanz erstellt haben, bevor Sie fortfahren.

4. Wenn die Instanz aktualisiert werden kann, verwenden Sie die API-Methode upgrade, um die Instanz zu aktualisieren:

   gcloud notebooks instances upgrade INSTANCE_NAME \
       --location=LOCATION
   

   Vertex AI Workbench aktualisiert die Instanz.

Rollback eines Upgrade durchführen

Führen Sie die folgenden Schritte aus, um ein Upgrade rückgängig zu machen:

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

   Zu "Nutzerverwaltete Notebooks"

2. Klicken Sie auf den Instanznamen, den Sie zurücksetzen möchten.

3. Klicken Sie auf der Seite Notebookdetails unter Verlauf aktualisieren auf Rollback.

4. Vertex AI Workbench führt ein Rollback Ihrer Instanz auf die vorherige Version durch.