Configura periodi di manutenzione

I periodi di manutenzione in Cloud Data Fusion consentono di controllare quando si verificano gli aggiornamenti automatici e la manutenzione di routine. L'impostazione di intervalli di tempo designati consente di prevenire interruzioni del servizio durante le ore di punta operative.

I periodi di manutenzione sono supportati per le istanze Cloud Data Fusion nelle 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 consenti al servizio di eseguire operazioni di manutenzione, riducendo il rischio di interruzioni del servizio durante le ore di punta. La pianificazione dei periodi di manutenzione durante le ore non di punta o quando l'attività è inferiore riduce al minimo l'impatto sulle istanze Cloud Data Fusion e sulle esecuzioni delle pipeline.

La configurazione dei periodi di manutenzione ti consente di controllare quando si verificano le operazioni di manutenzione nella tua istanza:

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

Informazioni sulle operazioni di manutenzione

Per garantire la sicurezza e la conformità del sistema, Cloud Data Fusion esegue regolarmente operazioni di manutenzione. Queste operazioni includono l'applicazione di aggiornamenti critici e patch di sicurezza per mitigare le vulnerabilità e proteggere i dati degli utenti. I periodi di manutenzione pianificati garantiscono che gli aggiornamenti vengano applicati in modo efficiente, preservando l'integrità del sistema e riducendo al minimo le interruzioni delle istanze e delle esecuzioni delle pipeline.

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

  • Durante le ore del periodo di manutenzione, alcune operazioni potrebbero essere interessate. Ti consigliamo di avere periodi di manutenzione durante le ore di utilizzo non di punta. L'operazione di manutenzione può influire su Cloud Data Fusion nei seguenti modi:

    • L'interfaccia di Cloud Data Fusion Studio potrebbe non essere disponibile temporaneamente.
    • L'esecuzione della pipeline potrebbe essere interessata, causando un errore.
    • I servizi Cloud Data Fusion potrebbero essere temporaneamente inattivi, causando errori nelle chiamate API.
    • Le istanze potrebbero non essere completamente funzionali per un massimo di un'ora durante le ore del periodo di manutenzione. Ti consigliamo di configurare i periodi di manutenzione quando le pipeline non sono in esecuzione o non sono pianificate per l'esecuzione.

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

Console

Per impostare il periodo di manutenzione durante la creazione di un'istanza:

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

    Crea un'istanza

  2. Inserisci un Nome istanza e un'Edizione. Per ulteriori informazioni su 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. Nell'elenco TimeZone, seleziona un fuso orario.
    4. Negli elenchi Giorni e Durata, seleziona i giorni della settimana e la durata del periodo. Per ulteriori informazioni su queste impostazioni, consulta Informazioni sulle operazioni di manutenzione.
    5. Fai clic su Crea.

Per ulteriori informazioni, consulta Configurare gli orari e la ricorrenza (RRULE) del periodo di manutenzione.

API REST

  1. Imposta la configurazione di 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 del periodo, nel formato RFC 3339.
  • END_TIME: ora di fine del periodo, nel formato RFC 3339.

  • MAINTENANCE_RECURRENCE: una 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. Specifica la ricorrenza settimanale del periodo nei giorni selezionati, a partire da startTime e per la durata specificata.

Per ulteriori informazioni, consulta Configurare gli orari e la ricorrenza (RRULE) del periodo di manutenzione.

L'esempio seguente crea un'istanza con un periodo di manutenzione di sei ore tra le 10:00 e le 16:00 (UTC) ogni sabato e domenica. Per ulteriori 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 gcloud beta data-fusion instances create comando.

Per un periodo di manutenzione devono essere definiti i seguenti parametri:

  • --maintenance-window-start imposta l'ora di inizio del periodo.
  • --maintenance-window-end imposta l'ora di fine del periodo.
  • --maintenance-window-recurrence imposta una 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 del periodo nel formato di input di data/ora. Viene utilizzata solo l'ora del giorno specificata, la data specificata viene ignorata.
  • END_TIME: l'ora di fine del periodo nel formato di input di data/ora. Viene utilizzata solo l'ora del giorno specificata, la data specificata viene ignorata. La data e l'ora specificate devono essere successive all'ora di inizio.

  • MAINTENANCE_RECURRENCE: una 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. Specifica la ricorrenza settimanale del periodo nei giorni selezionati, a partire dall'ora --maintenance-window-start e per la durata specificata.

Per ulteriori informazioni, consulta Configurare gli orari e la ricorrenza (RRULE) del periodo di manutenzione.

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

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'

Aggiornare i periodi di manutenzione per un'istanza

Console

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

  1. Vai alla pagina Istanze di Cloud Data Fusion.

    Vai a Istanze

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

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

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

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

  5. Fai clic su Salva.

Per ulteriori informazioni, consulta Configurare gli orari e la ricorrenza (RRULE) del periodo di manutenzione.

API REST

Per le istanze esistenti, aggiorna i periodi di manutenzione utilizzando la instances.patch richiesta API. Se presente, questa operazione sostituisce la configurazione del periodo di manutenzione esistente. In caso contrario, viene impostata una nuova configurazione, come indicato nel corpo della richiesta.

Costruisci 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 della policy di manutenzione:
{
  "maintenancePolicy": {
    "maintenanceWindow": {
        "recurringTimeWindow": {
          "window": {
              "startTime": "START_TIME",
              "endTime": "END_TIME"
          },
          "recurrence": "MAINTENANCE_RECURRENCE"
        }
    },
  }
}

Per ulteriori informazioni, consulta Configurare gli orari e la ricorrenza (RRULE) del periodo di manutenzione.

L'esempio seguente aggiorna la configurazione della policy di manutenzione dell'istanza con un periodo di manutenzione di quattro ore tra le 11:00 e le 15:00 (UTC) ogni venerdì, sabato e 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 gcloud beta data-fusion instances update comando.

Per un periodo di manutenzione devono essere definiti i seguenti parametri:

  • --maintenance-window-start imposta l'ora di inizio del periodo.
  • --maintenance-window-end imposta l'ora di fine del periodo.
  • --maintenance-window-recurrence imposta una 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 del periodo nel formato di input di data/ora. Viene utilizzata solo l'ora del giorno specificata, la data specificata viene ignorata.
  • END_TIME: l'ora di fine del periodo nel formato di input di data/ora. Viene utilizzata solo l'ora del giorno specificata, la data specificata viene ignorata. La data e l'ora specificate devono essere successive all'ora di inizio.

  • MAINTENANCE_RECURRENCE: una 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. Specifica la ricorrenza settimanale del periodo nei giorni selezionati, a partire dall'ora --maintenance-window-start e per la durata specificata.

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

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'

Configurare gli orari e la ricorrenza (RRULE) del periodo di manutenzione

Quando configuri le ore di inizio e di fine per il periodo di manutenzione, i componenti della data dei timestamp forniti vengono ignorati. Vengono presi in considerazione solo l'ora del giorno e la durata tra l'ora di inizio e l'ora di fine. Le ore vengono archiviate in formato UTC, ma puoi utilizzare l'offset UTC o 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 modificali di conseguenza se il fuso orario è diverso. Ad esempio, se il fuso orario è PDT (UTC-7) e vuoi che un periodo di manutenzione inizi alle 21:00 di mercoledì nel tuo fuso orario (che corrisponde alle 04:00 UTC di giovedì), specifica TH anziché WE nell'opzione BYDAY di RRULE.

Rimuovere il periodo di manutenzione per un'istanza

Console

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

  1. Vai alla pagina Istanze di Cloud Data Fusion.

    Vai a Istanze

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

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

  4. Per rimuovere il periodo di manutenzione dall'istanza, deseleziona la casella di controllo Abilita periodo di manutenzione.

  5. Fai clic su Salva.

API REST

Per rimuovere il periodo di manutenzione da un'istanza, passa un oggetto della policy di manutenzione vuoto 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 il gcloud beta data-fusion instances update comando con il --clear-maintenance-window flag.

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.

Visualizzare gli eventi di manutenzione e ricevere notifiche

Cloud Data Fusion segnala gli eventi di manutenzione pianificati per le tue istanze tramite Unified Maintenance. Per visualizzare questi eventi e ricevere notifiche, devi configurare ciascuno separatamente:

Abilitare l'API Unified Maintenance

Per visualizzare gli eventi di manutenzione nella Google Cloud console, abilita l' API Unified Maintenance (maintenance.googleapis.com) nel tuo progetto. Unified Maintenance non mostra gli eventi storici pianificati prima dell'abilitazione dell'API.

Console

  1. Nella Libreria API, vai alla pagina API Maintenance.

    Vai all'API Maintenance

  2. Fai clic su Attiva.

gcloud

Utilizza il gcloud services enable comando:

gcloud services enable maintenance.googleapis.com \
    --project=PROJECT_ID

Sostituisci PROJECT_ID con l'ID progetto.

Configurare le notifiche

Unified Maintenance scrive automaticamente i log degli eventi di manutenzione con l'ID log maintenance.googleapis.com/maintenance_events in Logging, indipendentemente dal fatto che l'API Unified Maintenance sia abilitata. Per ricevere notifiche tramite canali come email, Pub/Sub, Slack, PagerDuty o webhook, crea policy di avviso basate su log che corrispondano a questi log. Per ulteriori informazioni, consulta Configurare avvisi e notifiche.

Passaggi successivi