Tutorial: propagação de um novo cluster baseado em nós com um backup criado externamente - Amazon ElastiCache
Etapa 1: criar um backup do Valkey ou Redis OSSEtapa 2: criar um bucket e uma pasta no Amazon S3Etapa 3: carregar seu backup no Amazon S3Etapa 4: conceder acesso de leitura do ElastiCache para o arquivo .rdb

Tutorial: propagação de um novo cluster baseado em nós com um backup criado externamente

Ao criar um novo cluster baseado em nós do Valkey ou Redis OSS, você pode propagá-lo com dados de um arquivo de backup .rdb do Valkey ou Redis OSS. A propagação do cluster será útil se você gerenciar atualmente uma instância do Valkey ou Redis OSS fora do ElastiCache e quiser preencher o novo cluster baseado em nós do ElastiCache para Redis OSS com os dados existentes do Valkey ou Redis OSS.

Para propagar um novo cluster baseado em nós do Valkey ou Redis OSS de um backup do Valkey ou Redis OSS criado dentro do Amazon ElastiCache, consulte Restauração de um backup para um novo cache.

Ao usar um arquivo .rdb do Valkey ou Redis OSS para propagar um novo cluster baseado em nós, você pode fazer o seguinte:

  • Atualização de um cluster não particionado para um cluster baseado em nós do Valkey ou Redis OSS (modo cluster habilitado) que execute o Redis OSS versão 3.2.4.

  • Especifique um número de fragmentos (chamados de grupos de nós na API ou na CLI) no novo cluster baseado em nós. Esse número pode ser diferente do número de fragmentos no cluster baseado em nós que foi usado para criar o arquivo de backup.

  • Especificar um tipo de nó diferente para o novo cluster baseado em nós, maior ou menor que o usado no cluster que fez o backup. Se você escalar para um tipo de nó menor, certifique-se de que o novo tipo de nó tenha memória suficiente para seus dados e a sobrecarga do Valkey ou Redis OSS. Para obter mais informações, consulte Garantir que você tem memória suficiente para criar um snapshot do Valkey ou Redis OSS.

  • Distribua suas chaves nos slots do novo cluster do Valkey ou Redis OSS (modo cluster habilitado) de forma diferente do que no cluster que foi usado para criar o arquivo de backup.

nota

Não é possível propagar um cluster do Valkey ou Redis OSS (modo cluster desabilitado) a partir de um arquivo .rdb criado a partir de um cluster do Valkey ou Redis OSS (modo cluster habilitado).

Importante

  • É necessário garantir que seus dados de backup do Valkey ou Redis OSS não excedam os recursos do nó. Por exemplo, você não pode fazer upload de um arquivo .rdb com 5 GB de dados do Valkey ou Redis OSS em um nó cache.m3.medium que tenha 2,9 GB de memória.

    Se o backup for muito grande, o cluster resultante terá um status de restore-failed. Se isso acontecer, você deverá excluir o cluster e começar de novo.

    Para obter uma lista completa dos tipos e das especificações de nós, consulte Parâmetros específicos de node-type do Redis OSS e Recursos do produto e detalhes do Amazon ElastiCache.

  • Só é possível criptografar um arquivo .rdb do Valkey ou Redis OSS com a criptografia do lado do servidor do Amazon S3 (SSE-S3). Para obter mais informações, consulte Proteger dados usando a criptografia no lado do servidor.

A seguir, você pode encontrar tópicos que demonstram passo a passo como migrar seu cluster de fora do ElastiCache para Valkey ou Redis OSS para o ElastiCache para Redis OSS.

Etapa 1: criar um backup do Valkey ou Redis OSS

Para criar o backup do Valkey ou Redis OSS para propagar sua instância do ElastiCache para Redis OSS

  1. Conecte-se à sua instância do Valkey ou Redis OSS existente.

  2. Execute a operação BGSAVE ou SAVE para criar um backup. Observe onde seu arquivo .rdb está localizado.

    BGSAVE é assíncrono e não bloqueia outros clientes durante o processamento. Para obter mais informações, consulte BGSAVE no site do Valkey.

    SAVE é síncrono e bloqueia outros processos até terminar. Para obter mais informações, consulte SAVE no site do Valkey.

Para obter informações adicionais sobre como criar um backup, consulte Persistência no site do Valkey.

Etapa 2: criar um bucket e uma pasta no Amazon S3

Quando você tiver criado o arquivo de backup, precisará carregá-lo em uma pasta dentro de um bucket do Amazon S3. Para fazer isso, primeiro você deve ter um bucket do Amazon S3 e uma pasta dentro desse bucket. Se você já possui um bucket do Amazon S3 e uma pasta com as permissões apropriadas, poderá pular para Etapa 3: carregar seu backup no Amazon S3.

Como criar um bucket do Amazon S3

  1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em https://console.aws.amazon.com/s3/.

  2. Para criar um bucket do Amazon S3, siga as instruções em Criação de um bucket no Guia do usuário do Amazon Simple Storage Service.

    O nome do bucket do Amazon S3 deve estar em conformidade com o DNS. Caso contrário, o ElastiCache não poderá acessar seu arquivo de backup. As regras para a conformidade de DNS são:

    • Os nomes devem ter no mínimo 3 e no máximo 63 caracteres de extensão.

    • Os nomes devem ser uma série de um ou mais rótulos separados por um ponto (.) em que cada rótulo:

      • Começa com uma letra minúscula ou um número.

      • Termina com uma letra minúscula ou um número.

      • Contém somente letras minúsculas, números e traços.

    • Os nomes não podem ser formatado como um endereço IP (por exemplo, 192.0.2.0).

    Você deve criar seu bucket do Amazon S3 na mesma região da AWS que seu novo cluster do ElastiCache para Redis OSS. Essa abordagem garante a maior velocidade possível de transferência de dados quando o ElastiCache lê seu arquivo .rdb do Amazon S3.

    nota

    Para manter seus dados da forma mais segura possível, restrinja ao máximo as permissões em seu bucket do Amazon S3. Ao mesmo tempo, as permissões ainda precisam permitir que o bucket e seu conteúdo seja usado para propagar o novo cluster do Valkey ou Redis OSS.

Para adicionar uma pasta a um bucket do Amazon S3

  1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em https://console.aws.amazon.com/s3/.

  2. Escolha o nome do bucket para o qual deseja fazer upload do arquivo .rdb.

  3. Selecione Criar pasta.

  4. Insira um nome para a nova pasta.

  5. Escolha Salvar.

    Anote o nome do bucket e o nome da pasta.

Etapa 3: carregar seu backup no Amazon S3

Agora, faça upload do arquivo .rdb criado em Etapa 1: criar um backup do Valkey ou Redis OSS. Carregue-o no bucket e na pasta do Amazon S3 que você criou em Etapa 2: criar um bucket e uma pasta no Amazon S3. Para obter mais informações sobre essa tarefa, consulte Adicionar um objeto a um bucket. Entre as etapas 2 e 3, escolha o nome da pasta que você criou.

Para carregar seu arquivo .rdb em uma pasta do Amazon S3

  1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em https://console.aws.amazon.com/s3/.

  2. Escolha o nome do bucket do Amazon S3 criado na Etapa 2.

  3. Escolha o nome da pasta que você criou na Etapa 2.

  4. Escolha Carregar.

  5. Escolha Adicionar arquivos.

  6. Navegue para encontrar um ou mais arquivos que deseja carregar e depois escolha esses arquivos. Para escolher vários arquivos, mantenha pressionada a tecla Ctrl enquanto escolhe o nome de cada arquivo.

  7. Escolha Open (Abrir).

  8. Confirme se os arquivos corretos estão listados na caixa de diálogo Upload e depois escolha Upload.

Anote o caminho para o arquivo .rdb. Por exemplo, se o nome do bucket for myBucket e o caminho for myFolder/redis.rdb, insira myBucket/myFolder/redis.rdb. Você precisa desse caminho para propagar o novo cluster com os dados neste backup.

Para obter mais informações, consulte Restrições e limitações de bucket no Guia do usuário do Amazon Simple Storage Service.

Etapa 4: conceder acesso de leitura do ElastiCache para o arquivo .rdb

Agora, conceda acesso de leitura do ElastiCache para o seu arquivo de backup. rdb. Você concede acesso do ElastiCache ao arquivo de backup de uma maneira diferente, dependendo de o bucket estar em uma região padrão da AWS ou em uma região opcional da AWS.

AWSRegiões da adicionadas antes de 20 de março de 2019 são habilitadas por padrão. É possível começar a trabalhar nessas regiões da AWS imediatamente. As regiões introduzidas após 20 de março de 2019, como Ásia-Pacífico (Hong Kong) e Oriente Médio (Bahrein), são desabilitadas por padrão. Você deve habilitar ou escolher essas regiões para poder usá-las, conforme descrito em Gerenciar regiões da AWS na Referência geral da AWS.

Escolha sua abordagem de acordo com sua região da AWS:

Conceder acesso de leitura do ElastiCache ao arquivo .rdb em uma região padrão

AWSRegiões da adicionadas antes de 20 de março de 2019 são habilitadas por padrão. É possível começar a trabalhar nessas regiões da AWS imediatamente. As regiões introduzidas após 20 de março de 2019, como Ásia-Pacífico (Hong Kong) e Oriente Médio (Bahrein), são desabilitadas por padrão. Você deve habilitar ou escolher essas regiões para poder usá-las, conforme descrito em Gerenciar regiões da AWS na Referência geral da AWS.

Como conceder acesso de leitura do ElastiCache ao arquivo de backup em uma região da AWS habilitada por padrão

  1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em https://console.aws.amazon.com/s3/.

  2. Escolha o nome do bucket do S3 que contém seu arquivo .rdb.

  3. Escolha o nome da pasta que contém seu arquivo .rdb.

  4. Escolha o nome do seu arquivo de backup .rdb. O nome do arquivo selecionado aparece acima das guias na parte superior da página.

  5. Escolha Permissões.

  6. Se aws-scs-s3-readonly ou um dos IDs canônicos na lista a seguir não estiver listado como usuário, faça o seguinte:

    1. Em Access for other AWS accounts (Acesso para outras contas da ), escolha Add grantee (Adicionar beneficiário).

    2. Na caixa, adicione o ID canônico da região da AWS, conforme mostrado a seguir:

      • AWSRegião GovCloud (Oeste dos EUA) da : 

        40fa568277ad703bd160f66ae4f83fc9dfdfd06c2f1b5060ca22442ac3ef8be6
        Importante

        O backup deve estar localizado em um bucket do S3 na região AWS GovCloud (US) para poder ser baixado para um cluster do Valkey ou Redis OSS na região AWS GovCloud (US).

      • AWSRegiões da habilitadas por padrão: 

        540804c33a284a299d2547575ce1010f2312ef3da9b3a053c8bc45bf233e4353

    3. Defina as permissões no bucket escolhendo Yes (Sim) para o seguinte:

      • Objeto de lista/gravação

      • Permissões ACL de objetos de leitura/gravação

    4. Escolha Salvar.

  7. Escolha Overview (Visão geral) e escolha Download (Fazer download).

Conceder acesso de leitura do ElastiCache ao arquivo .rdb em uma região de opção

AWSRegiões da adicionadas antes de 20 de março de 2019 são habilitadas por padrão. É possível começar a trabalhar nessas regiões da AWS imediatamente. As regiões introduzidas após 20 de março de 2019, como Ásia-Pacífico (Hong Kong) e Oriente Médio (Bahrein), são desabilitadas por padrão. Você deve habilitar ou escolher essas regiões para poder usá-las, conforme descrito em Gerenciar regiões da AWS na Referência geral da AWS.

Agora, conceda acesso de leitura do ElastiCache para o seu arquivo de backup. rdb.

Para conceder acesso de leitura para o ElastiCache ao arquivo de backup

  1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em https://console.aws.amazon.com/s3/.

  2. Escolha o nome do bucket do S3 que contém seu arquivo .rdb.

  3. Escolha o nome da pasta que contém seu arquivo .rdb.

  4. Escolha o nome do seu arquivo de backup .rdb. O nome do arquivo selecionado aparece acima das guias na parte superior da página.

  5. Escolha a guia Permissões.

  6. Em Permissions (Permissões), escolha Bucket policy (Política de bucket) e, em seguida, Edit (Editar).

  7. Atualize a política para conceder ao ElastiCache as permissões necessárias para executar operações:

    • Adicione [ "Service" : "region-full-name.elasticache-snapshot.amazonaws.com" ] a Principal.

    • Adicione as seguintes permissões necessárias para exportar um snapshot para o bucket do Amazon S3:

      • "s3:GetObject"

      • "s3:ListBucket"

      • "s3:GetBucketAcl"

    Veja a seguir um exemplo de como a política atualizada pode parecer.

    JSON
    {
    "Version":"2012-10-17",		 	 	 
    "Id": "Policy15397346",
    "Statement": [
        {
            "Sid": "Stmt15399483",
            "Effect": "Allow",
            "Action": [
                "s3:GetObject",
                "s3:ListBucket",
                "s3:GetBucketAcl"
            ],
            "Resource": [
                "arn:aws:s3:::amzn-s3-demo-bucket",
                "arn:aws:s3:::amzn-s3-demo-bucket/backup1.rdb",
                "arn:aws:s3:::amzn-s3-demo-bucket/backup2.rdb"
            ]
        }
    ]
}

  8. Escolha Salvar alterações.

Propagar o cluster do ElastiCache com os dados do arquivo .rdb

Agora você está pronto para criar um cluster do ElastiCache e propagá-lo com dados do arquivo .rdb. Para criar o cluster, siga as instruções em Criação de um cluster do Valkey ou Redis OSS ou Criação de um grupo de replicação do Valkey ou Redis OSS do início. Certifique-se de escolher o Valkey ou Redis OSS como seu mecanismo de cluster.

O método que você usa para dizer ao ElastiCache onde encontrar o backup que você carregou no Amazon S3 depende do método usado para criar o cluster:

Crie o cluster ou grupo de replicação do ElastiCache para Redis OSS usando os dados do arquivo .rdb

  • Uso do console do ElastiCache

    Ao selecionar Cluster settings (Configurações de cluster), escolha Restore from backups (Restaurar de backups) como seu método de criação de cluster e escolha Other backups (Outros backups) como sua Source (Origem) na seção Backup source (Origem de backup). Na caixa Propagar local S3 do arquivo RDB, digite o caminho do Amazon S3 para o(s) arquivo(s). Se você tiver vários arquivos .rdb, digite o caminho para cada um em uma lista separada por vírgulas. O caminho do Amazon S3 parece-se com myBucket/myFolder/myBackupFilename.rdb.

  • Como usar a AWS CLI

    Se você usar a operação create-cache-cluster ou create-replication-group, use o parâmetro --snapshot-arns para especificar um ARN totalmente qualificado para cada arquivo .rdb. Por exemplo, arn:aws:s3:::myBucket/myFolder/myBackupFilename.rdb. O ARN deve ser resolvido para os arquivos de backup que você armazenou no Amazon S3.

  • Uso da API do ElastiCache

    Se você usar a operação da API do ElastiCache CreateCacheCluster ou CreateReplicationGroup, use o parâmetro SnapshotArns para especificar um ARN totalmente qualificado para cada arquivo .rdb. Por exemplo, arn:aws:s3:::myBucket/myFolder/myBackupFilename.rdb. O ARN deve ser resolvido para os arquivos de backup que você armazenou no Amazon S3.

Importante

Ao propagar um cluster do Valkey ou Redis OSS (modo cluster habilitado), você precisa configurar cada grupo de nós (fragmento) no novo cluster ou grupo de replicação. Use o parâmetro --node-group-configuration (API: NodeGroupConfiguration) para fazer isso. Para obter mais informações, consulte:

Durante o processo de criação do cluster, os dados no backup do Valkey ou Redis OSS são gravados no cluster. Você pode monitorar o progresso visualizando as mensagens de eventos do ElastiCache. Para fazer isso, consulte o console do ElastiCache e escolha Cache Events (Eventos do cache). Você também pode usar a interface de linha de comando do ElastiCache da AWS ou a API do ElastiCache para obter mensagens de eventos. Para obter mais informações, consulte Visualização de eventos do ElastiCache.