Questa pagina è stata tradotta dall'API Cloud Translation.

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 rispetto alle revisioni delle patch.

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

Per ulteriori informazioni sul controllo della versione di Cloud Data Fusion, consulta Controllo della versione in Cloud Data Fusion e Upgrade 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 comprendere in che modo potrebbero influire sulle tue istanze.
Prepara l'ambiente:
- Pianifica il tempo di riposo per la revisione delle patch.
- Consigliato: prima di eseguire l'upgrade, interrompi le pipeline in esecuzione e disattiva gli attivatori a monte, ad esempio gli attivatori Cloud Composer. All'inizio dell'upgrade, tutte le pipeline in esecuzione vengono interrotte.

Confronto tra l'upgrade dell'istanza e la revisione delle patch

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

Eseguire l'upgrade a una revisione della patch per un'istanza Cloud Data Fusion

Per eseguire l'upgrade a una revisione delle patch per l'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 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 upgrade.
Seleziona l'ultima revisione del patch 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 andato a buon fine, nella console Google Cloud, reload la pagina Dettagli istanza. Controlla il campo Versione per verificare se è presente l'aggiornamento.

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

gcloud

Per eseguire l'aggiornamento a una revisione della patch disponibile, esegui il seguente comando gcloud CLI da un 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 corrente.
- 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 passare le proprietà CDAP, ad esempioenable.unrecoverable.reset, come --options.
Nota: il passaggio dell'argomento patch_revision è facoltativo. Se non specificato, viene utilizzata la revisione della patch più recente disponibile.

Per saperne di più, consulta la documentazione di riferimento di gcloud CLI.
Verifica che l'upgrade sia riuscito seguendo questi passaggi:
1. Per recuperare i dettagli dell'istanza, esegui il seguente 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 quella più recente 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 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 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 della revisione della patch a cui eseguire l'upgrade, ad esempio 6.7.3.1. Consulta 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
}

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

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 delle patch

Se si verificano problemi imprevisti dopo aver incorporato una revisione della patch, ripristina una revisione della patch a uno stato precedente stabile seguendo questi passaggi.

gcloud

Per eseguire il rollback a una revisione della patch precedente, esegui il seguente comando gcloud CLI da un terminale locale Cloud Shell:
```
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 corrente.
- STABLE_PATCH_REVISION: la revisione della patch da eseguire come rollback.
- (Facoltativo) Se applicabile alla tua istanza, aggiungi i flag --enable_stackdriver_logging, --enable_stackdriver_monitoring e --labels.
- (Facoltativo) Puoi passare le proprietà CDAP, ad esempioenable.unrecoverable.reset, come --options.
Per saperne di più, consulta la documentazione di riferimento di gcloud CLI.
Verifica che il rollback sia riuscito seguendo questi passaggi:
1. Per recuperare i dettagli dell'istanza, esegui il seguente 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 stato riportato 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 qualsiasi 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. Consulta 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

Gestisci gli upgrade delle versioni per pipeline e istanze.
Scopri di più sul controllo delle versioni in Cloud Data Fusion.
Consulta gli upgrade delle versioni e delle revisioni delle patch disponibili.
Risolvi i problemi relativi agli upgrade.