Patch-Überarbeitungen für Instanzen verwalten

Auf dieser Seite finden Sie 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 Instanz-Upgrades im Vergleich zu Patchversionen.

Patchversionen enthalten wichtige Sicherheitsupdates und Fehlerkorrekturen für Ihre Instanzen. Bei einer Patchversion werden nur Fehler auf der Plattform behoben, ohne die Pipelines oder Plug-ins zu ändern. Das Upgrade umfasst Instanz- und Pipeline-Ausfallzeiten.

Weitere Informationen zur Versionsverwaltung in Cloud Data Fusion finden Sie unter Versionsverwaltung in Cloud Data Fusion und verfügbare Upgrades für Patchversionen.

Vorbereitung

  • Bevor Sie ein Upgrade auf eine Patchversion durchführen, lesen Sie die Versionshinweise, um Informationen zu den spezifischen Fehlerbehebungen zu erhalten. Es ist wichtig zu wissen, wie sich diese auf Ihre Instanzen auswirken können.
  • Bereiten Sie Ihre Umgebung vor:
    • Planen Sie Ausfallzeiten für die Patchversion ein.
    • Empfohlen: Beenden Sie vor dem Upgrade alle ausgeführten Pipelines und deaktivieren Sie vorgelagerte Trigger wie Managed Service for Apache Airflow-Trigger. Wenn das Upgrade beginnt, werden alle ausgeführten Pipelines beendet.

Instanz-Upgrade im Vergleich zu Patchversion

Instanz-Upgrade
Diese Versionen enthalten die neuesten Funktionen, Funktionsverbesserungen und Leistungsverbesserungen für die Plattform. Instanz-Upgrades sind mit Plug-in-Änderungen verbunden und erfordern Pipeline-Upgrades. Weitere Informationen finden Sie unter Versions-Upgrades: Instanzen und Pipelines.
Patchversionen
Diese Versionen enthalten nur wichtige Sicherheits- und Fehlerkorrekturen für die Plattform und ändern oder aktualisieren die Pipeline- und Plug-in-Funktionen nicht.

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

So führen Sie ein Upgrade auf eine Patchversion für Ihre Cloud Data Fusion-Instanz durch: Folgen Sie der Anleitung in der Google Cloud console, der Google Cloud CLI oder der REST API.

Console

  1. Rufen Sie in der Google Cloud console die Seite Cloud Data Fusion auf.

  2. Klicken Sie auf Instanzen und setzen Sie ein Häkchen in das Kästchen neben dem Namen der Instanz.

    Zur Seite „VM-Instanzen“

  3. Klicken Sie auf Upgrade.

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

  5. Wenn Sie auf die aktualisierte Instanz in der Cloud Data Fusion-Weboberfläche zugreifen möchten, klicken Sie auf Instanz ansehen.

  6. Prüfen Sie, ob das Upgrade erfolgreich war. Aktualisieren Sie dazu in der Google Cloud console, die Seite Instanzdetails. Suchen Sie im Feld Version nach dem Update.

gcloud

  1. Führen Sie den folgenden gcloud CLI-Befehl in einem lokalen Terminal Cloud Shell-Sitzung aus, um auf eine verfügbare Patchversion zu aktualisieren:

    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 aktualisiert werden soll.

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

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

    Weitere Informationen finden Sie in der Referenz zur gcloud-Befehlszeile.

  2. Prüfen Sie so, ob das Upgrade erfolgreich war:

    1. Rufen Sie die Instanzdetails ab, indem Sie den folgenden gcloud CLI-Befehl in einem lokalen Terminal oder einer Cloud Shell-Sitzung ausführen:

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

REST API

Rufen Sie die Methode patch() auf, um die Patchversion einer Cloud Data Fusion-Instanz zu aktualisieren. 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 eine Instanz mit der REST API auf eine Patchversion aktualisieren.

Instanz auf eine bestimmte Patchversion aktualisieren

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:

  • VERSION_NUMBER: die Version der Instanz, z. B. 6.7.3.
  • PATCH_REVISION_NUMBER: die Patchversion, auf die aktualisiert werden soll, z. B. 6.7.3.1. Verfügbare Patchversionen ansehen

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

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

Instanz auf die Standard-Patchversion aktualisieren

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 unerwartete Probleme auftreten, können Sie die Patchversion so auf einen früheren, stabilen Zustand zurücksetzen:

gcloud

  1. Führen Sie den folgenden gcloud CLI-Befehl in einem lokalen Terminal Cloud Shell-Sitzung aus, um ein Rollback auf eine vorherige 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, auf die ein Rollback durchgeführt werden soll.

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

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

    Weitere Informationen finden Sie in der Referenz zur gcloud-Befehlszeile.

  2. Prüfen Sie so, ob das Rollback erfolgreich war:

    1. Rufen Sie die Instanzdetails ab, indem Sie den folgenden gcloud CLI-Befehl in einem lokalen Terminal oder einer Cloud Shell-Sitzung ausführen:

      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

Rufen Sie die Methode patch() auf, um ein Rollback einer Patchversion in einer Cloud Data Fusion-Instanz durchzuführen. Legen Sie das Feld patchRevision in der Anfrage auf eine frühere, stabile Patchversion fest.

Beispiel

In diesem Beispiel wird gezeigt, wie Sie mit der REST API ein Rollback einer Instanz 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:

  • VERSION_NUMBER: die Version der Instanz, z. B. 6.7.3.
  • STABLE_PATCH_REVISION: die Patchversion, auf die ein Rollback durchgeführt werden soll. Verfügbare Patchversionen ansehen

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

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

Nächste Schritte