Esta página descreve como realizar operações de cópia de segurança do Memorystore for Valkey. Antes de ler esta página, certifique-se de que conhece as cópias de segurança.
Antes de começar
Certifique-se de que tem ou que a conta de utilizador que está a usar tem as autorizações necessárias para a ação que tem de realizar.
As funções Administrador do Memorystore e Editor do Memorystore podem realizar todas as operações de cópia de segurança. A função Visualizador do Memorystore pode ver e exportar cópias de segurança.
Crie uma cópia de segurança a pedido
Para criar uma cópia de segurança a pedido, use o 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
Substitua o seguinte:
- INSTANCE_ID: o ID da instância do Memorystore for Valkey.
- BACKUP_ID: um ID para a cópia de segurança, como
march-2025-backup. TTL_PERIOD: um tempo de vida (TTL) para a cópia de segurança. Depois de a cópia de segurança atingir o limite de TTL, o Memorystore for Valkey elimina automaticamente a cópia de segurança.
Define o valor deste parâmetro para um número de dias (por exemplo,
14d). O valor mínimo é 1 dia. Se não especificar um valor, o valor predefinido é de 100 anos.PROJECT_ID: o ID do seu projeto.
REGION_ID: a região onde a sua instância está localizada (por exemplo,
us-east1).
O comando devolve um nome da operação com o seguinte formato:
projects/PROJECT_ID/locations/REGION_ID/operations/operation-UID
Para verificar o estado de uma operação, use o comando
gcloud memorystore operations describe.
gcloud memorystore operations describe projects/PROJECT_ID/locations/REGION_ID/operations/operation-UID
Para apresentar uma lista de todas as operações num projeto e numa região, use o comando
gcloud memorystore operations list.
gcloud memorystore operations list --projects=PROJECT_ID \ --location=REGION_ID
Configure programações de cópias de segurança automáticas
Pode configurar um agendamento de cópias de segurança diárias quando cria uma instância ou pode ativar um agendamento de cópias de segurança diárias numa instância existente.
Crie uma instância com um agendamento de cópias de segurança automatizado ativado
O exemplo seguinte demonstra como definir uma programação de cópias de segurança diárias à medida que cria uma instância. Para ver mais opções disponíveis ao criar instâncias, consulte o artigo Crie uma instância.
gcloud
gcloud memorystore instances create INSTANCE_ID \ --automated-backup-mode=ENABLED \ --automated-backup-start-time=START_TIME \ --automated-backup-ttl=RETENTION_POLICY
Substitua o seguinte:
- INSTANCE_ID: o ID da instância do Memorystore for Valkey que está a criar.
- START_TIME: a hora em que o Memorystore for Valkey começa a fazer cópias de segurança. Especifique a hora no formato
HHnum ciclo de 24 horas na hora UTC. Por exemplo:23. RETENTION_POLICY: o número de dias durante os quais o Memorystore for Valkey mantém cada cópia de segurança. Defina o valor deste parâmetro para um número de dias (por exemplo,
7d). O valor máximo é de 365 dias e o valor predefinido é de 35 dias.Mesmo depois de eliminar a instância, o Memorystore for Valkey retém a cópia de segurança durante o período de retenção, com um máximo de 365 dias. Para remover a cópia de segurança antes do período de retenção expirar, tem de eliminar a cópia de segurança manualmente.
Ative as cópias de segurança agendadas numa instância existente
Para ativar as cópias de segurança agendadas numa instância, use o 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
Substitua o seguinte:
- INSTANCE_ID: o ID da instância do Memorystore for Valkey que está a atualizar.
- START_TIME: uma indicação de tempo que especifica quando o
Memorystore for Valkey começa a fazer cópias de segurança. Esta data/hora tem de estar ao nível da hora, no formato
HH, e num ciclo de 24 horas na hora UTC (por exemplo,23). A data/hora também designa um período de uma hora em que o Memorystore for Valkey começa a fazer cópias de segurança. RETENTION_POLICY: o número de dias durante os quais o Memorystore for Valkey mantém cada cópia de segurança. Defina o valor deste parâmetro para um número de dias (por exemplo,
7d).Mesmo depois de eliminar a instância, o Memorystore for Valkey retém a cópia de segurança durante o período de retenção. Para remover a cópia de segurança antes de o período de retenção expirar, tem de eliminar a cópia de segurança manualmente.
Desative as cópias de segurança agendadas numa instância existente
Para desativar as cópias de segurança agendadas numa instância, use o comando gcloud memorystore instances update.
gcloud
gcloud memorystore instances update INSTANCE_ID \ --automated-backup-mode=disabled
Substitua INSTANCE_ID pelo ID da instância do Memorystore for Valkey que está a atualizar.
Concorrência com operações de atualização de instâncias, manutenção e cópias de segurança
As operações de atualização numa instância e as operações de manutenção podem cancelar as operações de cópia de segurança em curso nas seguintes situações:
- Se existir uma operação em curso para atualizar uma instância, o Memorystore for Valkey rejeita os pedidos de operação de cópia de segurança.
- Se existir uma operação de cópia de segurança em curso, o Memorystore for Valkey rejeita uma operação recebida para atualizar uma instância.
- As operações de manutenção e cópia de segurança podem coincidir. Se isto ocorrer, o Memorystore for Valkey ignora as operações de cópia de segurança para essa instância.
Liste e descreva as cópias de segurança
As secções seguintes demonstram como encontrar informações sobre cópias de segurança.
Liste coleções de cópias de segurança
Uma coleção de cópias de segurança contém todas as cópias de segurança de uma instância do Memorystore for Valkey. Para apresentar uma lista de coleções de cópias de segurança para um projeto e uma região, use o comando gcloud memorystore backup-collections list.
gcloud
gcloud memorystore backup-collections list \ --project=PROJECT_ID \ --location=REGION_ID
Substitua o seguinte:
- PROJECT_ID: o ID do seu projeto
- REGION_ID: a região onde a sua instância está localizada (por exemplo,
us-east1)
O comando devolve uma lista de coleções de cópias de segurança.
Liste as cópias de segurança numa coleção de cópias de segurança
Para apresentar uma lista das cópias de segurança numa coleção de cópias de segurança, use o comando gcloud memorystore backup-collections backups list.
gcloud
gcloud memorystore backup-collections backups list \ --backup-collection=BACKUP_COLLECTION --project=PROJECT_ID \ --location=REGION_ID
Substitua o seguinte:
- BACKUP_COLLECTION: o nome da coleção de cópias de segurança
- PROJECT_ID: o ID do seu projeto
- REGION_ID: a região onde a sua instância está localizada (por exemplo,
us-east1)
O comando devolve uma lista de cópias de segurança que estão numa coleção de cópias de segurança.
Descreva uma cópia de segurança
Para obter informações sobre uma cópia de segurança, use o 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
Substitua o seguinte:
- BACKUP_NAME: o nome da cópia de segurança (por exemplo,
2024-05-01-10-15-00) - BACKUP_COLLECTION: o nome da coleção de cópias de segurança
- PROJECT_ID: o ID do seu projeto
- REGION_ID: a região onde a sua instância está localizada (por exemplo,
us-east1)
O comando devolve informações sobre a cópia de segurança semelhantes às seguintes:
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'
Elimine uma cópia de segurança
Para eliminar uma cópia de segurança, use o 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
Substitua o seguinte:
- BACKUP_NAME: o nome da cópia de segurança (por exemplo,
2024-05-01-10-15-00) - BACKUP_COLLECTION: o nome da coleção de cópias de segurança
- PROJECT_ID: o ID do seu projeto
- REGION_ID: a região onde a sua instância está localizada (por exemplo,
us-east1)
Exporte uma cópia de segurança para um contentor de armazenamento
Pode exportar uma cópia de segurança para um contentor do Cloud Storage.
Os passos seguintes demonstram como exportar uma cópia de segurança.
Conceda ao agente de serviço do Memorystore for Valkey acesso aos recursos do Cloud Storage.
Concede ao agente de serviço acesso aos recursos do Cloud Storage para que o Memorystore for Valkey possa aceder ao contentor de destino do Cloud Storage. Além disso, o agente do serviço Memorystore for Valkey usa o seguinte formato de nomenclatura:
service-PROJECT_NUMBER@gcp-sa-memorystore.iam.gserviceaccount.com
Substitua PROJECT_NUMBER pelo número do projeto do projeto onde a instância ou a cópia de segurança está localizada.
Conceda ao agente do serviço uma função que atribua as autorizações
storage.buckets.get,storage.objects.create,storage.objects.deleteestorage.folders.createà função.Por exemplo, o comando seguinte atribui a função
Storage Adminao agente de serviço para um contentor 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 o seguinte:
- BUCKET_NAME: o nome do contentor do Cloud Storage de destino. Este contentor tem de ser um contentor regional e estar na mesma região que a cópia de segurança. O Memorystore for Valkey tem de ter autorizações para aceder ao contentor e criar pastas e objetos no contentor.
- PROJECT_NUMBER: o número do projeto usado no nome do agente do serviço.
Para exportar uma cópia de segurança para um contentor 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 o seguinte:
- BACKUP_NAME: o nome da cópia de segurança do Memorystore for Valkey
- BACKUP_COLLECTION: o nome da coleção de cópias de segurança
- REGION_ID: a região onde se encontra a coleção de cópias de segurança
(por exemplo,
us-east1) - BUCKET_NAME: o nome do contentor do Cloud Storage, que não tem
gs://como prefixo
Restaure dados a partir de uma cópia de segurança
Para restaurar dados a partir de uma cópia de segurança, pode inicializar uma nova instância a partir de uma cópia de segurança gerida no mesmo projeto ou pode inicializar uma nova instância a partir de ficheiros RDB num contentor do Cloud Storage. Para inicializar uma instância a partir de ficheiros RDB, o Memorystore for Valkey tem de ter autorizações para aceder aos ficheiros.
Preencha uma nova instância a partir de uma cópia de segurança
O exemplo seguinte demonstra como importar dados de uma cópia de segurança para uma nova instância. A cópia de segurança tem de estar na mesma região que a instância. Além disso, o principal que cria a instância tem de ter a autorização redis.backups.get para a cópia de segurança.
gcloud
gcloud memorystore instances create INSTANCE_ID \ --import-managed-backup=BACKUP_NAME \ --location=REGION_ID
Substitua o seguinte:
- INSTANCE_ID: o ID da instância do Memorystore for Valkey que está a criar.
- BACKUP_NAME: o nome da cópia de segurança. Este nome tem o seguinte formato:
projects/PROJECT_ID/locations/REGION_ID/backupCollections/BACKUP_COLLECTION_ID/backups/BACKUP_ID. - REGION_ID: a região onde a sua instância está localizada (por exemplo,
us-east1).
Inicialize uma nova instância a partir de ficheiros RDB num contentor de armazenamento
Pode importar dados de ficheiros RDB, que estão contidos num contentor do Cloud Storage, para uma nova instância.
Os passos seguintes demonstram como importar dados de ficheiros RDB num contentor do Cloud Storage para uma nova instância.
Conceda ao agente de serviço do Memorystore for Valkey acesso aos recursos do Cloud Storage.
Concede ao agente de serviço acesso aos recursos do Cloud Storage para que o Memorystore for Valkey possa aceder aos ficheiros RDB que se encontram no contentor do Cloud Storage. Além disso, o agente do serviço Memorystore for Valkey usa o seguinte formato de nomenclatura:
service-PROJECT_NUMBER@gcp-sa-memorystore.iam.gserviceaccount.com
Substitua PROJECT_NUMBER pelo número do projeto do projeto onde cria a nova instância.
Conceda ao agente de serviços uma função que atribua as autorizações
storage.buckets.getestorage.objects.getà função.Por exemplo, o comando seguinte atribui a função
Storage Adminao agente de serviço para um contentor 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 o seguinte:
- BUCKET_NAME: o nome do contentor onde os ficheiros RDB estão localizados. Este contentor tem de ser um contentor regional na mesma região que a cópia de segurança ou um contentor de dupla região e ter uma região igual à da cópia de segurança. O Memorystore for Valkey tem de ter autorizações para aceder ao contentor.
- PROJECT_NUMBER: o número do projeto usado no nome do agente do serviço.
Para importar dados de ficheiros RDB num contentor do Cloud Storage para uma nova instância, use o comando
gcloud memorystore instances create.gcloud
gcloud memorystore instances create INSTANCE_ID \ --gcs-source-uris=URI \ --location=REGION_ID \ --node-type=NODE_TYPE \ --shard-count=SHARD_COUNT
Substitua o seguinte:
- INSTANCE_ID: o ID da instância do Memorystore for Valkey que está a criar.
- 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 onde a sua instância está localizada (por exemplo,
us-east1). NODE_TYPE (Opcional): o tipo de nó da instância. Os valores aceites são:
shared-core-nanostandard-smallhighmem-mediumhighmem-xlarge
Se não usar o parâmetro,
highmem-mediumé o tipo de nó predefinido.SHARD_COUNT: o número de fragmentos para a instância (de 1 a 250).
Métricas do Cloud Monitoring
Para monitorizar as operações recentes de cópia de segurança e importação, pode usar as métricas do Cloud Monitoring. Para ver uma lista das métricas disponíveis para as cópias de segurança do Memorystore for Valkey, consulte o artigo Métricas de cópia de segurança.