Gestisci le revisioni delle patch per le istanze

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

Per ulteriori informazioni su come le revisioni delle patch differiscono dagli altri upgrade, consulta Upgrade delle istanze e revisioni delle patch.

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

Per maggiori informazioni sul controllo delle versioni di Cloud Data Fusion, consulta Controllo delle versioni in Cloud Data Fusion e gli upgrade disponibili delle revisioni delle patch.

Prima di iniziare

Prima di eseguire l'upgrade a una revisione delle patch, consulta le note di rilascio per informazioni sulle correzioni specifiche che include. È importante capire in che modo potrebbero influire sulle istanze.
Prepara l'ambiente:
- Pianifica il tempo di inattività per la revisione delle patch.
- Consigliato: prima di eseguire l'upgrade, interrompi tutte le pipeline in esecuzione e disabilita eventuali trigger upstream, come quelli di Cloud Composer. Quando inizia l'upgrade, tutte le pipeline in esecuzione vengono arrestate.

Upgrade dell'istanza e revisione delle patch

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

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

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

Console

Nella console Google Cloud, vai alla pagina di Cloud Data Fusion.
Fai clic su Istanze e seleziona la casella di controllo accanto al nome dell'istanza.

Vai a Istanze
Fai clic su Esegui l'upgrade.
Seleziona la revisione della patch più recente e fai clic su Esegui l'upgrade.
Per accedere all'istanza di cui è stato eseguito l'upgrade nell'interfaccia web di Cloud Data Fusion, fai clic su Visualizza istanza.
Per verificare che l'upgrade sia riuscito, ricarica la pagina Dettagli istanza nella console Google Cloud. Verifica l'aggiornamento nel campo Versione.

Nota: il numero di versione visualizzato nella parte superiore della pagina Amministratore di sistema nell'interfaccia web di Cloud Data Fusion non mostra il numero di versione della patch.

gcloud

Per eseguire l'aggiornamento a una revisione delle patch disponibile, esegui questo comando gcloud CLI da una sessione di Cloud Shell del terminale locale:
```
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 località dell'istanza.
- CURRENT_INSTANCE_VERSION: la versione corrente.
- AVAILABLE_PATCH_REVISION: la revisione delle 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 passare le proprietà CDAP, come enable.unrecoverable.reset, come --options.
Nota: il passaggio dell'argomento patch_revision è facoltativo. Se non specificati, viene utilizzata la revisione delle patch più recente disponibile.

Per maggiori informazioni, consulta il riferimento gcloud CLI.
Verifica che l'upgrade sia riuscito seguendo questi passaggi:
1. Ottieni 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 di Cloud Data Fusion, chiama il metodo patch(). Imposta il campo facoltativo patchRevision nella richiesta. Se non specifichi una revisione della patch, viene utilizzata la versione più recente disponibile.

Esempi

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

Esegui l'upgrade di un'istanza a una versione specifica della 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 di Cloud Data Fusion.
LOCATION_NAME: la località dell'istanza.
INSTANCE_ID: il nome dell'istanza.

Usa 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 della revisione delle patch a cui eseguire l'upgrade, ad esempio 6.7.3.1. Vedi le revisioni delle patch disponibili.

Ad esempio, per eseguire l'upgrade di un'istanza della versione 6.7.3 alla revisione delle 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 della revisione delle patch predefinita

Chiama il metodo patch():

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

Usa 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 di una patch

Se si verificano problemi imprevisti dopo l'incorporamento di una revisione delle patch, ripristina una revisione della patch precedente a uno stato stabile precedente seguendo questi passaggi.

gcloud

Per eseguire il rollback a una revisione della patch precedente, esegui questo comando gcloud CLI da una sessione di Cloud Shell del 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 località dell'istanza.
- CURRENT_INSTANCE_VERSION: la versione corrente.
- 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 passare le proprietà CDAP, come enable.unrecoverable.reset, come --options.
Per maggiori informazioni, consulta il riferimento gcloud CLI.
Verifica che il rollback sia stato eseguito seguendo questi passaggi:
1. Ottieni 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 ripristinato alla versione specificata.

API REST

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

Esempio

Questo esempio mostra come eseguire il rollback di un'istanza dalla revisione delle patch 6.7.3.1 alla revisione delle 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 di Cloud Data Fusion.
LOCATION_NAME: la località dell'istanza.
INSTANCE_ID: il nome dell'istanza.

Usa 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. Vedi le revisioni delle patch disponibili.

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

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

Passaggi successivi

Gestire gli upgrade delle versioni per pipeline e istanze.
Scopri di più sul controllo delle versioni in Cloud Data Fusion.
Fai riferimento agli upgrade disponibili per versioni e revisioni delle patch.
Risolvere i problemi relativi agli upgrade.