Questa pagina è stata tradotta dall'API Cloud Translation.

Gestisci le revisioni delle patch per le istanze

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

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

Le revisioni delle patch includono aggiornamenti critici della sicurezza e correzioni di bug sul tuo di Compute Engine. Una revisione delle patch applica le correzioni solo sulla piattaforma senza apportare modifiche le pipeline o i plug-in. Il processo di upgrade coinvolge istanza e pipeline o un tempo di inattività.

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

Prima di iniziare

Prima di eseguire l'upgrade a una revisione della patch, rivedi le note di rilascio per informazioni sulle correzioni specifiche che include. È importante capire come potrebbero influire sulle tue istanze.
Prepara l'ambiente:
- Pianificare i tempi di inattività per la revisione delle patch.
- Consigliato: prima di eseguire l'upgrade, interrompi tutte le pipeline in esecuzione e disabilitare tutti i trigger upstream, come i trigger di Cloud Composer. All'inizio dell'upgrade, tutte le pipeline in esecuzione vengono arrestate.

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

Upgrade dell'istanza: Queste versioni includono le ultime funzionalità, miglioramenti delle funzionalità e e prestazioni migliorate per la piattaforma. Gli upgrade delle istanze sono associati con modifiche ai plug-in e richiedono upgrade della pipeline. Per ulteriori informazioni, consulta Upgrade delle versioni: istanze e pipeline.
Revisioni delle patch: Queste versioni includono solo correzioni di bug e di sicurezza critiche per la piattaforma e non modificare o aggiornare la pipeline e le funzionalità dei plug-in.

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 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 aggiornata nel file web di Cloud Data Fusion fai clic su Visualizza istanza.
Per verificare che l'upgrade sia andato a buon fine, nella console Google Cloud: ricarica 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 Amministratore di sistema dell'interfaccia web di Cloud Data Fusion non mostra la patch il numero di revisione.

gcloud

Per eseguire l'aggiornamento a una revisione della patch disponibile, esegui questo comando: Comando gcloud CLI da un terminale locale Sessione 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 località 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 il parametro --enable_stackdriver_logging, --enable_stackdriver_monitoring, e --labels.
- (Facoltativo) Puoi trasmettere le proprietà CDAP, come enable.unrecoverable.reset, come --options.
Nota: la trasmissione dell'argomento patch_revision è facoltativa. Se non specificato, viene utilizzata l'ultima revisione disponibile.

Per ulteriori informazioni, consulta il riferimento dell'interfaccia a riga di comando gcloud.
Verifica che l'upgrade sia andato a buon fine seguendo questa procedura:
1. Per ottenere i dettagli dell'istanza, esegui questo comando: Comando gcloud CLI da un terminale locale Sessione Cloud Shell:
```
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 di un'istanza Cloud Data Fusion, chiama la relativa patch() . Imposta il campo facoltativo patchRevision nella richiesta. In caso contrario specifica una revisione della patch, viene usata l'ultima disponibile.

Esempi

Gli esempi seguenti 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 località 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 come 6.7.3.
PATCH_REVISION_NUMBER: la versione della revisione del patch a cui eseguire l'upgrade, ad esempio 6.7.3.1. Vedi le revisioni patch disponibili.

Ad esempio, per eseguire l'upgrade di un'istanza della versione 6.7.3 alla 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 del ad esempio 6.7.3:

{
  "version": 6.7.3
}

Esegui il rollback di una revisione delle patch

Se dopo aver incorporato una revisione delle patch si verificano problemi imprevisti, ripristinare lo stato stabile precedente della patch seguendo questi passaggi.

gcloud

Per eseguire il rollback a una revisione precedente della patch, esegui questo comando: Comando gcloud CLI da un terminale locale Sessione 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 località dell'istanza.
- CURRENT_INSTANCE_VERSION: la versione corrente.
- STABLE_PATCH_REVISION: la revisione della patch a eseguire il rollback.
- (Facoltativo) Se applicabile alla tua istanza, aggiungi il parametro --enable_stackdriver_logging, --enable_stackdriver_monitoring, e --labels.
- (Facoltativo) Puoi trasmettere le proprietà CDAP, come enable.unrecoverable.reset, come --options.
Per ulteriori informazioni, consulta il riferimento dell'interfaccia a riga di comando gcloud.
Verifica che il rollback sia stato eseguito correttamente seguendo questi passaggi:
1. Per ottenere i dettagli dell'istanza, esegui questo comando: Comando gcloud CLI da un terminale locale Sessione Cloud Shell:
```
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 è stata ripristinata alla versione specificata.

API REST

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

Esempio

Questo esempio mostra come eseguire il rollback di un'istanza dalla patch 6.7.3.1 alla versione 6.7.3 usando 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 località 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 come 6.7.3.
STABLE_PATCH_REVISION: la revisione della patch da implementare torna indietro. Consulta le revisioni delle patch disponibili.

Ad esempio, per eseguire il rollback dell'istanza dalla revisione della patch 6.7.3.1 a per la revisione della patch 6.7.3, usa 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.
Fai riferimento agli aggiornamenti della versione e delle revisioni delle patch disponibili.
Risolvi i problemi relativi agli upgrade.