Gestire le revisioni delle patch per le istanze

Questa pagina fornisce informazioni e linee guida per la gestione delle revisioni delle patch per un'istanza Cloud Data Fusion.

Per ulteriori informazioni sulle differenze tra le revisioni delle patch e gli altri upgrade, consulta Upgrade delle istanze e revisioni delle patch.

Le revisioni delle patch includono aggiornamenti della sicurezza critici e correzioni di bug nelle tue istanze. Una revisione della patch applica solo correzioni alla piattaforma senza modificare le pipeline o i plug-in. Il processo di upgrade comporta tempi di inattività dell'istanza e della pipeline.

Per ulteriori informazioni sul controllo delle versioni di Cloud Data Fusion, consulta Controllo delle versioni in Cloud Data Fusion e aggiornamenti delle revisioni delle patch disponibili.

Prima di iniziare

  • Prima di eseguire l'upgrade a una revisione delle patch, consulta le note di rilascio per informazioni sulle correzioni specifiche incluse. È importante capire come potrebbero influire sulle tue istanze.
  • Prepara l'ambiente:
    • Pianifica il tempo di inattività per la revisione della patch.
    • Consigliato: prima dell'upgrade, interrompi tutte le pipeline in esecuzione e disattiva tutti i trigger upstream, come i trigger di Managed Service for Apache Airflow. Quando inizia l'upgrade, tutte le pipeline in esecuzione vengono interrotte.

Upgrade dell'istanza e revisione delle patch

Upgrade dell'istanza
Queste versioni includono le funzionalità più recenti, miglioramenti delle funzionalità e miglioramenti delle prestazioni per la piattaforma. Gli upgrade delle istanze sono associati alle modifiche dei plug-in e richiedono upgrade delle pipeline. Per saperne di più, consulta Upgrade di versione: istanze e pipeline.
Revisioni delle patch
Queste versioni includono solo correzioni di bug e della sicurezza critiche per la piattaforma e non modificano né aggiornano le funzionalità di pipeline e plug-in.

Esegui l'upgrade a una revisione delle patch per un'istanza Cloud Data Fusion

Per eseguire l'upgrade a una revisione patch per l'istanza Cloud Data Fusion, segui questi passaggi nella console Google Cloud , in Google Cloud CLI o nell'API REST.

Console

  1. Nella console Google Cloud , vai alla pagina Cloud Data Fusion.

  2. Fai clic su Istanze e seleziona la casella di controllo accanto al nome dell'istanza.

    Vai a Istanze

  3. Fai clic su Esegui upgrade.

  4. Seleziona l'ultima revisione della patch e fai clic su Esegui l'upgrade.

  5. Per accedere all'istanza di cui è stato eseguito l'upgrade nell'interfaccia web di Cloud Data Fusion, fai clic su Visualizza istanza.

  6. Per verificare che l'upgrade sia andato a buon fine, nella console Google Cloud , ricarica la pagina Dettagli istanza. Controlla il campo Versione per l'aggiornamento.

gcloud

  1. Per eseguire l'aggiornamento a una revisione della patch disponibile, esegui questo comando gcloud CLI da una sessione del terminale locale Cloud Shell:

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

    Sostituisci quanto segue:

    • INSTANCE_ID: il nome dell'istanza
    • PROJECT_ID: l'ID del progetto che contiene l'istanza Cloud Data Fusion.
    • LOCATION_NAME: la posizione dell'istanza.
    • CURRENT_INSTANCE_VERSION: la versione attuale.

    • AVAILABLE_PATCH_REVISION: la revisione della patch a cui eseguire l'upgrade.

    • (Facoltativo) Se applicabile alla tua istanza, aggiungi i flag --enable_stackdriver_logging, --enable_stackdriver_monitoring e --labels.

    • (Facoltativo) Puoi trasmettere le proprietà CDAP, ad esempio enable.unrecoverable.reset, come --options.

    Per saperne di più, consulta il riferimento di gcloud CLI.

  2. Verifica che l'upgrade sia riuscito seguendo questi passaggi:

    1. Recupera i dettagli dell'istanza eseguendo questo comando gcloud CLI da una sessione Cloud Shell del terminale locale:

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

    2. Verifica che il campo PATCH_REVISION nei dettagli dell'istanza sia aggiornato alla versione specificata.

API REST

Per eseguire la revisione delle patch dell'istanza Cloud Data Fusion, chiama il metodo patch(). Imposta il campo facoltativo patchRevision nella richiesta. Se non specifichi una revisione della patch, viene utilizzata l'ultima disponibile.

Esempi

Gli esempi riportati di seguito mostrano come eseguire l'upgrade di un'istanza a una revisione delle patch con l'API REST.

Eseguire l'upgrade di un'istanza a una versione specifica di revisione delle patch

Chiama il metodo patch():

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto che contiene l'istanza Cloud Data Fusion.
  • LOCATION_NAME: la posizione dell'istanza.
  • INSTANCE_ID: il nome dell'istanza

Utilizza il seguente corpo della richiesta JSON:

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

Sostituisci quanto segue:

  • VERSION_NUMBER: la versione dell'istanza, ad esempio 6.7.3.
  • PATCH_REVISION_NUMBER: la versione di revisione della patch a cui eseguire l'upgrade, ad esempio 6.7.3.1. Visualizza le revisioni delle patch disponibili.

Ad esempio, per eseguire l'upgrade di un'istanza della versione 6.7.3 alla revisione della patch 6.7.3.1, utilizza il seguente corpo della richiesta JSON:

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

Esegui l'upgrade di un'istanza alla versione di revisione delle patch predefinita

Chiama il metodo patch():

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

Utilizza il seguente corpo della richiesta JSON:

{
  "version": VERSION_NUMBER
}

Sostituisci VERSION_NUMBER con la versione dell'istanza, ad esempio 6.7.3:

{
  "version": 6.7.3
}

Esegui il rollback di una revisione della patch

Se riscontri problemi imprevisti dopo l'incorporamento di una revisione della patch, ripristina la revisione della patch a uno stato precedente e stabile seguendo questi passaggi.

gcloud

  1. Per eseguire il rollback a una revisione della patch precedente, esegui questo comando gcloud CLI da una sessione Cloud Shell di un terminale locale:

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

    Sostituisci quanto segue:

    • INSTANCE_ID: il nome dell'istanza
    • PROJECT_ID: l'ID del progetto che contiene l'istanza Cloud Data Fusion.
    • LOCATION_NAME: la posizione dell'istanza.
    • CURRENT_INSTANCE_VERSION: la versione attuale.

    • STABLE_PATCH_REVISION: la revisione della patch a cui eseguire il rollback.

    • (Facoltativo) Se applicabile alla tua istanza, aggiungi i flag --enable_stackdriver_logging, --enable_stackdriver_monitoring e --labels.

    • (Facoltativo) Puoi trasmettere le proprietà CDAP, ad esempio enable.unrecoverable.reset, come --options.

    Per saperne di più, consulta il riferimento di gcloud CLI.

  2. Verifica che il rollback sia riuscito seguendo questi passaggi:

    1. Recupera i dettagli dell'istanza eseguendo questo comando gcloud CLI da una sessione Cloud Shell del terminale locale:

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

    2. Verifica che il campo PATCH_REVISION nei dettagli dell'istanza sia revertito alla versione specificata.

API REST

Per eseguire il rollback di una revisione della patch in un'istanza Cloud Data Fusion, chiama il metodo patch(). Imposta il campo patchRevision nella richiesta su una revisione della patch precedente e stabile.

Esempio

Questo esempio mostra come eseguire il rollback di un'istanza dalla revisione della patch 6.7.3.1 alla revisione della patch 6.7.3 utilizzando l'API REST.

Chiama il metodo patch():

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto che contiene l'istanza Cloud Data Fusion.
  • LOCATION_NAME: la posizione dell'istanza.
  • INSTANCE_ID: il nome dell'istanza

Utilizza il seguente corpo della richiesta JSON:

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

Sostituisci quanto segue:

  • VERSION_NUMBER: la versione dell'istanza, ad esempio 6.7.3.
  • STABLE_PATCH_REVISION: la revisione della patch a cui eseguire il rollback. Visualizza le revisioni delle patch disponibili.

Ad esempio, per eseguire il rollback dell'istanza dalla revisione della patch 6.7.3.1 alla revisione della patch 6.7.3, utilizza il seguente corpo della richiesta JSON:

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

Passaggi successivi