Administrar copias de seguridad

En esta página, se describe cómo realizar operaciones de copia de seguridad de Memorystore para Valkey. Antes de leer esta página, asegúrate de estar familiarizado con las copias de seguridad.

Antes de comenzar

  1. Asegúrate de que tú o la cuenta de usuario que usas tengan los permisos necesarios para la acción que debes realizar.

    Los roles de administrador de Memorystore y editor de Memorystore pueden realizar todas las operaciones de copia de seguridad. El rol de Visualizador de Memorystore puede ver y exportar copias de seguridad.

  2. Instala y actualiza Google Cloud CLI.

Crea una copia de seguridad según demanda

Para crear una copia de seguridad según demanda, usa el comando gcloud memorystore instances backup.

gcloud

gcloud memorystore instances backup INSTANCE_ID \
--backup-id=BACKUP_ID \
--ttl=TTL_PERIOD

Reemplaza lo siguiente:

  • INSTANCE_ID: El ID de Memorystore para la instancia de Valkey.
  • BACKUP_ID: Un ID para la copia de seguridad, como march-2025-backup.

  • TTL_PERIOD: Un tiempo de actividad (TTL) para la copia de seguridad. Después de que la copia de seguridad alcance el límite de TTL, Memorystore para Valkey la borrará automáticamente.

    El valor de este parámetro se establece en una cantidad de días (por ejemplo, 14d). El valor mínimo es de 1 día. Si no especificas un valor, el valor predeterminado es de 100 años.

El comando muestra un nombre de operación con el siguiente formato:

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

Para verificar el estado de una operación, usa el comando gcloud memorystore operations describe.

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

Para enumerar todas las operaciones de un proyecto y una región, usa el comando gcloud memorystore operations list.

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

Configura programaciones de copias de seguridad automáticas

Puedes configurar un programa de copias de seguridad diarias cuando creas una instancia o puedes habilitar un programa de copias de seguridad diarias en una instancia existente.

Crea una instancia con una programación de copia de seguridad automática habilitada

En el siguiente ejemplo, se muestra cómo configurar un programa de copia de seguridad diaria a medida que creas una instancia. Para obtener más opciones disponibles cuando creas instancias, consulta Crea una instancia.

gcloud

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

Reemplaza lo siguiente:

  • INSTANCE_ID: Es el ID de la instancia de Memorystore for Valkey que creas.
  • START_TIME: Es la hora en la que Memorystore para Valkey comienza a crear copias de seguridad. Especifica la hora en el formato HH en un ciclo de 24 horas en la hora UTC. Por ejemplo: 23.

  • RETENTION_POLICY: Es la cantidad de días durante los cuales Memorystore for Firebase retiene cada copia de seguridad. Establece el valor de este parámetro en una cantidad de días (por ejemplo, 7d). El valor máximo es de 365 días y el valor predeterminado es de 35 días.

    Incluso después de borrar la instancia, Memorystore for Valkey retiene la copia de seguridad durante el período de retención, con un máximo de 365 días. Para quitar la copia de seguridad antes de que venza el período de retención, debes borrarla de forma manual.

Habilita las copias de seguridad programadas en una instancia existente

Para habilitar las copias de seguridad programadas en una instancia, usa el 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

Reemplaza lo siguiente:

  • INSTANCE_ID: Es el ID de la instancia de Memorystore for Valkey que actualizas.
  • START_TIME: Una marca de tiempo que especifica cuándo Memorystore for Valkey comienza a crear copias de seguridad. Esta marca de tiempo debe estar a nivel de la hora, en el formato HH y en un ciclo de 24 horas en la hora UTC (por ejemplo, 23). La marca de tiempo también designa un período de una hora en el que Memorystore for Valkey comienza a crear copias de seguridad.

  • RETENTION_POLICY: Es la cantidad de días durante los cuales Memorystore for Firebase retiene cada copia de seguridad. Establece el valor de este parámetro en una cantidad de días (por ejemplo, 7d).

    Incluso después de borrar la instancia, Memorystore for Valkey retiene la copia de seguridad durante el período de retención. Para quitar la copia de seguridad antes de que venza el período de retención, debes borrarla de forma manual.

Cómo desactivar las copias de seguridad programadas en una instancia existente

Para desactivar las copias de seguridad programadas en una instancia, usa el comando gcloud memorystore instances update.

gcloud

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

Reemplaza INSTANCE_ID por el ID de la instancia de Memorystore for Valkey que estás actualizando.

Concurrencia con operaciones de actualización de instancias, mantenimiento y copias de seguridad

Las operaciones de actualización en una instancia y las operaciones de mantenimiento pueden cancelar las operaciones de copia de seguridad en curso en las siguientes situaciones:

  • Si hay una operación en curso para actualizar una instancia, Memorystore for Valkey rechaza las solicitudes de operaciones de copia de seguridad.
  • Si hay una operación de copia de seguridad en curso, entonces, Memorystore for Valkey rechazará una operación entrante para actualizar una instancia.
  • Es posible que las operaciones de mantenimiento y de copia de seguridad coincidan entre sí. Si esto ocurre, entonces Memorystore para Valkey omite las operaciones de copia de seguridad de esa instancia.

Enumera y describe las copias de seguridad

En las siguientes secciones, se muestra cómo encontrar información sobre las copias de seguridad.

Enumera las colecciones de copias de seguridad

Una colección de copias de seguridad contiene todas las copias de seguridad de una instancia de Memorystore para Valkey. Para enumerar las colecciones de copias de seguridad de un proyecto y una región, usa el comando gcloud memorystore backup-collections list.

gcloud

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

Reemplaza lo siguiente:

  • PROJECT_ID: El ID de tu proyecto
  • REGION_ID: Es la región en la que se encuentra la instancia (por ejemplo, us-east1).

El comando muestra una lista de colecciones de copias de seguridad.

Cómo enumerar las copias de seguridad de una colección de copias de seguridad

Para enumerar las copias de seguridad de una colección, usa el comando gcloud memorystore backup-collections backups list.

gcloud

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

Reemplaza lo siguiente:

  • BACKUP_COLLECTION: Es el nombre de la colección de copias de seguridad.
  • PROJECT_ID: El ID de tu proyecto
  • REGION_ID: Es la región en la que se encuentra la instancia (por ejemplo, us-east1).

El comando muestra una lista de las copias de seguridad que se encuentran en una colección de copias de seguridad.

Describe una copia de seguridad

Para recuperar información sobre una copia de seguridad, usa el 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

Reemplaza lo siguiente:

  • BACKUP_NAME: Es el nombre de la copia de seguridad (por ejemplo, 2024-05-01-10-15-00).
  • BACKUP_COLLECTION: Es el nombre de la colección de copias de seguridad.
  • PROJECT_ID: El ID de tu proyecto
  • REGION_ID: Es la región en la que se encuentra la instancia (por ejemplo, us-east1).

El comando muestra información sobre la copia de seguridad que es similar a la siguiente:

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'

Borrar una copia de seguridad

Para borrar una copia de seguridad, usa el 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

Reemplaza lo siguiente:

  • BACKUP_NAME: Es el nombre de la copia de seguridad (por ejemplo, 2024-05-01-10-15-00).
  • BACKUP_COLLECTION: Es el nombre de la colección de copias de seguridad.
  • PROJECT_ID: El ID de tu proyecto
  • REGION_ID: Es la región en la que se encuentra la instancia (por ejemplo, us-east1).

Cómo exportar una copia de seguridad a un bucket de almacenamiento

Puedes exportar una copia de seguridad a un bucket de Cloud Storage.

En los siguientes pasos, se muestra cómo exportar una copia de seguridad.

  1. Otorga al agente de servicio de Memorystore para Valkey acceso a los recursos de Cloud Storage.

    Otorgas acceso al agente de servicio a los recursos de Cloud Storage para que Memorystore para Valkey pueda acceder al bucket de Cloud Storage de destino. Además, el agente de servicio de Memorystore para Valkey usa el siguiente formato de nombres:

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

    Reemplaza PROJECT_NUMBER por el número de proyecto del proyecto en el que se encuentra la instancia o la copia de seguridad.

    Otorga al agente de servicio un rol que le asigne los permisos storage.buckets.get, storage.objects.create, storage.objects.delete y storage.folders.create.

    Por ejemplo, el siguiente comando asigna el rol Storage Admin al agente de servicio de un bucket de 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

    Reemplaza lo siguiente:

    • BUCKET_NAME: El nombre del bucket de Cloud Storage de destino. Este bucket debe ser regional y estar en la misma región que la copia de seguridad. Memorystore for Valkey debe tener permisos para acceder al bucket y crear carpetas y objetos dentro de él.
    • PROJECT_NUMBER: Es el número de proyecto que se usa en el nombre del agente de servicio.

  2. Para exportar una copia de seguridad a un bucket de Cloud Storage, usa el 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

    Reemplaza lo siguiente:

    • BACKUP_NAME: Es el nombre de la copia de seguridad de Memorystore para Valkey.
    • BACKUP_COLLECTION: Es el nombre de la colección de copias de seguridad.
    • REGION_ID: Es la región en la que se encuentra la colección de copias de seguridad (por ejemplo, us-east1).
    • BUCKET_NAME: Es el nombre del bucket de Cloud Storage.

Restablece datos a partir de una copia de seguridad

Para restablecer datos desde una copia de seguridad, puedes crear una instancia nueva a partir de una copia de seguridad administrada en el mismo proyecto o a partir de archivos RDB en un bucket de Cloud Storage. Para activar una instancia a partir de archivos RDB, Memorystore para Valkey debe tener permisos para acceder a los archivos.

Cómo crear una instancia nueva a partir de una copia de seguridad

En el siguiente ejemplo, se muestra cómo importar datos de una copia de seguridad a una instancia nueva. La copia de seguridad debe estar en la misma región que la instancia. Además, el principal que crea la instancia debe tener el permiso redis.backups.get para la copia de seguridad.

gcloud

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

Reemplaza lo siguiente:

  • INSTANCE_ID: Es el ID de la instancia de Memorystore for Valkey que creas.
  • BACKUP_NAME: Es el nombre de la copia de seguridad. Este nombre tiene el siguiente formato: projects/PROJECT_ID/locations/REGION_ID/backupCollections/BACKUP_COLLECTION_ID/backups/BACKUP_ID.
  • REGION_ID: Es la región en la que se encuentra la instancia (por ejemplo, us-east1).

Cómo propagar una instancia nueva a partir de archivos de RDB en un bucket de almacenamiento

Puedes importar datos de archivos de RDB, que se encuentran en un bucket de Cloud Storage, a una instancia nueva.

En los siguientes pasos, se muestra cómo importar datos de archivos RDB en un bucket de Cloud Storage a una instancia nueva.

  1. Otorga al agente de servicio de Memorystore para Valkey acceso a los recursos de Cloud Storage.

    Otorgas acceso al agente de servicio a los recursos de Cloud Storage para que Memorystore para Valkey pueda acceder a los archivos de RDB que se encuentran en el bucket de Cloud Storage. Además, el agente de servicio de Memorystore para Valkey usa el siguiente formato de nombres:

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

    Reemplaza PROJECT_NUMBER por el número de proyecto del proyecto en el que creas la instancia nueva.

    Otorga al agente de servicio un rol que le asigne los permisos storage.buckets.get y storage.objects.get.

    Por ejemplo, el siguiente comando asigna el rol Storage Admin al agente de servicio de un bucket de 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

    Reemplaza lo siguiente:

    • BUCKET_NAME: Es el nombre del bucket en el que se encuentran los archivos RDB. Este bucket debe ser un bucket regional en la misma región que la copia de seguridad o un bucket birregional en el que una de las regiones sea la misma que la copia de seguridad. Memorystore para Valkey debe tener permisos para acceder al bucket.
    • PROJECT_NUMBER: Es el número de proyecto que se usa en el nombre del agente de servicio.

  2. Para importar datos de archivos RDB en un bucket de Cloud Storage a una instancia nueva, usa el comando gcloud memorystore instances create.

    gcloud

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

    Reemplaza lo siguiente:

    • INSTANCE_ID: Es el ID de la instancia de Memorystore for Valkey que creas.
    • URI: Uno o más identificadores de recursos uniformes (URIs) de Cloud Storage separados por comas. Por ejemplo: gs://my-bucket/folder/file1.rdb,gs://my-bucket/folder/file2.rdb.
    • REGION_ID: Es la región en la que se encuentra la instancia (por ejemplo, us-east1).

Métricas de Cloud Monitoring

Para supervisar las operaciones de copia de seguridad y de importación recientes, puedes usar las métricas de Cloud Monitoring. Para obtener una lista de las métricas disponibles para las copias de seguridad de Memorystore for Valkey, consulta Métricas de copia de seguridad.