Upgrade einer Umgebung einer Instanz durchführen

Vertex AI Workbench-Instanzen sind Deep Learning VM Image-Instanzen mit aktivierten JupyterLab-Notebookumgebungen, die sofort verwendet werden können. Auf dieser Seite wird beschrieben, wie Sie die Umgebung einer Vertex AI Workbench-Instanz aktualisieren.

Gründe für ein Upgrade

Sie können die Umgebung Ihrer Vertex AI Workbench-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 Vertex AI Workbench-Instanz zu aktualisieren:

  • Automatisches Upgrade: Aktivieren Sie das automatische Upgrade, wenn Sie eine Vertex AI Workbench-Instanz 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 Vertex AI Workbench-Instanz die Anforderungen für das Upgrade erfüllt, können Sie die Instanz manuell aktualisieren.

Anforderungen und Einschränkungen

Abwärtskompatibilität mit der Vertex AI Workbench ist nicht garantiert. Erstellen Sie eine Kopie Ihrer Daten, bevor Sie ein Upgrade einer Vertex AI Workbench-Instanz durchführen.

Informationen dazu, ob Sie eine bestimmte Vertex AI Workbench-Instanz 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.

  • Wenn Ihre Vertex AI Workbench-Instanz 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 Vertex AI Workbench-Instanz migrieren.

So funktioniert das Upgrade

Vertex AI Workbench-Instanzen, die aktualisiert werden können, sind Dual-Laufwerke mit einem Bootlaufwerk und einem 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 Vertex AI Workbench-Instanz aktualisiert werden und welche erhalten werden.

Komponente Ergebnis der Aktualisierung
Frameworks für maschinelles Lernen Upgrade durchgeführt
Daten zum maschinellen Lernen Beibehalten
Vorinstallierte Abhängigkeiten Upgrade durchgeführt
Vom Nutzer installierte Bibliotheken Standardmäßig muss die App 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 Upgrade durchgeführt
Vom Nutzer installierte Betriebssystempakete Nicht beibehalten
GPU-Treiber Upgrade durchgeführt
Notebooks Beibehalten
Nutzerkonfigurationen Beibehalten

Vom Nutzer installierte Bibliotheken

Standardmäßig speichern Vertex AI Workbench-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

Ihre Vertex AI Workbench-Instanz hat eine Umgebungsversionsnummer, die Sie prüfen können:

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

    Zur Seite „VM-Instanzen“

  2. Suchen Sie in der Liste der Instanzen in der Spalte Version die Versionsnummer der Umgebung Ihrer Instanz.

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 zur Verwendung einer bestimmten Version zum Erstellen einer Vertex AI Workbench-Instanz finden Sie unter Bestimmte Version einer Vertex AI Workbench-Instanz erstellen.

Hinweis

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

Vertex AI Workbench-Instanz mit aktiviertem automatischen Upgrade erstellen

Klicken Sie auf das Kästchen Automatisches Upgrade der Umgebung aktivieren und legen Sie beim Erstellen der Instanz einen Zeitplan fest, um eine Vertex AI Workbench-Instanz mit aktiviertem automatischen Upgrade zu erstellen.

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

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

    Zur Seite „VM-Instanzen“

  2. Klicken Sie auf  NEU ERSTELLEN.

  3. Klicken Sie im Dialogfeld Neue Instanz auf Erweiterte Optionen.

  4. Geben Sie im Dialogfeld Instanz erstellen im Abschnitt Details die folgenden Informationen für Ihre neue Instanz ein:

    • Notebookname: Geben Sie einen Namen für Ihre neue Instanz ein.
    • 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. Informationen zu den verfügbaren Vertex AI Workbench-Standorten

  5. Wählen Sie im Abschnitt Systemzustand die Option Automatisches Upgrade der Umgebung aus.

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

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

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

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

Zeitplan für automatische Upgrades bearbeiten

So bearbeiten Sie den Zeitplan für automatische Upgrades, nachdem Sie Ihre Vertex AI Workbench-Instanz erstellt haben:

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

    Zur Seite „VM-Instanzen“

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

  3. Bearbeiten Sie auf der Seite Instanzdetails im Abschnitt Automatisches Upgrade der Umgebung den Zeitplan.

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

Manuelles Upgrade

Sie können die Vertex AI Workbench-Instanzen manuell aktualisieren, die den Anforderungen entsprechen.

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 Instanzen auf.

    Zur Seite „VM-Instanzen“

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

  3. Klicken Sie auf der Seite Instanzdetails 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 können eine Vertex AI Workbench-Instanz manuell in der Google Cloud Console aktualisieren.

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

    Zur Seite „VM-Instanzen“

  2. Wenn die 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 Instanzdetails auf  Upgrade.

  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.

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 Instanzen auf.

    Zur Seite „VM-Instanzen“

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

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

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