Gerenciar backups

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Esta página descreve como realizar operações de backup do Memorystore para Valkey. Antes de ler esta página, confira se você conhece os backups.

Antes de começar

1. Verifique se você ou a conta de usuário que está usando têm as permissões necessárias para a ação que você precisa realizar.

   As funções Administrador do Memorystore e Editor do Memorystore podem realizar todas as operações de backup. O papel Leitor do Memorystore pode visualizar e exportar backups.

2. Instale e atualize a Google Cloud CLI.

Criar um backup sob demanda

Para criar um backup sob demanda, use o comando gcloud memorystore instances backup.

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

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

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

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

Configurar programações de backup automático

É possível configurar uma programação de backup diário ao criar uma instância ou ativar uma programação de backup diário em uma instância atual.

Criar uma instância com uma programação de backup automático ativada

O exemplo a seguir demonstra como definir uma programação de backup diária ao criar uma instância. Para mais opções disponíveis ao criar instâncias, consulte Criar uma instância.

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

Ativar backups programados em uma instância

Para ativar os backups programados em uma instância, use o comando gcloud memorystore instances update.

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

Desativar backups programados em uma instância

Para desativar os backups programados em uma instância, use o comando gcloud memorystore instances update.

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

Concorrência com operações de atualização de instância, manutenção e backup

As operações de atualização em uma instância e as operações de manutenção podem cancelar operações de backup em andamento nas seguintes situações:

• Se houver uma operação em andamento para atualizar uma instância, o Memorystore para Valkey vai rejeitar as solicitações de operação de backup.
• Se houver uma operação de backup em andamento, o Memorystore para Valkey rejeitará uma operação de entrada para atualizar uma instância.
• As operações de manutenção e backup podem coincidir. Se isso acontecer, o Memorystore para Valkey vai pular as operações de backup para essa instância.

Listar e descrever backups

As seções a seguir demonstram como encontrar informações sobre backups.

Listar coleções de backup

Uma coleção de backups contém todos os backups de uma instância do Memorystore para Valkey. Para listar as coleções de backup de um projeto e região, use o comando gcloud memorystore backup-collections list.

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

Listar os backups em uma coleção

Para listar os backups em uma coleção, use o comando gcloud memorystore backup-collections backups list.

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

Descrever um backup

Para recuperar informações sobre um backup, use o comando gcloud memorystore backup-collections backups describe.

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

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'

Excluir um backup

Para excluir um backup, use o comando gcloud memorystore backup-collections backups delete.

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

Exportar um backup para um bucket de armazenamento

É possível exportar um backup para um bucket do Cloud Storage.

As etapas a seguir demonstram como exportar um backup.

1. Conceda ao agente de serviço do Memorystore para Valkey acesso aos recursos do Cloud Storage.

   Você concede ao agente de serviço acesso aos recursos do Cloud Storage para que o Memorystore para Valkey possa acessar o bucket de destino do Cloud Storage. Além disso, o agente de serviço do Memorystore para Valkey usa o seguinte formato de nomenclatura:

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

   Substitua PROJECT_NUMBER pelo número do projeto em que a instância ou o backup está localizado.

   Conceda ao agente de serviço um papel que atribua as permissões storage.buckets.get, storage.objects.create, storage.objects.delete e storage.folders.create ao papel.

   Por exemplo, o comando a seguir atribui o papel Storage Admin ao agente de serviço de um bucket do 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
   

   Substitua:

   • BUCKET_NAME: o nome do bucket de destino do Cloud Storage. Esse bucket precisa ser regional e estar na mesma região que o backup. O Memorystore para Valkey precisa ter permissões para acessar o bucket e criar pastas e objetos dentro dele.
   • PROJECT_NUMBER: o número do projeto usado no nome do agente de serviço.

2. Para exportar um backup para um bucket do Cloud Storage, use o 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
   

   Substitua:

   • BACKUP_NAME: o nome do backup do Memorystore para Valkey
   • BACKUP_COLLECTION: o nome da coleção de backup
   • REGION_ID: a região em que a coleção de backups está localizada (por exemplo, us-east1)
   • BUCKET_NAME: o nome do bucket do Cloud Storage

Restaurar dados de um backup

Para restaurar dados de um backup, é possível gerar uma nova instância de um backup gerenciado no mesmo projeto ou de arquivos RDB em um bucket do Cloud Storage. Para gerar uma instância de arquivos RDB, o Memorystore para Valkey precisa ter permissões para acessar os arquivos.

Gerar uma nova instância a partir de um backup

O exemplo a seguir demonstra como importar dados de um backup para uma nova instância. O backup precisa estar na mesma região que a instância. Além disso, o principal que cria a instância precisa ter a permissão redis.backups.get para o backup.

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

Gerar uma nova instância a partir de arquivos RDB em um bucket de armazenamento

É possível importar dados de arquivos RDB, que estão contidos em um bucket do Cloud Storage, para uma nova instância.

As etapas a seguir demonstram como importar dados de arquivos RDB em um bucket do Cloud Storage para uma nova instância.

1. Conceda ao agente de serviço do Memorystore para Valkey acesso aos recursos do Cloud Storage.

   Você concede ao agente de serviço acesso aos recursos do Cloud Storage para que o Memorystore for Valkey possa acessar os arquivos RDB que estão no bucket do Cloud Storage. Além disso, o agente de serviço do Memorystore para Valkey usa o seguinte formato de nomenclatura:

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

   Substitua PROJECT_NUMBER pelo número do projeto em que você cria a nova instância.

   Conceda ao agente de serviço um papel que atribua as permissões storage.buckets.get e storage.objects.get ao papel.

   Por exemplo, o comando a seguir atribui o papel Storage Admin ao agente de serviço de um bucket do 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
   

   Substitua:

   • BUCKET_NAME: o nome do bucket em que os arquivos RDB estão localizados. Esse bucket precisa ser regional na mesma região do backup ou ser um bucket birregional e ter uma região igual ao backup. O Memorystore para Valkey precisa ter permissões para acessar o bucket.
   • PROJECT_NUMBER: o número do projeto usado no nome do agente de serviço.

2. Para importar dados de arquivos RDB em um bucket do Cloud Storage para uma nova instância, use o comando gcloud memorystore instances create.

   gcloud

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

   Substitua:

   • INSTANCE_ID: o ID da instância do Memorystore para Valkey que você está criando.
   • URI: um ou mais identificadores uniformes de recursos (URIs) do Cloud Storage separados por vírgulas. Por exemplo, gs://my-bucket/folder/file1.rdb,gs://my-bucket/folder/file2.rdb.
   • REGION_ID: a região em que a instância está localizada (por exemplo, us-east1).

Métricas do Cloud Monitoring

Para monitorar operações recentes de backup e importação, use as métricas do Cloud Monitoring. Para conferir uma lista de métricas disponíveis para backups do Memorystore para Valkey, consulte Métricas de backup.