Gestisci backup

Questa pagina descrive come eseguire le operazioni di backup di Memorystore for Valkey. Prima di leggere questa pagina, assicurati di avere familiarità con i backup.

Prima di iniziare

  1. Assicurati che tu o l'account utente che stai utilizzando disponiate delle autorizzazioni richieste per l'azione che devi eseguire.

    I ruoli Amministratore Memorystore e Editor Memorystore possono eseguire tutte le operazioni di backup. Il ruolo Visualizzatore Memorystore può visualizzare ed esportare i backup.

  2. Installa e aggiorna Google Cloud CLI.

Crea un backup on demand

Per creare un backup on demand, utilizza il comando gcloud memorystore instances backup.

gcloud

gcloud memorystore instances backup INSTANCE_ID \
--backup-id=BACKUP_ID \
--ttl=TTL_PERIOD \
--project=PROJECT_ID \
--location=REGION_ID

Sostituisci quanto segue:

  • INSTANCE_ID: l'ID dell'istanza Memorystore for Valkey.
  • BACKUP_ID: un ID per il backup, ad esempio march-2025-backup.

  • TTL_PERIOD: un durata (TTL) per il backup. Quando il backup raggiunge il limite TTL, Memorystore for Valkey lo elimina automaticamente.

    Imposti il valore di questo parametro su un numero di giorni (ad esempio, 14d). Il valore minimo è 1 giorno. Se non specifichi un valore, il valore predefinito è 100 anni.

  • PROJECT_ID: il tuo ID progetto.

  • REGION_ID: la regione in cui si trova l'istanza (ad esempio, us-east1).

Il comando restituisce un nome dell'operazione nel seguente formato:

projects/PROJECT_ID/locations/REGION_ID/operations/operation-UID

Per controllare lo stato di un'operazione, utilizza il comando gcloud memorystore operations describe.

gcloud memorystore operations describe projects/PROJECT_ID/locations/REGION_ID/operations/operation-UID

Per elencare tutte le operazioni in un progetto e in una regione, utilizza il comando gcloud memorystore operations list.

gcloud memorystore operations list --projects=PROJECT_ID \
--location=REGION_ID

Configurare le pianificazioni di backup automatico

Puoi configurare una pianificazione dei backup giornalieri quando crei un'istanza oppure puoi attivare una pianificazione dei backup giornalieri su un'istanza esistente.

Crea un'istanza con una pianificazione dei backup automatici abilitata

Il seguente esempio mostra come impostare una pianificazione di backup giornaliera durante la creazione di un'istanza. Per altre opzioni disponibili durante la creazione di istanze, consulta Crea un'istanza.

gcloud

gcloud memorystore instances create INSTANCE_ID \
--automated-backup-mode=ENABLED \
--automated-backup-start-time=START_TIME \
--automated-backup-ttl=RETENTION_POLICY

Sostituisci quanto segue:

  • INSTANCE_ID: l'ID dell'istanza Memorystore for Valkey che stai creando.
  • START_TIME: l'ora in cui Memorystore for Valkey inizia a eseguire i backup. Specifica l'ora nel formato HH in un ciclo di 24 ore nel fuso orario UTC. Ad esempio: 23.

  • RETENTION_POLICY: il numero di giorni per cui Memorystore for Valkey conserva ogni backup. Imposta il valore di questo parametro su un numero di giorni (ad esempio, 7d). Il valore massimo è 365 giorni e il valore predefinito è 35 giorni.

    Anche dopo aver eliminato l'istanza, Memorystore for Valkey conserva il backup per il periodo di conservazione, con un massimo di 365 giorni. Per rimuovere il backup prima della scadenza del periodo di conservazione, devi eliminarlo manualmente.

Abilitare i backup pianificati su un'istanza esistente

Per abilitare i backup pianificati su un'istanza, utilizza il comando gcloud memorystore instances update.

gcloud

gcloud memorystore instances update INSTANCE_ID \
--automated-backup-mode=enabled \
--automated-backup-start-time=START_TIME \
--automated-backup-ttl=RETENTION_POLICY

Sostituisci quanto segue:

  • INSTANCE_ID: l'ID dell'istanza Memorystore for Valkey che stai aggiornando.
  • START_TIME: un timestamp che specifica quando Memorystore for Valkey inizia a eseguire i backup. Questo timestamp deve essere a livello orario, nel formato HH e su un ciclo di 24 ore in ora UTC (ad esempio, 23). Il timestamp indica anche un periodo di un'ora in cui Memorystore for Valkey inizia a eseguire i backup.

  • RETENTION_POLICY: il numero di giorni per cui Memorystore for Valkey conserva ogni backup. Imposta il valore di questo parametro su un numero di giorni (ad esempio, 7d).

    Anche dopo aver eliminato l'istanza, Memorystore for Valkey conserva il backup per il periodo di conservazione. Per rimuovere il backup prima della scadenza del periodo di conservazione, devi eliminarlo manualmente.

Disattivare i backup pianificati su un'istanza esistente

Per disattivare i backup pianificati su un'istanza, utilizza il comando gcloud memorystore instances update.

gcloud

gcloud memorystore instances update INSTANCE_ID \
--automated-backup-mode=disabled

Sostituisci INSTANCE_ID con l'ID dell'istanza Memorystore for Valkey che stai aggiornando.

Concorrenza con le operazioni di aggiornamento dell'istanza, manutenzione e backup

Le operazioni di aggiornamento su un'istanza e le operazioni di manutenzione possono annullare le operazioni di backup in corso nelle seguenti situazioni:

  • Se è in corso un'operazione di aggiornamento di un'istanza, Memorystore for Valkey rifiuta le richieste di operazioni di backup.
  • Se è in corso un'operazione di backup, Memorystore for Valkey rifiuta un'operazione in entrata per aggiornare un'istanza.
  • Le operazioni di manutenzione e backup potrebbero coincidere. Se ciò si verifica, Memorystore for Valkey ignora le operazioni di backup per quell'istanza.

Elencare e descrivere i backup

Le sezioni seguenti mostrano come trovare informazioni sui backup.

Elenco delle raccolte di backup

Una raccolta di backup contiene tutti i backup per un'istanza Memorystore for Valkey. Per elencare le raccolte di backup per un progetto e una regione, utilizza il comando gcloud memorystore backup-collections list.

gcloud

gcloud memorystore backup-collections list \
--project=PROJECT_ID \
--location=REGION_ID

Sostituisci quanto segue:

  • PROJECT_ID: il tuo ID progetto
  • REGION_ID: la regione in cui si trova l'istanza (ad esempio, us-east1)

Il comando restituisce un elenco di raccolte di backup.

Elenca i backup in una raccolta di backup

Per elencare i backup in una raccolta di backup, utilizza il comando gcloud memorystore backup-collections backups list.

gcloud

gcloud memorystore backup-collections backups list \
--backup-collection=BACKUP_COLLECTION
--project=PROJECT_ID \
--location=REGION_ID

Sostituisci quanto segue:

  • BACKUP_COLLECTION: il nome della raccolta di backup
  • PROJECT_ID: il tuo ID progetto
  • REGION_ID: la regione in cui si trova l'istanza (ad esempio, us-east1)

Il comando restituisce un elenco dei backup che si trovano in una raccolta di backup.

Descrivere un backup

Per recuperare informazioni su un backup, utilizza il comando gcloud memorystore backup-collections backups describe.

gcloud

gcloud memorystore backup-collections backups describe BACKUP_NAME \
--backup-collection=BACKUP_COLLECTION \
--project=PROJECT_ID \
--location=REGION_ID

Sostituisci quanto segue:

  • BACKUP_NAME: il nome del backup (ad esempio, 2024-05-01-10-15-00)
  • BACKUP_COLLECTION: il nome della raccolta di backup
  • PROJECT_ID: il tuo ID progetto
  • REGION_ID: la regione in cui si trova l'istanza (ad esempio, us-east1)

Il comando restituisce informazioni sul backup simili alle seguenti:

backupFiles:
- createTime: '2024-11-10T03:52:55.539Z'
fileName: 3d2774dab822137c5bac9386f3fa69ee4c73b928.rdb
sizeBytes: '694879680'
- createTime: '2024-11-10T03:52:54.742Z'
fileName: 7f5d99faaefc63ed8292a71da2552db3b06cdcff.rdb
sizeBytes: '694925906'
- createTime: '2024-11-10T03:52:54.972Z'
fileName: 0aac1092a3fb81515aefb6b2421f31eb346c3961.rdb
sizeBytes: '694784169'
instance: projects/PROJECT_ID/locations/us-east1/instances/instance1
instanceUid: 57130520-636c-4ac7-ad7e-86f7cfb32838
createTime: '2024-11-10T03:52:40.899882388Z'
expireTime: '2124-11-10T03:53:02.856981736Z'
name: projects/PROJECT_ID/locations/us-east1/backupCollections/dda2f551-b416-47ff-b1cf-684e00483dc9/backups/march-2025-backup
nodeType: HIGHMEM_MEDIUM
shardCount: 3
state: ACTIVE
totalSizeBytes: '2084589755'

Eliminare un backup

Per eliminare un backup, utilizza il comando gcloud memorystore backup-collections backups delete.

gcloud

gcloud memorystore backup-collections backups delete BACKUP_NAME \
--backup-collection=BACKUP_COLLECTION \
--project=PROJECT_ID \
--location=REGION_ID

Sostituisci quanto segue:

  • BACKUP_NAME: il nome del backup (ad esempio, 2024-05-01-10-15-00)
  • BACKUP_COLLECTION: il nome della raccolta di backup
  • PROJECT_ID: il tuo ID progetto
  • REGION_ID: la regione in cui si trova l'istanza (ad esempio, us-east1)

Esportare un backup in un bucket di archiviazione

Puoi esportare un backup in un bucket Cloud Storage.

I passaggi che seguono mostrano come esportare un backup.

  1. Concedi all'agente di servizio Memorystore for Valkey l'accesso alle risorse di Cloud Storage.

    Concedi all'agente di servizio l'accesso alle risorse di Cloud Storage in modo che Memorystore for Valkey possa accedere al bucket Cloud Storage di destinazione. Inoltre, l'agente di servizio Memorystore for Valkey utilizza il seguente formato di denominazione:

    service-PROJECT_NUMBER@gcp-sa-memorystore.iam.gserviceaccount.com

    Sostituisci PROJECT_NUMBER con il numero di progetto del progetto in cui si trova l'istanza o il backup.

    Concedi all'agente di servizio un ruolo che assegni le autorizzazioni storage.buckets.get, storage.objects.create, storage.objects.delete e storage.folders.create al ruolo.

    Ad esempio, il seguente comando assegna il ruolo Storage Admin all'agente di servizio per un bucket Cloud Storage:

    gcloud

    gcloud storage buckets add-iam-policy-binding gs://BUCKET_NAME \
--member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-memorystore.iam.gserviceaccount.com \
--role=roles/storage.admin

    Sostituisci quanto segue:

    • BUCKET_NAME: il nome del bucket Cloud Storage di destinazione. Questo bucket deve essere un bucket regionale e deve trovarsi nella stessa regione del backup. Memorystore for Valkey deve disporre delle autorizzazioni per accedere al bucket e per creare cartelle e oggetti al suo interno.
    • PROJECT_NUMBER: il numero di progetto utilizzato nel nome dell'agente di servizio.

  2. Per esportare un backup in un bucket Cloud Storage, utilizza il comando gcloud memorystore backup-collections backups export.

    gcloud

    gcloud memorystore backup-collections backups export BACKUP_NAME \
--backup-collection=BACKUP_COLLECTION \
--location=REGION_ID \
--gcs-bucket=BUCKET_NAME

    Sostituisci quanto segue:

    • BACKUP_NAME: il nome del backup di Memorystore for Valkey
    • BACKUP_COLLECTION: il nome della raccolta di backup
    • REGION_ID: la regione in cui si trova la raccolta di backup (ad esempio us-east1)
    • BUCKET_NAME: il nome del bucket Cloud Storage, che non ha gs:// come prefisso

Ripristinare i dati da un backup

Per ripristinare i dati da un backup, puoi inizializzare una nuova istanza da un backup gestito nello stesso progetto oppure puoi inizializzare una nuova istanza da file RDB in un bucket Cloud Storage. Per inizializzare un'istanza dai file RDB, Memorystore for Valkey deve disporre delle autorizzazioni per accedere ai file.

Inizializzare una nuova istanza da un backup

L'esempio seguente mostra come importare i dati da un backup in una nuova istanza. Il backup deve trovarsi nella stessa regione dell'istanza. Inoltre, il principal che crea l'istanza deve disporre dell'autorizzazione redis.backups.get per il backup.

gcloud

gcloud memorystore instances create INSTANCE_ID \
--import-managed-backup=BACKUP_NAME \
--location=REGION_ID

Sostituisci quanto segue:

  • INSTANCE_ID: l'ID dell'istanza Memorystore for Valkey che stai creando.
  • BACKUP_NAME: il nome del backup. Questo nome ha il seguente formato: projects/PROJECT_ID/locations/REGION_ID/backupCollections/BACKUP_COLLECTION_ID/backups/BACKUP_ID.
  • REGION_ID: la regione in cui si trova l'istanza (ad esempio, us-east1).

Inizializzare una nuova istanza dai file RDB in un bucket di archiviazione

Puoi importare i dati da file RDB, contenuti in un bucket Cloud Storage, in una nuova istanza.

I seguenti passaggi mostrano come importare i dati dai file RDB in un bucket Cloud Storage in una nuova istanza.

  1. Concedi all'agente di servizio Memorystore for Valkey l'accesso alle risorse di Cloud Storage.

    Concedi all'agente di servizio l'accesso alle risorse di Cloud Storage in modo che Memorystore for Valkey possa accedere ai file RDB che si trovano nel bucket Cloud Storage. Inoltre, l'agente di servizio Memorystore for Valkey utilizza il seguente formato di denominazione:

    service-PROJECT_NUMBER@gcp-sa-memorystore.iam.gserviceaccount.com

    Sostituisci PROJECT_NUMBER con il numero di progetto del progetto in cui crei la nuova istanza.

    Concedi all'agente di servizio un ruolo che assegni le autorizzazioni storage.buckets.get e storage.objects.get al ruolo.

    Ad esempio, il seguente comando assegna il ruolo Storage Admin all'agente di servizio per un bucket Cloud Storage:

    gcloud

    gcloud storage buckets add-iam-policy-binding gs://BUCKET_NAME
--member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-memorystore.iam.gserviceaccount.com
--role=roles/storage.admin

    Sostituisci quanto segue:

    • BUCKET_NAME: il nome del bucket in cui si trovano i file RDB. Questo bucket deve essere un bucket regionale nella stessa regione del backup oppure un bucket dual-region e avere una regione uguale a quella del backup. Memorystore for Valkey deve disporre delle autorizzazioni per accedere al bucket.
    • PROJECT_NUMBER: il numero di progetto utilizzato nel nome dell'agente di servizio.

  2. Per importare i dati dai file RDB in un bucket Cloud Storage in una nuova istanza, utilizza il comando gcloud memorystore instances create.

    gcloud

    gcloud memorystore instances create INSTANCE_ID \
--import-gcs-object-uris=URI \
--location=REGION_ID

    Sostituisci quanto segue:

    • INSTANCE_ID: l'ID dell'istanza Memorystore for Valkey che stai creando.
    • URI: uno o più URI (Uniform Resource Identifier) Cloud Storage separati da virgole. Ad esempio: gs://my-bucket/folder/file1.rdb,gs://my-bucket/folder/file2.rdb.
    • REGION_ID: la regione in cui si trova l'istanza (ad esempio, us-east1).

Metriche di Cloud Monitoring

Per monitorare le operazioni di backup e importazione recenti, puoi utilizzare le metriche di Cloud Monitoring. Per un elenco delle metriche disponibili per i backup di Memorystore for Valkey, consulta Metriche di backup.