Nesta página, descrevemos como realizar operações de backup no cluster do Memorystore para Redis. É possível usar backups para restaurar os dados do cluster para um determinado momento, além de exportar e analisar esses dados.
Antes de começar
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 do Redis e Editor do Redis podem realizar todas as operações de backup. A função Leitor do Redis pode visualizar e exportar backups.
Iniciar um backup sob demanda
É possível fazer um backup sob demanda de um cluster no Memorystore para Redis Cluster usando o console do Google Cloud ou a Google Cloud CLI.
Console
No console Google Cloud , acesse a página Memorystore para Redis Cluster.
Clique no ID do cluster para o qual você quer fazer um backup.
No painel de navegação lateral, clique em Backups.
Clique em Criar backup.
Na caixa de diálogo Criar backup, faça o seguinte:
- Opcional. Dê um nome ao backup. Se você não nomear o backup, ele terá um carimbo de data e hora como nome.
- Clique em Criar backup.
gcloud
gcloud redis clusters create-backup CLUSTER_ID \ --backup-id=BACKUP_ID \ --ttl=TTL_PERIOD \ --project=PROJECT_ID \ --region=REGION
Substitua:
- CLUSTER_ID é o ID do cluster de que você quer fazer um backup.
- BACKUP_ID é um ID do backup, como
december-2024-backup - TTL_PERIOD especifica um time to live (TTL) para o backup.
O backup é excluído automaticamente após atingir o limite de TTL.
Definido para um número de dias. Por exemplo,
14d. O valor mínimo é 1 dia. Se não for especificado, o valor padrão será 100 anos. - PROJECT_ID é o ID do projeto;
- REGION é a região em que o cluster está localizado (por exemplo,
us-east1).
O comando retorna um nome de operação com o seguinte formato:
projects/PROJECT_ID/locations/REGION/operations/operation-UID
Use o comando
gcloud redis operations describe para verificar o status de uma operação:
gcloud redis operations describe projects/PROJECT_ID/locations/REGION/operations/operation-UID
Também é possível usar o comando gcloud redis operations list para listar todas as operações em um projeto e uma região.
Configurar programações de backup automáticas
É possível configurar uma programação de backup diário ao criar um cluster ou ativar uma programação de backup diário em um cluster atual.
Criar um cluster com uma programação de backup automatizada ativada
É possível definir uma programação de backup diário ao criar um cluster no Memorystore para Redis Cluster usando o console do Google Cloud ou a Google Cloud CLI.
Console
Para saber como criar um cluster e ativar uma programação de backup para ele automaticamente, consulte Criar uma instância.
gcloud
gcloud redis clusters create CLUSTER_ID \ --automated-backup-mode=ENABLED \ --automated-backup-start-time=START_TIME \ --automated-backup-ttl=RETENTION_POLICY
Substitua:
- CLUSTER_ID é o ID do cluster que você está criando.
- START_TIME A especifica quando começar a fazer backups. Especifique o horário no formato
HH:00em um ciclo de 24 horas no horário UTC. Por exemplo,23:00. RETENTION_POLICY especifica por quantos dias cada backup será mantido. Definido como um número de dias, por exemplo,
7d. O máximo é de 365 dias, e o padrão é de 35 dias.Mesmo depois que um cluster é excluído, o backup é retido pelo período de armazenamento, com um máximo de 365 dias. É necessário excluir o backup manualmente para removê-lo antes do fim do período de armazenamento.
Ativar backups programados em um cluster atual
É possível ativar um cronograma de backup diário em um cluster atual usando o console Google Cloud ou a Google Cloud CLI.
Console
No console Google Cloud , acesse a página Memorystore para Redis Cluster.
Clique no ID do cluster em que você quer ativar os backups.
No painel de navegação lateral, clique em Backups.
Na seção Configurações, ao lado do campo Backups diários automatizados, clique em edit Editar.
Esse campo tem o status Desativado. Se esse campo tiver o status Ativado, você já ativou os backups programados para esse cluster.
Na caixa de diálogo Configurações de backup automático, faça o seguinte:
- Marque a caixa de seleção Backups diários automatizados.
- No campo Dias para reter backups, insira o número de dias que
você quer que o Memorystore for Redis Cluster mantenha os backups antes que eles sejam excluídos
automaticamente. É possível especificar de
1a365dias. O valor padrão é de35dias. - No menu Período, selecione a hora em que o Memorystore for Redis Cluster faz um backup diário.
- Clique em Salvar.
gcloud
gcloud redis clusters update CLUSTER_ID \ --automated-backup-mode=enabled \ --automated-backup-start-time=START_TIME \ --automated-backup-ttl=RETENTION_POLICY
Substitua:
- CLUSTER_ID é o ID do cluster que você está atualizando.
START_TIME Um carimbo de data/hora que especifica quando começar a fazer backups. O carimbo de data/hora precisa ser no nível da hora e designar uma janela de uma hora em que os backups começam, por exemplo,
2024-01-01T01:00:00Z.RETENTION_POLICY especifica por quantos dias cada backup será mantido. Definido como um número de dias, por exemplo,
7d.Mesmo depois que um cluster é excluído, o backup é mantido durante o período de armazenamento. É necessário excluir o backup manualmente para removê-lo antes do fim do período de armazenamento.
Desativar backups programados
É possível desativar os backups programados em um cluster usando o console doGoogle Cloud ou a Google Cloud CLI.
Console
No console Google Cloud , acesse a página Memorystore para Redis Cluster.
Clique no ID do cluster para o qual você quer desativar os backups.
No painel de navegação lateral, clique em Backups.
Na seção Configurações, ao lado do campo Backups diários automatizados, clique em edit Editar.
Esse campo tem o status Ativado. Esse campo é ativado por padrão. Se esse campo tiver o status Desativado, significa que você já desativou os backups programados para esse cluster.
Na caixa de diálogo Configurações de backup automático, faça o seguinte:
- Desmarque a caixa de seleção Backups diários automatizados.
- Clique em Salvar.
gcloud
gcloud redis clusters update CLUSTER_ID \ --automated-backup-mode=disabled
Substitua CLUSTER_ID pelo ID do cluster que você está atualizando.
Concorrência entre operações de backup e atualização de cluster
As operações de atualização e manutenção em um cluster podem cancelar operações de backup em andamento nas seguintes situações:
- Se houver uma operação em andamento para atualizar um cluster, o Memorystore para Redis Cluster vai rejeitar as operações de backup.
- Em raras circunstâncias, as operações de manutenção e backup podem coincidir e fazer com que as operações de backup sejam ignoradas para esse cluster.
Listar e descrever backups
As seções a seguir mostram como encontrar informações sobre os backups disponíveis.
Listar coleções de backup
Uma coleção de backups inclui todos os backups feitos para um cluster. É possível conferir uma lista de coleções de backup usando o console do Google Cloud ou a Google Cloud CLI.
Console
No console Google Cloud , acesse a página Memorystore para Redis Cluster.
No painel de navegação lateral, clique em Backups.
gcloud
gcloud redis clusters backup-collections list \ --project=PROJECT_ID \ --region=REGION
Substitua:
- REGION é a região em que o cluster está localizado (por exemplo,
us-east1). - PROJECT_ID é o ID do projeto;
O comando retorna uma lista de coleções de backup semelhante a esta:
BACKUP_COLLECTION_NAME CLUSTER_NAME CLUSTER_UID 6d9e1ff4-0f89-4c0a-a941-155dd4c3a213 projects/PROJECT_ID/locations/REGION/clusters/cluster1 6e539aed-ee7b-4eea-83ad-b4715b1ef160 dda2f551-b416-47ff-b1cf-684e00483dc9 projects/PROJECT_ID/locations/REGION/clusters/cluster2 57130520-636c-4ac7-ad7e-86f7cfb32838
Listar backups de uma coleção de backup
É possível conferir uma lista de backups de uma coleção usando o console doGoogle Cloud ou a CLI gcloud.
Console
No console Google Cloud , acesse a página Memorystore para Redis Cluster.
No painel de navegação lateral, clique em Backups.
Clique no ID de um cluster associado a uma coleção de backup. Essa coleção contém uma lista de backups que você quer visualizar.
gcloud
gcloud redis clusters backups list \ --backup-collection=BACKUP_COLLECTION --project=PROJECT_ID \ --region=REGION
Substitua:
- BACKUP_COLLECTION é o nome de uma coleção de backups.
- REGION é a região em que o cluster está localizado, como
us-east1. - PROJECT_ID é o ID do projeto;
O comando retorna uma lista de backups semelhante a esta:
BACKUP_NAME STATE CREATE_TIME EXPIRE_TIME backup-1 ACTIVE 2024-11-10T03:52:40.899882388Z 2124-11-10T03:53:02.856981736Z backup-2 ACTIVE 2024-11-11T03:48:22.137134936Z 2124-11-11T03:48:44.130735425Z
Descrever um backup
É possível recuperar informações sobre um backup usando a Google Cloud CLI.
gcloud
gcloud redis clusters backups describe BACKUP_NAME \ --backup-collections=BACKUP_COLLECTION --project=PROJECT_ID \ --region=REGION
Substitua:
- BACKUP_NAME é o nome de um backup, como
2024-05-01-10-15-00. - BACKUP_COLLECTION é o nome de uma coleção de backups.
- REGION é a região em que o cluster está localizado, como
us-east1. - PROJECT_ID é o ID do projeto;
O comando retorna informações sobre o backup semelhantes a estas:
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' cluster: projects/PROJECT_ID/locations/us-east1/clusters/cluster1 clusterUid: 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/december-2024-backup nodeType: REDIS_HIGHMEM_MEDIUM shardCount: 3 state: ACTIVE totalSizeBytes: '2084589755'
Excluir um backup
É possível excluir um backup usando o console Google Cloud ou a gcloud CLI.
Console
No console Google Cloud , acesse a página Memorystore para Redis Cluster.
Clique no ID do cluster que contém um backup que você quer excluir.
No painel de navegação lateral, clique em Backups.
Ao lado do backup que você quer excluir, clique em more_vert Mais ações.
No menu, selecione Excluir.
Na caixa de diálogo Excluir backup?, faça o seguinte:
- No campo de texto, digite
delete. - Clique em Excluir.
- No campo de texto, digite
gcloud
gcloud redis clusters backups delete BACKUP_NAME \ --backup-collection=BACKUP_COLLECTION --project=PROJECT_ID \ --region=REGION
Substitua:
- BACKUP_NAME é o nome de um backup, como
2024-05-01-10-15-00. - BACKUP_COLLECTION é o nome de uma coleção de backups.
- REGION é a região em que o cluster está localizado, como
us-east1. - PROJECT_ID é o ID do projeto;
Exportar um backup para um bucket de armazenamento
É possível exportar um backup para um bucket do Cloud Storage usando o consoleGoogle Cloud ou a Google Cloud CLI.
Para exportar um backup, faça o seguinte:
O Memorystore for Redis Cluster precisa ter permissão para acessar o bucket de destino do Cloud Storage. Conceda ao agente de serviço do Memorystore para Redis Cluster acesso aos recursos do Cloud Storage.
O agente de serviço do Memorystore para Redis Cluster usa o seguinte formato de nomenclatura:
service-PROJECT_NUMBER@cloud-redis.iam.gserviceaccount.com
Substitua PROJECT_NUMBER pelo número do projeto em que o cluster ou backup está localizado.
Conceda ao agente de serviço um papel que dê as permissões
storage.buckets.get,storage.objects.create,storage.objects.deleteestorage.folders.create. Por exemplo, o comando a seguir concede o papelStorage Adminpara o bucket especificado ao agente de serviço do cluster do Memorystore para Redis:gcloud
gcloud storage buckets add-iam-policy-binding gs://BUCKET_NAME \ --member=serviceAccount:service-PROJECT_NUMBER@cloud-redis.iam.gserviceaccount.com \ --role=roles/storage.admin
Substitua:
- BUCKET_NAME é o nome do bucket de destino.
- PROJECT_NUMBER é o número do projeto usado no nome do agente de serviço.
Exporte um backup para um bucket do Cloud Storage.
Console
No console Google Cloud , acesse a página Memorystore para Redis Cluster.
Clique no ID do cluster que contém um backup que você quer exportar.
No painel de navegação lateral, clique em Backups.
Ao lado do backup que você quer exportar, clique em more_vert Mais ações.
No menu, selecione Exportar.
Na seção Escolher destino da página Exportar backup para o Cloud Storage, clique em Procurar.
Na caixa de diálogo Selecionar bucket, clique no bucket para onde você quer exportar o backup e clique em Selecionar.
Na página Exportar backup para o Cloud Storage, clique em Exportar.
gcloud
gcloud redis clusters backups export BACKUP_NAME \ --region=REGION \ --backup-collection=BACKUP_COLLECTION \ --gcs-bucket=BUCKET
Substitua:
- BACKUP_NAME é o nome de um backup do Memorystore for Redis Cluster.
- BACKUP_COLLECTION é o nome de uma coleção de backups.
- REGION é a região em que a coleção de backup está localizada, como
us-east1. - BUCKET_NAME é um bucket do Cloud Storage, que não tem
gs://como prefixo.
O bucket precisa ser regional e estar na mesma região do backup. O Memorystore para Redis Cluster precisa ter permissão para acessar o bucket e criar pastas e objetos nele.
Restaurar dados de um backup
Para restaurar dados de um backup, você pode propagar um novo cluster de um backup gerenciado no mesmo projeto ou de arquivos do banco de dados Redis (RDB) em um bucket de armazenamento. Para fazer o seeding de um cluster com arquivos RDB, o Memorystore para Redis Cluster precisa ter permissão para acessar os arquivos.
Fazer seed de um novo cluster com um backup
O exemplo a seguir demonstra como importar dados de um backup para um novo cluster. O backup precisa estar na mesma região que o novo cluster.
O principal que cria o cluster precisa ter a permissão redis.backups.get
para o backup.
É possível importar dados de um backup para um novo cluster usando o console doGoogle Cloud ou a Google Cloud CLI.
Console
No console Google Cloud , acesse a página Memorystore para Redis Cluster.
Clique no ID do cluster que contém um backup que você quer importar.
No painel de navegação lateral, clique em Backups.
Ao lado do backup que você quer importar, clique em more_vert Mais ações.
No menu, selecione Importar para novo cluster. A página Criar uma instância de cluster do Redis é exibida.
Na seção Opções de backup, verifique o seguinte:
- A opção Backups gerenciados está selecionada.
- O campo ID do backup contém o caminho e o nome do backup que você selecionou.
Na seção Nomeie sua instância de cluster, insira um ID para o cluster que você está criando. O ID do cluster precisa usar apenas letras minúsculas, números e hifens. Ele também precisa começar com uma letra e ser exclusivo na região.
No menu Região, selecione uma região para o cluster.
Na seção Disponibilidade zonal, especifique se você quer criar um cluster de zona única ou multizonal.
Opcional. Na seção Tipo de nó, selecione um dos seguintes tipos de nó:
- Núcleo compartilhado (
redis-shared-core-nano) - Pequeno (
redis-standard-small) - Média (
redis-highmem-medium) - Extragrande (
redis-highmem-xlarge)
- Núcleo compartilhado (
Opcional. Na seção Tamanho do cluster, insira o número de fragmentos do cluster. A contagem de fragmentos determina a capacidade total de memória para armazenar dados do cluster. Para mais informações sobre as especificações do cluster, consulte Especificação de cluster e nó.
Opcional. Se você quiser criar um cluster com réplicas, na seção Réplicas, selecione o número de réplicas (por fragmento). É possível selecionar de 0 a 5 réplicas. O valor padrão é uma réplica.
Na seção Configurar conexão, selecione a rede que seus aplicativos podem usar para se conectar a esse cluster. Para mais informações sobre redes particulares para o Memorystore for Redis Cluster, consulte Visão geral da rede.
Opcional. Se quiser aumentar a segurança do cluster, na seção Segurança, ative a autenticação do IAM marcando a caixa de seleção Ativar AUTH do IAM.
Na seção Estratégia de persistência de dados, especifique como você quer que o cluster do Memorystore para Redis mantenha os dados no cluster. Os valores aceitáveis são Sem persistência, persistência de arquivo somente de anexação (AOF) e persistência de banco de dados do Redis (RDB).
Opcional. Se você quiser ativar os backups automáticos para seu cluster, faça o seguinte:
- Marque a caixa de seleção Backups diários automatizados.
- No campo Dias para reter backups, insira o número de dias
que você quer que o Memorystore for Redis Cluster mantenha os backups antes que eles sejam
excluídos automaticamente. É possível especificar de
1a365dias. O valor padrão é de35dias. - No menu Período, selecione um horário para o backup diário.
Clique em Criar cluster.
gcloud
gcloud redis clusters create CLUSTER_ID \ --import-managed-backup=BACKUP_NAME \ --region=REGION
Substitua:
- CLUSTER_ID é o ID do cluster que você está criando.
- BACKUP_NAME é o nome de um backup gerenciado. Por exemplo,
projects/PROJECT_ID/locations/REGION/backupCollections/BACKUP_COLLECTION_ID/backups/BACKUP_ID. - REGION é a região em que o cluster está localizado, como
us-east1.
Para mais opções que podem ser usadas para criar um cluster, consulte Criar uma instância.
Fazer seed de um novo cluster com arquivos RDB em um bucket de armazenamento
O exemplo a seguir demonstra como importar dados de arquivos RDB em um bucket do Cloud Storage para um novo cluster. O bucket precisa ser regional na mesma região que o novo cluster ou um bucket birregional com uma região igual.
Para fazer o seeding de um cluster com arquivos RDB em um bucket do Cloud Storage, é necessário conceder ao cluster do Memorystore para Redis acesso ao bucket e aos objetos e, em seguida, importar os dados dos arquivos.
É possível importar dados de arquivos RDB usando o console do Google Cloud ou a Google Cloud CLI.
O Memorystore para Redis Cluster precisa ter permissão para acessar os objetos do Cloud Storage. Conceda ao agente de serviço do Memorystore para Redis Cluster acesso aos recursos do Cloud Storage.
O agente de serviço do Memorystore para Redis Cluster usa o seguinte formato de nomenclatura:
service-PROJECT_NUMBER@cloud-redis.iam.gserviceaccount.com
Substitua PROJECT_NUMBER pelo número do projeto em que você vai criar o novo cluster.
Conceda ao agente de serviço um papel que dê as permissões
storage.buckets.getestorage.objects.get. Por exemplo, o comando a seguir concede o papelStorage Admina um bucket do Cloud Storage:gcloud
gcloud storage buckets add-iam-policy-binding gs://BUCKET_NAME --member=serviceAccount:service-PROJECT_NUMBER@cloud-redis.iam.gserviceaccount.com --role=roles/storage.admin
Substitua:
- BUCKET_NAME é o nome do bucket em que os arquivos RDB estão localizados.
- PROJECT_NUMBER é o número do projeto usado no nome do agente de serviço.
Importar dados de arquivos RDB em um bucket do Cloud Storage para um novo cluster.
Console
No console Google Cloud , acesse a página Memorystore para Redis Cluster.
Ao lado de Criar cluster, clique na seta para baixo arrow_drop_down e selecione Criar de um backup no menu que aparece. A página Criar uma instância de cluster do Redis é exibida.
Na seção Opções de backup, faça o seguinte:
- Selecione a opção Pasta do Cloud Storage.
- No campo de texto, clique em Procurar.
- Na caixa de diálogo Selecionar pasta, escolha a pasta que contém os arquivos RDB que você quer importar.
- Clique em Selecionar.
Na seção Nomeie a instância do cluster, insira um ID para o cluster. O ID do cluster precisa usar apenas letras minúsculas, números e hifens. Ele também precisa começar com uma letra e ser exclusivo na região.
No menu Região, selecione uma região para o cluster.
Na seção Disponibilidade zonal, especifique se você quer criar um cluster de zona única ou multizonal.
Na seção Tipo de nó, selecione um dos seguintes tipos de nó:
- Núcleo compartilhado (
redis-shared-core-nano) - Pequeno (
redis-standard-small) - Média (
redis-highmem-medium) - Extragrande (
redis-highmem-xlarge)
- Núcleo compartilhado (
Na seção Tamanho do cluster, insira o número de fragmentos do cluster. A contagem de fragmentos determina a capacidade total de memória para armazenar dados do cluster. Para mais informações sobre as especificações do cluster, consulte Especificação de cluster e nó.
Se você quiser criar um cluster com réplicas, na seção Réplicas, selecione o número de réplicas (por fragmento). É possível selecionar de 0 a 5 réplicas. O valor padrão é uma réplica.
Na seção Configurar conexão, selecione a rede que seus aplicativos podem usar para se conectar a esse cluster. Para mais informações sobre redes particulares para o Memorystore for Redis Cluster, consulte Visão geral da rede.
Opcional. Se quiser aumentar a segurança do cluster, na seção Segurança, ative a autenticação do IAM marcando a caixa de seleção Ativar AUTH do IAM.
Na seção Estratégia de persistência de dados, especifique como você quer que o cluster do Memorystore para Redis mantenha os dados no cluster. Os valores aceitáveis são Sem persistência, persistência de arquivo somente de anexação (AOF) e persistência de banco de dados do Redis (RDB).
Opcional. Se você quiser ativar os backups automáticos para seu cluster, faça o seguinte:
- Marque a caixa de seleção Backups diários automatizados.
- No campo Dias para reter backups, insira o número de dias
que você quer que o Memorystore for Redis Cluster mantenha os backups antes que eles sejam
excluídos automaticamente. É possível especificar de
1a365dias. O valor padrão é de35dias. - No menu Período, selecione um horário para o backup diário.
Clique em Criar cluster.
gcloud
gcloud redis clusters create CLUSTER_ID \ --import-gcs-object-uris=URI \ --region=REGION
Substitua:
- CLUSTER_ID é o ID do cluster que você está criando.
- URI é um ou mais URIs do Cloud Storage separados por vírgulas (
,). Por exemplo,gs://my-bucket/folder/file1.rdb,gs://my-bucket/folder/file2.rdb. - REGION é a região em que o cluster está localizado, como
us-east1.
Para mais opções que podem ser usadas para criar um cluster, consulte Criar uma instância.
Métricas do Cloud Monitoring
É possível usar as métricas do Cloud Monitoring para monitorar as operações recentes de backup e importação. Para uma lista de métricas disponíveis para backups do cluster do Memorystore para Redis, consulte Métricas de backup.
A seguir
- Leia mais sobre backups.
- Saiba mais sobre a persistência.