Gerenciar backups

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

  1. No console Google Cloud , acesse a página Memorystore para Redis Cluster.

    Memorystore for Redis Cluster

  2. Clique no ID do cluster para o qual você quer fazer um backup.

  3. No painel de navegação lateral, clique em Backups.

  4. Clique em Criar backup.

  5. Na caixa de diálogo Criar backup, faça o seguinte:

    1. Opcional. Dê um nome ao backup. Se você não nomear o backup, ele terá um carimbo de data e hora como nome.
    2. 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:00 em 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

  1. No console Google Cloud , acesse a página Memorystore para Redis Cluster.

    Memorystore for Redis Cluster

  2. Clique no ID do cluster em que você quer ativar os backups.

  3. No painel de navegação lateral, clique em Backups.

  4. Na seção Configurações, ao lado do campo Backups diários automatizados, clique em Editar.

    Esse campo tem o status Desativado. Se esse campo tiver o status Ativado, você já ativou os backups programados para esse cluster.

  5. Na caixa de diálogo Configurações de backup automático, faça o seguinte:

    1. Marque a caixa de seleção Backups diários automatizados.
    2. 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 1 a 365 dias. O valor padrão é de 35 dias.
    3. No menu Período, selecione a hora em que o Memorystore for Redis Cluster faz um backup diário.
    4. 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

  1. No console Google Cloud , acesse a página Memorystore para Redis Cluster.

    Memorystore for Redis Cluster

  2. Clique no ID do cluster para o qual você quer desativar os backups.

  3. No painel de navegação lateral, clique em Backups.

  4. Na seção Configurações, ao lado do campo Backups diários automatizados, clique em 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.

  5. Na caixa de diálogo Configurações de backup automático, faça o seguinte:

    1. Desmarque a caixa de seleção Backups diários automatizados.
    2. 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

  1. No console Google Cloud , acesse a página Memorystore para Redis Cluster.

    Memorystore for Redis Cluster

  2. 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

  1. No console Google Cloud , acesse a página Memorystore para Redis Cluster.

    Memorystore for Redis Cluster

  2. No painel de navegação lateral, clique em Backups.

  3. 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

  1. No console Google Cloud , acesse a página Memorystore para Redis Cluster.

    Memorystore for Redis Cluster

  2. Clique no ID do cluster que contém um backup que você quer excluir.

  3. No painel de navegação lateral, clique em Backups.

  4. Ao lado do backup que você quer excluir, clique em Mais ações.

  5. No menu, selecione Excluir.

  6. Na caixa de diálogo Excluir backup?, faça o seguinte:

    1. No campo de texto, digite delete.
    2. Clique em Excluir.

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:

  1. 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.delete e storage.folders.create. Por exemplo, o comando a seguir concede o papel Storage Admin para 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.
  2. Exporte um backup para um bucket do Cloud Storage.

    Console

    1. No console Google Cloud , acesse a página Memorystore para Redis Cluster.

      Memorystore for Redis Cluster

    2. Clique no ID do cluster que contém um backup que você quer exportar.

    3. No painel de navegação lateral, clique em Backups.

    4. Ao lado do backup que você quer exportar, clique em Mais ações.

    5. No menu, selecione Exportar.

    6. Na seção Escolher destino da página Exportar backup para o Cloud Storage, clique em Procurar.

    7. Na caixa de diálogo Selecionar bucket, clique no bucket para onde você quer exportar o backup e clique em Selecionar.

    8. 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

  1. No console Google Cloud , acesse a página Memorystore para Redis Cluster.

    Memorystore for Redis Cluster

  2. Clique no ID do cluster que contém um backup que você quer importar.

  3. No painel de navegação lateral, clique em Backups.

  4. Ao lado do backup que você quer importar, clique em Mais ações.

  5. No menu, selecione Importar para novo cluster. A página Criar uma instância de cluster do Redis é exibida.

  6. Na seção Opções de backup, verifique o seguinte:

    1. A opção Backups gerenciados está selecionada.
    2. O campo ID do backup contém o caminho e o nome do backup que você selecionou.
  7. 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.

  8. No menu Região, selecione uma região para o cluster.

  9. Na seção Disponibilidade zonal, especifique se você quer criar um cluster de zona única ou multizonal.

  10. 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)
  11. 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ó.

  12. 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.

  13. 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.

  14. 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.

  15. 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).

  16. Opcional. Se você quiser ativar os backups automáticos para seu cluster, faça o seguinte:

    1. Marque a caixa de seleção Backups diários automatizados.
    2. 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 1 a 365 dias. O valor padrão é de 35 dias.
    3. No menu Período, selecione um horário para o backup diário.
  17. 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.

  1. 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.get e storage.objects.get. Por exemplo, o comando a seguir concede o papel Storage Admin a 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.
  2. Importar dados de arquivos RDB em um bucket do Cloud Storage para um novo cluster.

    Console

    1. No console Google Cloud , acesse a página Memorystore para Redis Cluster.

      Memorystore for Redis Cluster

    2. Ao lado de Criar cluster, clique na seta para baixo e selecione Criar de um backup no menu que aparece. A página Criar uma instância de cluster do Redis é exibida.

    3. Na seção Opções de backup, faça o seguinte:

      1. Selecione a opção Pasta do Cloud Storage.
      2. No campo de texto, clique em Procurar.
      3. Na caixa de diálogo Selecionar pasta, escolha a pasta que contém os arquivos RDB que você quer importar.
      4. Clique em Selecionar.
    4. 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.

    5. No menu Região, selecione uma região para o cluster.

    6. Na seção Disponibilidade zonal, especifique se você quer criar um cluster de zona única ou multizonal.

    7. 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)
    8. 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ó.

    9. 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.

    10. 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.

    11. 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.

    12. 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).

    13. Opcional. Se você quiser ativar os backups automáticos para seu cluster, faça o seguinte:

      1. Marque a caixa de seleção Backups diários automatizados.
      2. 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 1 a 365 dias. O valor padrão é de 35 dias.
      3. No menu Período, selecione um horário para o backup diário.
    14. 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