Patch-Überarbeitungen für Instanzen verwalten

Auf dieser Seite finden Sie Informationen und Richtlinien zum Verwalten von Patch-Revisionen 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 Patch-Version 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 Versionierung von Cloud Data Fusion finden Sie unter Versionierung in Cloud Data Fusion und verfügbare Upgrades der Patch-Revision.

Hinweis

  • Lesen Sie vor dem Upgrade auf eine Patchversion die Versionshinweise, um Informationen zu den enthaltenen Fehlerkorrekturen zu erhalten. Es ist wichtig zu wissen, wie sich diese Änderungen auf Ihre Instanzen auswirken können.
  • Bereiten Sie Ihre Umgebung vor:
    • Planen Sie eine Ausfallzeit für die Patchversion.
    • Empfohlen: Beenden Sie vor dem Ausführen eines Upgrades alle ausgeführten Pipelines und deaktivieren Sie vorgelagerte Trigger wie Cloud Composer-Trigger. Wenn das Upgrade beginnt, werden alle laufenden Pipelines beendet.

Instanzupgrade im Vergleich zur Patchversion

Instanzupgrade
Diese Versionen enthalten die neuesten Funktionen, Funktionsverbesserungen und Leistungsverbesserungen für die Plattform. Instanz-Upgrades sind mit Plugin-Änderungen verbunden und erfordern Pipeline-Upgrades. Weitere Informationen finden Sie unter Versionsupgrades: Instanzen und Pipelines.
Patchversionen
Diese Versionen enthalten nur wichtige Sicherheits- und Fehlerkorrekturen für die Plattform. Die Pipeline- und Plug-in-Funktionen werden nicht geändert oder aktualisiert.

Auf eine Patchversion für eine Cloud Data Fusion-Instanz umstellen

Wenn Sie auf eine Patch-Version für Ihre Cloud Data Fusion-Instanz upgraden möchten, führen Sie die folgenden Schritte in der Google Cloud Console, der Google Cloud CLI oder der REST API aus.

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 Patch-Version aus und klicken Sie auf Upgrade.

  5. Klicken Sie auf der Cloud Data Fusion-Weboberfläche auf Instanz aufrufen, um auf die aktualisierte Instanz zuzugreifen.

  6. Um zu prüfen, ob das Upgrade erfolgreich war, aktualisieren Sie in der Google Cloud Console die Seite Instanzdetails. Prüfen Sie im Feld Version, ob das Update installiert wurde.

gcloud

  1. Wenn Sie auf eine verfügbare Patchversion aktualisieren möchten, führen Sie den folgenden gcloud CLI-Befehl in einer lokalen Terminalsitzung in Cloud Shell aus:

    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: Standort der Instanz.
    • CURRENT_INSTANCE_VERSION: die aktuelle Version.

    • AVAILABLE_PATCH_REVISION: die Patchversion, auf die Sie ein Upgrade ausführen möchten.

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

    • Optional: Sie können die CDAP-Properties 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 in einer lokalen Cloud Shell-Sitzung den folgenden gcloud-Befehl 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 wurde.

REST API

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

Beispiele

In den folgenden Beispielen wird gezeigt, 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: 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 Version der Patch-Revision, auf die ein Upgrade ausgeführt werden soll, z. B. 6.7.3.1. Verfügbare Patchversionen

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 Standardversion der 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 der Einbindung einer Patchversion unvorhergesehene Probleme auftreten, können Sie die Patchversion mithilfe der folgenden Schritte auf einen früheren stabilen Zustand zurücksetzen.

gcloud

  1. Wenn Sie zu einer früheren Patchversion zurückkehren möchten, führen Sie in einer lokalen Cloud Shell-Sitzung den folgenden gcloud-Befehl aus:

    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: 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 Flags --enable_stackdriver_logging, --enable_stackdriver_monitoring und --labels hinzu, sofern sie für Ihre Instanz gelten.

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

    Weitere Informationen finden Sie in der Referenz zur gcloud CLI.

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

    1. Führen Sie in einer lokalen Cloud Shell-Sitzung den folgenden gcloud-Befehl 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

Wenn Sie eine Patch-Version in einer Cloud Data Fusion-Instanz rückgängig machen möchten, rufen Sie die Methode patch() auf. Legen Sie das Feld patchRevision in der Anfrage auf eine frühere, stabile Patchversion fest.

Beispiel

In diesem Beispiel wird gezeigt, wie Sie eine Instanz mithilfe der REST API von der Patch-Version 6.7.3.1 auf die Patch-Version 6.7.3 zurücksetzen.

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: 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 zurückgerollt werden soll. Verfügbare Patchversionen

Wenn Sie die Instanz beispielsweise von der Patchversion 6.7.3.1 auf die Patchversion 6.7.3 zurücksetzen möchten, verwenden Sie den folgenden JSON-Anfragetext:

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

Nächste Schritte