Patchversionen für Instanzen verwalten

Diese Seite enthält Informationen und Richtlinien zum Verwalten von Patchversionen für eine Cloud Data Fusion-Instanz.

Weitere Informationen dazu, wie sich Patchversionen von anderen Upgrades unterscheiden, finden Sie unter Instanzupgrades im Vergleich zu Patchversionen.

Patchversionen enthalten kritische Sicherheitsupdates und Fehlerkorrekturen für Ihre Instanzen. Bei einer Patchversion werden Korrekturen nur auf der Plattform angewendet, ohne die Pipelines oder Plug-ins zu ändern. Der Upgradeprozess umfasst Ausfallzeiten der Instanz und Pipeline.

Weitere Informationen zur Versionsverwaltung von Cloud Data Fusion finden Sie unter Versionsverwaltung in Cloud Data Fusion und verfügbaren Patchversionsupgrades.

Hinweis

  • Lesen Sie vor dem Upgrade auf eine Patchversion die Versionshinweise. Dort finden Sie Informationen zu den darin enthaltenen Fehlerkorrekturen. Es ist wichtig zu verstehen, wie sich diese auf Ihre Instanzen auswirken können.
  • Bereiten Sie Ihre Umgebung vor:
    • Planen Sie die Ausfallzeit für die Patchversion.
    • Empfohlen: Beenden Sie vor dem Upgrade alle ausgeführten Pipelines und deaktivieren Sie alle Upstream-Trigger wie Cloud Composer-Trigger. Zu Beginn des Upgrades werden alle ausgeführten Pipelines beendet.

Instanzupgrade und Patchversion im Vergleich

Instanzupgrade
Diese Versionen enthalten die neuesten Funktionen, Funktionserweiterungen und Leistungsverbesserungen für die Plattform. Instanzupgrades sind mit Plug-in-Änderungen verknüpft und erfordern Pipelineupgrades. Weitere Informationen finden Sie unter Versionsupgrades: Instanzen und Pipelines.
Patchversionen
Diese Versionen enthalten nur kritische Sicherheits‐ und Fehlerkorrekturen für die Plattform und ändern oder aktualisieren die Pipeline- und Plug-in-Features nicht.

Upgrade auf eine Patchversion für eine Cloud Data Fusion-Instanz durchführen

Führen Sie diese Schritte in der Google Cloud Console, der Google Cloud CLI oder der REST API aus, um ein Upgrade auf eine Patchversion für Ihre Cloud Data Fusion-Instanz durchzuführen.

Console

  1. Rufen Sie in der Google Cloud Console die Seite „Cloud Data Fusion“ auf.

  2. Klicken Sie auf Instanzen und klicken Sie das Kästchen neben dem Namen der Instanz an.

    Zur Seite „VM-Instanzen“

  3. Klicken Sie auf Upgrade.

  4. Wählen Sie die neueste Patchversion aus und klicken Sie auf Upgrade.

  5. Klicken Sie auf Instanz anzeigen, um über die Cloud Data Fusion-Weboberfläche auf die aktualisierte Instanz zuzugreifen.

  6. Wenn Sie prüfen möchten, ob das Upgrade erfolgreich war, laden Sie in der Google Cloud Console die Seite Instanzdetails neu. Suchen Sie im Feld Version nach der Aktualisierung.

gcloud

  1. Führen Sie den folgenden gcloud CLI-Befehl in einer lokalen Cloud Shell-Terminalsitzung aus, um ein Update auf eine verfügbare Patchversion durchzuführen:

    gcloud beta data-fusion instances update INSTANCE_ID \
  --project=PROJECT_ID \
  --location=LOCATION_NAME \
  --version=CURRENT_INSTANCE_VERSION \
  --patch_revision=AVAILABLE_PATCH_REVISION

    Ersetzen Sie Folgendes:

    • INSTANCE_ID: der Name der Instanz.
    • PROJECT_ID: die ID des Projekts, das die Cloud Data Fusion-Instanz enthält.
    • LOCATION_NAME: der Standort der Instanz.
    • CURRENT_INSTANCE_VERSION: die aktuelle Version.

    • AVAILABLE_PATCH_REVISION: die Patchversion, auf die das Upgrade durchgeführt werden soll.

    • Optional: Fügen Sie gegebenenfalls für Ihre Instanz die Flags --enable_stackdriver_logging, --enable_stackdriver_monitoring und --labels hinzu.

    • Optional: Sie können CDAP-Attribute wie enable.unrecoverable.reset als --options übergeben.

    Weitere Informationen finden Sie in der Referenz zur gcloud CLI.

  2. So prüfen Sie, ob das Upgrade erfolgreich war:

    1. Führen Sie den folgenden gcloud CLI-Befehl in einer lokalen Cloud Shell-Sitzung des Terminals aus, um die Instanzdetails abzurufen:

      gcloud beta data-fusion instances describe \
  --project=PROJECT_ID \
  --location=LOCATION_NAME \
  INSTANCE_ID

    2. Prüfen Sie, ob das Feld PATCH_REVISION in den Instanzdetails auf die angegebene Version aktualisiert ist.

REST API

Rufen Sie die zugehörige Methode patch() auf, um eine Patchversion der Cloud Data Fusion-Instanz auszuführen. Legen Sie das optionale Feld patchRevision in der Anfrage fest. Wenn Sie keine Patchversion angeben, wird die neueste verfügbare Version verwendet.

Beispiele

Die folgenden Beispiele zeigen, wie Sie mit der REST API ein Upgrade einer Instanz auf eine Patchversion durchführen.

Upgrade einer Instanz auf eine bestimmte Patchversionsversion durchführen

Rufen Sie die Methode patch() auf:

PATCH https://datafusion.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_NAME/instances/INSTANCE_ID

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID des Projekts, das die Cloud Data Fusion-Instanz enthält.
  • LOCATION_NAME: der Standort der Instanz.
  • INSTANCE_ID: der Name der Instanz.

Verwenden Sie den folgenden JSON-Anfragetext:

{
  "version": VERSION_NUMBER,
  "patchRevision": PATCH_REVISION_NUMBER
}

Ersetzen Sie Folgendes:

Wenn Sie beispielsweise eine Instanz der Version 6.7.3 auf die Patchversion 6.7.3.1 upgraden möchten, verwenden Sie den folgenden JSON-Anfragetext:

{
  "version": 6.7.3,
  "patchRevision": 6.7.3.1
}

Upgrade einer Instanz auf die Standardversion der Patchversion durchführen

Rufen Sie die Methode patch() auf:

PATCH https://datafusion.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_NAME/instances/INSTANCE_ID

Verwenden Sie den folgenden JSON-Anfragetext:

{
  "version": VERSION_NUMBER
}

Ersetzen Sie VERSION_NUMBER durch die Version der Instanz, z. B. 6.7.3:

{
  "version": 6.7.3
}

Rollback einer Patchversion durchführen

Wenn nach dem Einbinden einer Patchversion unvorhergesehene Probleme auftreten, setzen Sie die Patchversion mithilfe der folgenden Schritte in einen früheren, stabilen Zustand zurück.

gcloud

  1. Führen Sie den folgenden gcloud CLI-Befehl in einer lokalen Cloud Shell-Terminalsitzung aus, um ein Rollback zu einer vorherigen Patchversion durchzuführen:

    gcloud beta data-fusion instances update INSTANCE_ID \
  --project=PROJECT_ID \
  --location=LOCATION_NAME \
  --version=CURRENT_INSTANCE_VERSION \
  --patch_revision=STABLE_PATCH_REVISION

    Ersetzen Sie Folgendes:

    • INSTANCE_ID: der Name der Instanz.
    • PROJECT_ID: die ID des Projekts, das die Cloud Data Fusion-Instanz enthält.
    • LOCATION_NAME: der Standort der Instanz.
    • CURRENT_INSTANCE_VERSION: die aktuelle Version.

    • STABLE_PATCH_REVISION: die Patchversion, zu der das Rollback durchgeführt werden soll.

    • Optional: Fügen Sie gegebenenfalls für Ihre Instanz die Flags --enable_stackdriver_logging, --enable_stackdriver_monitoring und --labels hinzu.

    • Optional: Sie können CDAP-Attribute wie enable.unrecoverable.reset als --options übergeben.

    Weitere Informationen finden Sie in der Referenz zur gcloud CLI.

  2. So prüfen Sie, ob das Rollback erfolgreich war:

    1. Führen Sie den folgenden gcloud CLI-Befehl in einer lokalen Cloud Shell-Sitzung des Terminals aus, um die Instanzdetails abzurufen:

      gcloud beta data-fusion instances describe \
  --project=PROJECT_ID \
  --location=LOCATION_NAME \
  INSTANCE_ID

    2. Prüfen Sie, ob das Feld PATCH_REVISION in den Instanzdetails auf die angegebene Version zurückgesetzt wurde.

REST API

Für das Rollback einer Patchversion in einer Cloud Data Fusion-Instanz rufen Sie die zugehörige Methode patch() auf. Legen Sie für das Feld patchRevision in der Anfrage eine frühere, stabile Patchversion fest.

Beispiel

Dieses Beispiel zeigt, wie Sie mit der REST API für eine Instanz ein Rollback von der Patchversion 6.7.3.1 auf die Patchversion 6.7.3 durchführen.

Rufen Sie die Methode patch() auf:

PATCH https://datafusion.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_NAME/instances/INSTANCE_ID

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID des Projekts, das die Cloud Data Fusion-Instanz enthält.
  • LOCATION_NAME: der Standort der Instanz.
  • INSTANCE_ID: der Name der Instanz.

Verwenden Sie den folgenden JSON-Anfragetext:

{
  "version": VERSION_NUMBER,
  "patchRevision": STABLE_PATCH_REVISION
}

Ersetzen Sie Folgendes:

Wenn Sie beispielsweise ein Rollback der Instanz von der Patchversion 6.7.3.1 zur Patchversion 6.7.3 durchführen möchten, verwenden Sie den folgenden JSON-Anfragetext:

{
  "version": 6.7.3,
  "patchRevision": 6.7.3
}

Nächste Schritte