View a markdown version of this page

Tutorial: creazione di un nuovo cluster basato su nodi con un backup creato esternamente - Amazon ElastiCache

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Tutorial: creazione di un nuovo cluster basato su nodi con un backup creato esternamente

Quando crei un nuovo cluster basato su nodi Valkey o Redis OSS, puoi eseguirne il seeding con i dati di un file di backup .rdb Valkey o Redis OSS. Il seeding del cluster è utile se attualmente gestisci un'istanza Valkey o Redis OSS all'esterno ElastiCache e desideri popolare il tuo nuovo cluster basato su nodi ElastiCache per Redis OSS con i dati Valkey o Redis OSS esistenti.

Per eseguire il seeding di un nuovo cluster basato su nodi Valkey o Redis OSS da un backup Valkey o Redis OSS creato in Amazon, consulta. ElastiCache Ripristino da un backup in una nuova cache

Quando usi un file .rdb Valkey o Redis OSS per eseguire il seed di un nuovo cluster basato su nodi, puoi fare quanto segue:

  • Esegui l'upgrade da un cluster non partizionato a un cluster basato su nodi Valkey o Redis OSS (modalità cluster abilitata).

  • Specifica un numero di frammenti (chiamati gruppi di nodi nell'API e nella CLI) nel nuovo cluster basato su nodi. Questo numero può essere diverso dal numero di shard nel cluster basato su nodi utilizzato per creare il file di backup.

  • Specifica un tipo di nodo diverso per il nuovo cluster basato su nodi, più grande o più piccolo di quello utilizzato nel cluster che ha effettuato il backup. Se passi a un tipo di nodo più piccolo, assicurati che il nuovo tipo di nodo abbia una memoria sufficiente per i tuoi dati e il sovraccarico di Valkey o Redis OSS. Per ulteriori informazioni, consulta Assicurarsi di disporre di memoria sufficiente per creare un'istantanea OSS Valkey o Redis.

  • Distribuite le chiavi negli slot del nuovo cluster Valkey o Redis OSS (modalità cluster abilitata) in modo diverso rispetto al cluster utilizzato per creare il file di backup.

Nota

Non è possibile eseguire il seeding di un cluster Valkey o Redis OSS (modalità cluster disabilitata) da un file .rdb creato da un cluster Valkey o Redis OSS (modalità cluster abilitata).

Importante
  • È necessario assicurarsi che i dati di backup di Valkey o Redis OSS non superino le risorse del nodo. Ad esempio, non puoi caricare un file .rdb con 5 GB di dati Valkey o Redis OSS su un nodo cache.t3.medium con 3,09 GB di memoria.

    Se il backup è troppo grande, lo stato del cluster risultante sarà restore-failed. In tal caso, occorre eliminare il cluster e ricominciare.

    Per un elenco completo dei tipi e delle specifiche dei nodi, consulta le caratteristiche e i dettagli dei prodotti Amazon. Parametri specifici del tipo di nodo Redis OSS ElastiCache

  • Puoi crittografare un file .rdb OSS Valkey o Redis con la crittografia lato server di Amazon S3 utilizzando le chiavi gestite di Amazon S3 () o le chiavi KMS (). SSE-S3 AWS SSE-KMS Se utilizzi SSE-KMS, devi concedere le autorizzazioni di ElastiCache decrittografia sulla chiave KMS e disabilitare Amazon S3 Bucket Keys. Per ulteriori informazioni, consulta Concedi ElastiCache l'accesso a un KMS-encrypted file .rdb. Per informazioni generali sulla crittografia lato server, consulta Protezione dei dati mediante crittografia lato server. https://docs.aws.amazon.com/AmazonS3/latest/dev/serv-side-encryption.html

Di seguito sono riportati gli argomenti che illustrano come migrare il cluster dall'esterno ElastiCache per Valkey o Redis OSS a Redis OSS. ElastiCache

Passaggio 1: creare un backup Valkey per Redis OSS

Per creare il backup Valkey o Redis OSS per eseguire il seeding dell'istanza per Redis OSS ElastiCache
  1. Connettiti alla tua istanza Valkey o Redis OSS esistente.

  2. Esegui una delle due BGSAVE SAVE operazioni per creare un backup. Prendere nota della posizione del file .rdb.

    BGSAVE è asincrona e non blocca altri client durante l'elaborazione. Per ulteriori informazioni, consulta BGSAVE sul sito Web di Valkey.

    SAVE è sincrona e blocca altri processi finché non è terminata. Per ulteriori informazioni, consulta SAVE sul sito web di Valkey.

Per ulteriori informazioni sulla creazione di un backup, consulta Persistence sul sito Web di Valkey.

Fase 2: creazione di un bucket Amazon S3 e una cartella

Dopo che è stato creato, il file di backup deve essere caricato in una cartella all'interno di un bucket Amazon S3. A questo scopo, tale bucket deve contenere un bucket Amazon S3 e una cartella. Se disponi già di un bucket Amazon S3 e una cartella con le autorizzazioni appropriate, puoi passare a Fase 3: caricamento del backup in Amazon S3.

Come creare un bucket Amazon S3.
  1. Accedi Console di gestione AWS e apri la console Amazon S3 all'indirizzo. https://console.aws.amazon.com/s3/

  2. Seguire le istruzioni per creare un bucket Amazon S3 in Creazione di un bucket nella Guida per l'utente di Amazon Simple Storage Service.

    Il nome del tuo bucket Amazon S3 deve essere. DNS-compliant Altrimenti, non ElastiCache puoi accedere al tuo file di backup. Le regole per la conformità DNS sono:

    • I nomi devono avere una lunghezza compresa fra 3 e 63 caratteri.

    • I nomi devono contenere una serie di una o più etichette separate da un punto (.) in cui ciascuna etichetta:

      • Inizia con una lettera minuscola o un numero.

      • Finisce con una lettera minuscola o un numero.

      • Contiene solo lettere minuscole, numeri e trattini.

    • Non deve avere il formato di un indirizzo IP (ad esempio, 192.0.2.0).

    Devi creare il bucket Amazon S3 nella stessa AWS regione del nuovo cluster OSS ElastiCache per Redis. Questo approccio garantisce la massima velocità di trasferimento dei dati durante la ElastiCache lettura del file .rdb da Amazon S3.

    Nota

    Per tenere i dati al scuro, crea autorizzazioni al bucket Amazon S3 il più possibile restrittive. Allo stesso tempo, le autorizzazioni devono comunque consentire l'utilizzo del bucket e del suo contenuto per il seeding del nuovo cluster OSS Valkey o Redis.

Per aggiungere una cartella a un bucket Amazon S3
  1. Accedi Console di gestione AWS e apri la console Amazon S3 all'indirizzo. https://console.aws.amazon.com/s3/

  2. Scegliere il nome del bucket in cui caricare il file .rdb.

  3. Scegliere Create folder (Crea cartella).

  4. Immettere un nome per la nuova cartella.

  5. Scegli Save (Salva).

    Prendi nota del nome del bucket e del nome della cartella.

Fase 3: caricamento del backup in Amazon S3

Ora, carica il file .rdb creato in Passaggio 1: creare un backup Valkey per Redis OSS. Caricalo nel bucket Amazon S3 e nella cartella creata in Fase 2: creazione di un bucket Amazon S3 e una cartella. Per ulteriori informazioni su questo processo, consulta Aggiungere un oggetto in un bucket. Tra le fasi 2 e 3, scegliere il nome della cartella creata.

Per caricare il file .rdb in una cartella Amazon S3
  1. Accedi Console di gestione AWS e apri la console Amazon S3 all'indirizzo. https://console.aws.amazon.com/s3/

  2. Scegliere il nome del bucket Amazon S3 creato nella fase 2.

  3. Scegliere il nome della cartella creata nella Fase 2.

  4. Scegli Carica.

  5. Scegliere Add files (Aggiungi file).

  6. Individuare il file o i file da caricare, quindi scegliere il file o i file. Per scegliere più file, tenere premuto il tasto CTRL durante la selezione di ciascun nome file.

  7. Seleziona Apri.

  8. Verificare che il file o i file corretti sono elencati nella finestra di dialogo Upload (Carica), quindi scegliere Upload (Carica).

Nota il percorso nel file .rdb. Ad esempio, se il nome del bucket è myBucket e il percorso è myFolder/redis.rdb, digitare myBucket/myFolder/redis.rdb. Questo percorso è richiesto per inizializzare il nuovo cluster con i dati in questo backup.

Per ulteriori informazioni, consulta Restrizioni e limitazioni dei bucket nella Guida per gli utenti di Amazon Simple Storage Service.

Passaggio 4: concedere l'accesso in ElastiCache lettura al file .rdb

Ora concedi l'accesso in ElastiCache lettura al tuo file di backup .rdb. Concedi ElastiCache l'accesso al tuo file di backup in un modo diverso a seconda che il bucket si trovi in una AWS regione predefinita o in una regione opt-in. AWS

AWS Le regioni introdotte prima del 20 marzo 2019 sono abilitate per impostazione predefinita. Puoi iniziare a lavorare in queste AWS regioni immediatamente. Le regioni introdotte dopo il 20 marzo 2019, come l'Asia Pacifico (Hong Kong) e Medio Oriente (Bahrein), sono disabilitate per impostazione predefinita. È necessario abilitare o scegliere tali regioni prima di poterle utilizzare, come descritto in Managing AWS regions (Gestione delle regioni AWS ) nella Riferimenti generali di AWS.

Scegli il tuo approccio in base alla tua AWS regione:

Concedi l'accesso in ElastiCache lettura al file .rdb in una regione predefinita

AWS Le regioni introdotte prima del 20 marzo 2019 sono abilitate per impostazione predefinita. Puoi iniziare a lavorare in queste AWS regioni immediatamente. Le regioni introdotte dopo il 20 marzo 2019, come l'Asia Pacifico (Hong Kong) e Medio Oriente (Bahrein), sono disabilitate per impostazione predefinita. È necessario abilitare o scegliere tali regioni prima di poterle utilizzare, come descritto in Managing AWS regions (Gestione delle regioni AWS ) nella Riferimenti generali di AWS.

Per concedere l'accesso in ElastiCache lettura al file di backup in un AWS Regione abilitata per impostazione predefinita
  1. Accedi Console di gestione AWS e apri la console Amazon S3 all'indirizzo https://console.aws.amazon.com/s3/.

  2. Scegliere il nome del bucket S3 contenente il file .rdb.

  3. Scegli la scheda Autorizzazioni.

  4. In Policy del bucket, scegli Modifica.

  5. Aggiungi una policy bucket che conceda le autorizzazioni richieste ElastiCache . L'esempio seguente concede al principale del ElastiCache servizio l'accesso in lettura al bucket e ai suoi oggetti. Sostituiscilo amzn-s3-demo-bucket con il nome del tuo bucket S3. Sostituiscilo region-full-name con l'identificatore AWS della regione in cui si trova il cluster (ad esempio,). us-east-1

    { "Version": "2012-10-17", "Statement": [ { "Sid": "ElastiCacheSnapshotAccess", "Effect": "Allow", "Principal": { "Service": "region-full-name.elasticache-snapshot.amazonaws.com" }, "Action": [ "s3:GetObject", "s3:ListBucket", "s3:GetBucketAcl" ], "Resource": [ "arn:aws:s3:::amzn-s3-demo-bucket", "arn:aws:s3:::amzn-s3-demo-bucket/*" ] } ] }
  6. Scegli Save changes (Salva modifiche).

Concedi l'accesso in ElastiCache lettura al file .rdb in una regione opt-in

AWS Le regioni introdotte prima del 20 marzo 2019 sono abilitate per impostazione predefinita. Puoi iniziare a lavorare in queste AWS regioni immediatamente. Le regioni introdotte dopo il 20 marzo 2019, come l'Asia Pacifico (Hong Kong) e Medio Oriente (Bahrein), sono disabilitate per impostazione predefinita. È necessario abilitare o scegliere tali regioni prima di poterle utilizzare, come descritto in Managing AWS regions (Gestione delle regioni AWS ) nella Riferimenti generali di AWS.

Ora concedi l'accesso in ElastiCache lettura al tuo file di backup .rdb.

Per concedere l'accesso in ElastiCache lettura al file di backup
  1. Accedi Console di gestione AWS e apri la console Amazon S3 all'indirizzo https://console.aws.amazon.com/s3/.

  2. Scegliere il nome del bucket S3 contenente il file .rdb.

  3. Scegliere il nome della cartella contenente il file .rdb.

  4. Scegliere il nome del file di backup .rdb. Il nome del file selezionato viene visualizzato sopra le schede nella parte superiore della pagina.

  5. Scegli la scheda Autorizzazioni.

  6. Sotto Autorizzazioni, scegli Policy bucket e seleziona Modifica.

  7. Aggiorna la policy per concedere le autorizzazioni ElastiCache necessarie per eseguire le operazioni:

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

    • Aggiungere le seguenti autorizzazioni necessarie per l'esportazione di uno snapshot nel bucket Amazon S3:

      • "s3:GetObject"

      • "s3:ListBucket"

      • "s3:GetBucketAcl"

    Di seguito è riportato un esempio di come potrebbe essere la policy aggiornata.

    JSON
    { "Version":"2012-10-17", "Statement": [ { "Sid": "ElastiCacheSnapshotExport", "Effect": "Allow", "Principal": { "Service": "region.elasticache-snapshot.amazonaws.com" }, "Action": [ "s3:PutObject", "s3:GetObject", "s3:ListBucket", "s3:GetBucketAcl", "s3:ListMultipartUploadParts", "s3:ListBucketMultipartUploads" ], "Resource": [ "arn:aws:s3:::amzn-s3-demo-bucket", "arn:aws:s3:::amzn-s3-demo-bucket/*" ] } ] }
  8. Scegli Save changes (Salva modifiche).

Concedi ElastiCache l'accesso a un KMS-encrypted file .rdb

Se il tuo bucket Amazon S3 utilizza la crittografia AWS KMS lato server (SSE-KMS), devi anche concedere le ElastiCache autorizzazioni sulla chiave KMS in modo che possa decrittografare il file .rdb durante il processo di ripristino.

Per concedere le autorizzazioni di decrittografia su una chiave KMS ElastiCache
  1. Apri la console all'indirizzo. AWS KMS https://console.aws.amazon.com/kms

  2. Scegli la chiave KMS utilizzata per crittografare il bucket Amazon S3.

  3. In Politica chiave, scegli Modifica.

  4. Aggiungi la seguente dichiarazione alla politica chiave per concedere le autorizzazioni di ElastiCache decrittografia:

    { "Sid": "AllowElastiCacheDecrypt", "Effect": "Allow", "Principal": { "Service": "region-full-name.elasticache-snapshot.amazonaws.com" }, "Action": [ "kms:Decrypt", "kms:DescribeKey" ], "Resource": "*" }

    Sostituiscilo region-full-name con l'identificatore AWS della regione in cui si trova il cluster (ad esempio,). us-west-2

  5. Scegli Save changes (Salva modifiche).

Inoltre, devi disabilitare Amazon S3 Bucket Keys per il bucket. ElastiCache non supporta la lettura di oggetti crittografati con Amazon S3 Bucket Keys. Per disabilitare questa impostazione, consulta Configurazione delle chiavi S3 Bucket nella Amazon Simple Storage Service User Guide.

Effettua il seeding del ElastiCache cluster con i dati del file .rdb

Ora sei pronto per creare un ElastiCache cluster e eseguirne il seeding con i dati del file .rdb. Per creare il cluster, segui le istruzioni in Creazione di un cluster per Valkey o Redis OSS o Creazione da zero di un gruppo di replica Valkey o Redis OSS. Assicurati di scegliere Valkey o Redis OSS come motore di cluster.

Il metodo utilizzato per stabilire ElastiCache dove trovare il backup caricato su Amazon S3 dipende dal metodo utilizzato per creare il cluster:

Effettua il ElastiCache seeding del cluster o del gruppo di replica OSS for Redis con i dati del file .rdb
  • Utilizzo della console ElastiCache

    Quando selezioni Cluster settings (Impostazioni cluster), scegli Restore from backups (Ripristina dai backup) come metodo di creazione del cluster, quindi scegli Other backups (Altri backup) come Source (Origine) nella sezione Backup source (Fonte del backup). Nella casella Seed RDB file S3 location (Inizializza posizione Amazon S3 del file RDB), digita il percorso per i file. Se disponi di più file .rdb, digita il percorso per ogni file in un elenco separato da virgole. Il percorso Amazon S3 appare simile a myBucket/myFolder/myBackupFilename.rdb.

  • Usando il AWS CLI

    Se utilizzi l'operazione create-cache-cluster o create-replication-group, utilizza il parametro --snapshot-arns per specificare un ARN completo per ogni file .rdb. Ad esempio, arn:aws:s3:::myBucket/myFolder/myBackupFilename.rdb. L'ARN deve essere risolto nei file di backup archiviati in Amazon S3.

  • Utilizzo dell' ElastiCache API

    Se utilizzi l'operazione CreateCacheCluster o CreateReplicationGroup ElastiCache API, utilizza il parametro SnapshotArns per specificare un ARN completo per ogni file .rdb. Ad esempio, arn:aws:s3:::myBucket/myFolder/myBackupFilename.rdb. L'ARN deve essere risolto nei file di backup archiviati in Amazon S3.

Importante

Quando si esegue il seeding di un cluster Valkey o Redis OSS (modalità cluster abilitata), è necessario configurare ciascun gruppo di nodi (shard) nel nuovo cluster o gruppo di replica. A questo proposito, utilizza il parametro --node-group-configuration (API: NodeGroupConfiguration). Per ulteriori informazioni, consulta gli argomenti seguenti:

Durante il processo di creazione del cluster, i dati del backup Valkey o Redis OSS vengono scritti nel cluster. È possibile monitorare l'avanzamento visualizzando i messaggi degli ElastiCache eventi. Per fare ciò, consulta la ElastiCache console e scegli Cache Events. Puoi anche utilizzare l'interfaccia a riga di AWS ElastiCache comando o ElastiCache l'API per ottenere messaggi di eventi. Per ulteriori informazioni, consulta Visualizzazione ElastiCache degli eventi.