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 umfassen kritische Sicherheitsupdates und Fehlerkorrekturen auf Ihrem Instanzen. Eine Patchversion wendet Korrekturen nur auf der Plattform an, ohne sie zu ändern die Pipelines oder Plug-ins. Der Upgradeprozess 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 zu zu den Fehlerbehebungen. Es ist wichtig zu wissen, wie sich diese Änderungen auf Ihre Instanzen auswirken können.
  • Bereiten Sie Ihre Umgebung vor:
    • Planen Sie die 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. Instanzupgrades sind verknüpft mit Plug-in-Änderungen 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.

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

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

  5. Klicken Sie auf Instanz aufrufen, um in der Cloud Data Fusion-Weboberfläche 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 Cloud Shell-Terminalsitzung 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 aktualisiert 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 überprüfen Sie, ob das Upgrade erfolgreich war:

    1. Rufen Sie die Instanzdetails ab, indem Sie den folgenden Befehl ausführen: gcloud-Kommandozeilenbefehl von einem lokalen Terminal aus Cloud Shell-Sitzung:

      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 Folgendes enthält: Cloud Data Fusion-Instanz.
  • LOCATION_NAME ist der Standort der Instanz.
  • INSTANCE_ID: der Name der Instanz.

Verwende dazu den folgenden JSON-Anfragetext:

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

Ersetzen Sie Folgendes:

  • VERSION_NUMBER: die Version der Instanz, z. B. als 6.7.3.
  • PATCH_REVISION_NUMBER: Die Version der Patch-Revision, auf die aktualisiert werden soll, z. B. 6.7.3.1. Verfügbare Patchversionen

Beispiel: Um eine Instanz der Version 6.7.3 auf den Patch 6.7.3.1 zu aktualisieren, Version, 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 des Instanz wie 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 für Rollback auf.

    • Optional: Fügen Sie bei Bedarf für Ihre Instanz den Parameter --enable_stackdriver_logging, --enable_stackdriver_monitoring und --labels-Flags

    • Optional: Sie können CDAP-Attribute übergeben, z. B. enable.unrecoverable.reset, als --options zu ändern.

    Weitere Informationen finden Sie in der Referenz zur gcloud CLI.

  2. Prüfen Sie mit den folgenden Schritten, ob das 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 den Wert angegebene Version wiederhergestellt.

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 für das Feld patchRevision in der Anfrage eine frühere, stabile Version fest. Patchversion.

Beispiel

Dieses Beispiel zeigt, wie Sie ein Rollback einer Instanz aus dem Patch 6.7.3.1 durchführen Patchversion 6.7.3 mithilfe der REST API.

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 Folgendes enthält: Cloud Data Fusion-Instanz.
  • LOCATION_NAME ist der Standort der Instanz.
  • INSTANCE_ID: der Name der Instanz.

Verwende dazu den folgenden JSON-Anfragetext:

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

Ersetzen Sie Folgendes:

  • VERSION_NUMBER: die Version der Instanz, z. B. als 6.7.3.
  • STABLE_PATCH_REVISION: Die Patchversion, auf die zurückgerollt werden soll. Sehen Sie sich die verfügbaren Patchversionen an.

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