Configura periodi di manutenzione

Questa pagina spiega come definire i periodi di manutenzione per Cloud Data Fusion di Compute Engine.

I periodi di manutenzione sono supportati per le istanze Cloud Data Fusion in versioni 6.8.0 e successive.

Informazioni sui periodi di manutenzione

Un periodo di manutenzione in Cloud Data Fusion è un periodo di tempo in cui di eseguire operazioni di manutenzione, riducendo il rischio e interruzioni durante i picchi di utilizzo. Pianificazione dei periodi di manutenzione durante nelle ore di punta o nelle ore in cui l'attività è più bassa, riduce al minimo il loro impatto sulle dalle tue istanze Cloud Data Fusion e dalle esecuzioni della pipeline.

I periodi di manutenzione configurati ti consentono di controllare le operazioni di manutenzione si verificano nella tua istanza:

  • Se il periodo di manutenzione è definito, le operazioni di manutenzione vengono eseguite da Cloud Data Fusion entro i periodi definiti.
  • Se il periodo di manutenzione non è definito, la manutenzione può essere eseguita in qualsiasi nel tempo.

Informazioni sulle operazioni di manutenzione

Per garantire la sicurezza e la conformità del sistema, Cloud Data Fusion conduce con le normali operazioni di manutenzione. Queste operazioni includono l'applicazione aggiornamenti e patch di sicurezza per mitigare le vulnerabilità e proteggere i dati utente. Le finestre di manutenzione pianificate assicurano che gli aggiornamenti vengano applicati in modo efficiente, preservare l'integrità del sistema e ridurre al minimo le interruzioni di istanze e pipeline eseguite.

  • Quando configuri i periodi di manutenzione, devi allocare almeno 12 periodi ore alla settimana per le operazioni di manutenzione. Ogni finestra deve essere compresa tra 4 e 12 ore.

  • Durante le ore del periodo di manutenzione, alcune operazioni potrebbero risentirne. Consigliamo di fare finestre di manutenzione durante periodi di utilizzo non di punta. La l'operazione di manutenzione può influire su Cloud Data Fusion nei seguenti modi:

    • L'interfaccia di Cloud Data Fusion Studio potrebbe essere non disponibile.
    • L'esecuzione della pipeline potrebbe risentirne e causare errori.
    • I servizi Cloud Data Fusion potrebbero essere temporaneamente inattivi, causando un'API non andranno a buon fine.
    • Le istanze potrebbero non essere completamente funzionanti per un massimo di un'ora durante ore del periodo di manutenzione. Ti consigliamo di configurare la manutenzione quando le pipeline non sono in esecuzione o non sono pianificate per vengono eseguiti tutti i test delle unità.

Specificare i periodi di manutenzione durante la creazione di un'istanza

Console

Per impostare il periodo di manutenzione quando crei un'istanza:

  1. Vai alla pagina Istanze di Cloud Data Fusion e fai clic su Crea in esecuzione.

    Crea un'istanza

  2. Inserisci un Nome istanza ed Edizione. Per ulteriori informazioni per ogni campo, consulta Creare un'istanza.
  3. Espandi la sezione Opzioni avanzate.
  4. Espandi la sezione Manutenzione e segui questi passaggi:
      .
    1. Seleziona la casella di controllo Abilita periodo di manutenzione.
    2. Nel campo Ora di inizio, inserisci un'ora in un formato supportato.
    3. Seleziona un fuso orario nell'elenco TimeZone.
    4. Negli elenchi Giorni e Durata, seleziona i giorni della settimana e durata della finestra. Per ulteriori informazioni su queste impostazioni, vedi Informazioni sulle operazioni di manutenzione.
    5. Fai clic su Crea.

Per ulteriori informazioni, vedi Configura le tempistiche e la ricorrenza del periodo di manutenzione (RRULE).

API REST

  1. Imposta la configurazione Instance utilizzando l'API instance.create:
{
  "name": string,
  "description": string,
  …
  …
  "maintenancePolicy": {
    "maintenanceWindow": {
      "recurringTimeWindow": {
        "window": {
            "startTime": "START_TIME",
            "endTime": "END_TIME"
        },
        "recurrence": "MAINTENANCE_RECURRENCE"
      }
    },
  }
}

Sostituisci quanto segue:

  • START_TIME: ora di inizio della finestra temporale, nel formato RFC 3339.
  • END_TIME: ora di fine della finestra temporale, tra nel formato RFC 3339.

  • MAINTENANCE_RECURRENCE: una regola RRULE per la ricorrenza del periodo di manutenzione. Cloud Data Fusion supporta solo i seguenti formati:

    • FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SA o BYDAY=SU,MO,TU,WE,TH,FR,SA,MO;FREQ=WEEKLY. che specifica le ricorrenza della finestra per i giorni selezionati, a partire dal startTime e per la durata specificata.

Per ulteriori informazioni, vedi Configura le tempistiche e la ricorrenza del periodo di manutenzione (RRULE).

L'esempio seguente crea un'istanza con un periodo di manutenzione di sei ore tra le 10:00 e le 16:00 (UTC) di sabato e domenica di ogni settimana. Per ulteriori informazioni informazioni, consulta la documentazione dell'API instances.

// POST https://datafusion.googleapis.com/v1/projects/example-project/locations/us-central1/instances?instanceID=example-instance

{
  "maintenancePolicy": {
      "maintenanceWindow": {
          "recurringTimeWindow": {
              "window": {
                  "startTime": "2024-01-01T10:00:00Z",
                  "endTime": "2024-01-01T16:00:00Z",
              },
              "recurrence": "FREQ=WEEKLY;BYDAY=SA,SU"
          }
      },
  }
}

gcloud

Puoi specificare il periodo di manutenzione durante la creazione di un'istanza utilizzando il comando gcloud beta data-fusion instances create.

Per un periodo di manutenzione è necessario definire i seguenti parametri:

  • --maintenance-window-start imposta l'ora di inizio della finestra.
  • --maintenance-window-end imposta l'ora di fine della finestra.
  • --maintenance-window-recurrence imposta una regola RRULE per la ricorrenza del periodo di manutenzione.
gcloud beta data-fusion instances create INSTANCE_NAME \
    --project=PROJECT_NAME \
    --location=LOCATION \
    --maintenance-window-start=START_TIME \
    --maintenance-window-end=END_TIME \
    --maintenance-window-recurrence=MAINTENANCE_RECURRENCE

Sostituisci quanto segue:

  • INSTANCE_NAME: il nome dell'istanza.
  • PROJECT_NAME: il nome del progetto.
  • LOCATION: il nome della regione dell'istanza.
  • START_TIME: l'ora di inizio della finestra nel formato formato di input di data/ora. Solo il viene utilizzata l'ora del giorno specificata, la data specificata viene ignorata.
  • END_TIME: l'ora di fine della finestra nel formato formato di input di data/ora. Solo il viene utilizzata l'ora del giorno specificata, la data specificata viene ignorata. La la data e l'ora specificate devono essere successive all'ora di inizio.

  • MAINTENANCE_RECURRENCE: una regola RRULE per la ricorrenza del periodo di manutenzione. Cloud Data Fusion supporta solo i seguenti formati:

    • FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SA o BYDAY=SU,MO,TU,WE,TH,FR,SA,MO;FREQ=WEEKLY. che specifica le ricorrenza della finestra per i giorni selezionati, a partire dal --maintenance-window-start volta e per la durata specificata.

Per ulteriori informazioni, vedi Configura le tempistiche e la ricorrenza del periodo di manutenzione (RRULE).

Il comando seguente crea un'istanza con un periodo di manutenzione di sei ore tra le 12:00 e le 18:00 (UTC) di sabato e domenica di ogni settimana.

gcloud beta data-fusion instances create example-instance \
    --project='example-project' \
    --location='us-east1' \
    --maintenance-window-start='2024-01-01T12:00:00Z' \
    --maintenance-window-end='2024-01-01T18:00:00Z' \
    --maintenance-window-recurrence='FREQ=WEEKLY;BYDAY=SA,SU'

Aggiorna i periodi di manutenzione per un'istanza

Console

Per aggiornare il periodo di manutenzione in un'istanza esistente in nella console Google Cloud, segui questi passaggi:

  1. Vai alla pagina Istanze di Cloud Data Fusion.

    Vai a Istanze

  2. Fai clic sul nome dell'istanza per visualizzare i dettagli dell'istanza.

  3. Nella pagina Dettagli istanza, vai al Periodo di manutenzione e fai clic su Modifica.

  4. I campi del periodo di manutenzione vengono aperti in modalità di modifica. Aggiorna i valori, secondo necessità:

    1. Seleziona la casella di controllo Abilita periodo di manutenzione.
    2. Nel campo Ora di inizio, inserisci un'ora in un formato supportato.
    3. Seleziona un fuso orario nell'elenco TimeZone.
    4. Negli elenchi Giorni e Durata, seleziona i giorni della settimana e la durata. della finestra. Per ulteriori informazioni su queste impostazioni, vedi Informazioni sulle operazioni di manutenzione.

  5. Fai clic su Salva.

Per ulteriori informazioni, vedi Configura le tempistiche e la ricorrenza del periodo di manutenzione (RRULE).

API REST

Per le istanze esistenti, aggiorna i periodi di manutenzione utilizzando instances.patch richiesta API. Sostituisce la configurazione esistente del periodo di manutenzione, se presenti. In caso contrario, viene impostata una nuova configurazione, come indicato nella richiesta. del testo.

Crea una richiesta API come segue:

  1. Nel parametro updateMask, specifica la maschera maintenance_policy.
  2. Nel corpo della richiesta, specifica il periodo di manutenzione nella configurazione dei criteri:
{
  "maintenancePolicy": {
    "maintenanceWindow": {
        "recurringTimeWindow": {
          "window": {
              "startTime": "START_TIME",
              "endTime": "END_TIME"
          },
          "recurrence": "MAINTENANCE_RECURRENCE"
        }
    },
  }
}

Per ulteriori informazioni, vedi Configura le tempistiche e la ricorrenza del periodo di manutenzione (RRULE).

L'esempio seguente aggiorna la configurazione dei criteri di manutenzione del dell'istanza con un periodo di manutenzione di quattro ore tra le 11:00 e le 15:00 (UTC) Ogni settimana il venerdì, il sabato e la domenica.

// PATCH https://datafusion.googleapis.com/v1/projects/example-project/locations/us-central1/instances/example-instance?updateMask=maintenance_policy

{
"maintenancePolicy": {
  "maintenanceWindow": {
    "recurringTimeWindow": {
      "window": {
          "startTime": "2024-01-01T11:00:00Z",
          "endTime": "2024-01-01T15:00:00Z",
        },
      "recurrence": "FREQ=WEEKLY;BYDAY=FR,SA,SU"
    }
  },
}
}

gcloud

Puoi aggiornare il periodo di manutenzione di un'istanza utilizzando il comando gcloud beta data-fusion instances update.

Per un periodo di manutenzione è necessario definire i seguenti parametri:

  • --maintenance-window-start imposta l'ora di inizio della finestra.
  • --maintenance-window-end imposta l'ora di fine della finestra.
  • --maintenance-window-recurrence imposta una regola RRULE per la ricorrenza del periodo di manutenzione.
gcloud beta data-fusion instances update INSTANCE_NAME \
    --project=PROJECT_NAME \
    --location=LOCATION \
    --maintenance-window-start=START_TIME \
    --maintenance-window-end=END_TIME \
    --maintenance-window-recurrence=MAINTENANCE_RECURRENCE

Sostituisci quanto segue:

  • INSTANCE_NAME: il nome dell'istanza.
  • PROJECT_NAME: il nome del progetto.
  • LOCATION: il nome della regione dell'istanza.
  • START_TIME: l'ora di inizio della finestra nel formato formato di input di data/ora. Solo il viene utilizzata l'ora del giorno specificata, la data specificata viene ignorata.
  • END_TIME: l'ora di fine della finestra nel formato formato di input di data/ora. Solo il viene utilizzata l'ora del giorno specificata, la data specificata viene ignorata. La la data e l'ora specificate devono essere successive all'ora di inizio.

  • MAINTENANCE_RECURRENCE: una regola RRULE per la ricorrenza del periodo di manutenzione. Cloud Data Fusion supporta solo i seguenti formati:

    • FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SA o BYDAY=SU,MO,TU,WE,TH,FR,SA,MO;FREQ=WEEKLY. che specifica le ricorrenza della finestra per i giorni selezionati, a partire dal --maintenance-window-start volta e per la durata specificata.

Il comando seguente aggiorna l'istanza example-instance con un periodo di sei ore periodo di manutenzione tra le 12:00 e le 18:00 (UTC) di sabato e domenica ogni settimana.

gcloud beta data-fusion instances update example-instance \
    --project='example-project' \
    --location='us-east1' \
    --maintenance-window-start='2024-01-01T12:00:00Z' \
    --maintenance-window-end='2024-01-01T18:00:00Z' \
    --maintenance-window-recurrence='FREQ=WEEKLY;BYDAY=SA,SU'

Configura le ore e la ricorrenza del periodo di manutenzione (RRULE)

Quando configuri le ore di inizio e di fine per il periodo di manutenzione, la data dei timestamp forniti vengono ignorati. Solo l'ora del giorno e la durata tra l'ora di inizio e quella di fine. Le ore sono memorizzate nel fuso orario UTC, puoi utilizzare l'UTC o la differenza del fuso orario quando pianifichi i periodi di manutenzione utilizzando l'API REST o gcloud CLI.

Quando configuri la ricorrenza, tieni presente che RRULE segue i giorni UTC, quindi regolarti di conseguenza se il fuso orario è diverso. Ad esempio, se il tuo fuso orario è PDT (UTC-7) e vuoi che il periodo di manutenzione inizi alle 21:00 di mercoledì in il tuo fuso orario (che corrisponde alle 04:00 UTC il giovedì), specifica TH anziché WE nell'opzione BYDAY della regola.

Rimuovi il periodo di manutenzione per un'istanza

Console

Per rimuovere il periodo di manutenzione in un'istanza esistente in nella console Google Cloud, segui questi passaggi:

  1. Vai alla pagina Istanze di Cloud Data Fusion.

    Vai a Istanze

  2. Fai clic sul nome dell'istanza per visualizzare i dettagli dell'istanza.

  3. Nella pagina Dettagli istanza, vai al Periodo di manutenzione e fai clic su Modifica.

  4. Per rimuovere il periodo di manutenzione dall'istanza, cancella Casella di controllo Abilita periodo di manutenzione.

  5. Fai clic su Salva.

API REST

Per rimuovere il periodo di manutenzione da un'istanza, passa una manutenzione vuota nel corpo della richiesta.

// PATCH https://datafusion.googleapis.com/v1/projects/example-project/locations/us-central1/instances/example-instance?updateMask=maintenance_policy

{
    "maintenancePolicy": {}
}

gcloud

Per rimuovere il periodo di manutenzione da un'istanza, utilizza gcloud beta data-fusion instances update con il flag --clear-maintenance-window.

gcloud beta data-fusion instances update INSTANCE_NAME \
    --project=PROJECT_NAME \
    --location=LOCATION \
    --clear-maintenance-window

Sostituisci quanto segue:

  • INSTANCE_NAME: il nome dell'istanza.
  • PROJECT_NAME: il nome del progetto.
  • LOCATION: il nome della regione dell'istanza.

Passaggi successivi