Gerenciar backups

Nesta página, descrevemos como realizar operações de backup do Memorystore para Valkey. Antes de ler esta página, familiarize-se com os backups.

Antes de começar

1. Confira 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 da Memorystore e Editor da Memorystore podem realizar todas as operações de backup. A função 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 \
--project=PROJECT_ID \
--location=REGION_ID

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áticas

É 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ário 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 atual

Para ativar 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 atual

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

Simultaneidade 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 solicitações de operação de backup.
• Se houver uma operação de backup em andamento, o Memorystore para Valkey vai rejeitar uma operação de atualização de 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 dessa instância.

Listar e descrever backups

As seções a seguir mostram 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 uma 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 de backups

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 a função 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. Ele 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 for Valkey
   • BACKUP_COLLECTION: o nome da coleção de backups.
   • 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, que não tem gs:// como prefixo

Restaurar dados de um backup

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

Propagar uma nova instância 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

Propagar uma nova instância de arquivos RDB em um bucket de armazenamento

É possível importar dados de arquivos RDB 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 para 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.

   Por exemplo, o comando a seguir atribui a função 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 birregional com uma região igual à do 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 for 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 as operações recentes de backup e importação, use as métricas do Cloud Monitoring. Para uma lista de métricas disponíveis para backups do Memorystore para Valkey, consulte Métricas de backup.