Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # Tutoriel : Création d'un nouveau cluster basé sur des nœuds avec une sauvegarde créée en externe Lorsque vous créez un nouveau cluster basé sur un nœud Valkey ou Redis OSS, vous pouvez l'amorcer avec les données d'un fichier de sauvegarde Valkey ou Redis OSS .rdb. L'ensemencement du cluster est utile si vous gérez actuellement une instance Valkey ou Redis OSS en dehors de ElastiCache et si vous souhaitez remplir votre nouveau ElastiCache cluster basé sur un nœud Redis OSS avec vos données Valkey ou Redis OSS existantes. Pour démarrer un nouveau cluster basé sur un nœud Valkey ou Redis OSS à partir d'une sauvegarde Valkey ou Redis OSS créée sur Amazon, consultez. ElastiCache [Restauration à partir d’une sauvegarde dans un nouveau cache](backups-restoring.md) Lorsque vous utilisez un fichier .rdb Valkey ou Redis OSS pour amorcer un nouveau cluster basé sur des nœuds, vous pouvez effectuer les opérations suivantes : + Passez d'un cluster non partitionné à un cluster basé sur un nœud Valkey ou Redis OSS (mode cluster activé) exécutant Redis OSS version 3.2.4. + Spécifiez un certain nombre de partitions (appelées groupes de nœuds dans l'API et la CLI) dans le nouveau cluster basé sur des nœuds. Ce nombre peut être différent du nombre de partitions du cluster basé sur des nœuds qui a été utilisé pour créer le fichier de sauvegarde. + Spécifiez un type de nœud différent pour le nouveau cluster basé sur des nœuds, plus grand ou plus petit que celui utilisé dans le cluster qui a effectué la sauvegarde. Si vous optez pour un type de nœud plus petit, assurez-vous que le nouveau type de nœud dispose de suffisamment de mémoire pour vos données et pour la surcharge de Valkey ou Redis OSS. Pour de plus amples informations, veuillez consulter [S'assurer que vous disposez de suffisamment de mémoire pour créer un instantané Valkey ou Redis OSS](BestPractices.BGSAVE.md). + Répartissez vos clés dans les emplacements du nouveau cluster Valkey ou Redis OSS (mode cluster activé) différemment que dans le cluster utilisé pour créer le fichier de sauvegarde. **Note** Vous ne pouvez pas démarrer un cluster Valkey ou Redis OSS (mode cluster désactivé) à partir d'un fichier .rdb créé à partir d'un cluster Valkey ou Redis OSS (mode cluster activé). **Important** Vous devez vous assurer que vos données de sauvegarde Valkey ou Redis OSS ne dépassent pas les ressources du nœud. Par exemple, vous ne pouvez pas télécharger un fichier .rdb contenant 5 Go de données Valkey ou Redis OSS vers un nœud cache.m3.medium doté de 2,9 Go de mémoire. Si la sauvegarde est trop volumineuse, le cluster obtenu aura le statut `restore-failed`. Si cela se produit, vous devez supprimer le cluster et recommencer. Pour une liste complète des types de nœuds et de leurs spécifications, consultez [Paramètres spécifiques au type de nœud Redis OSS](ParameterGroups.Engine.md#ParameterGroups.Redis.NodeSpecific) la section [Caractéristiques et détails des ElastiCache produits Amazon](https://aws.amazon.com/elasticache/details/). Vous pouvez chiffrer un fichier .rdb Valkey ou Redis OSS uniquement avec le chiffrement côté serveur Amazon S3 (SSE-S3). Pour plus d'informations, consultez [ Protection des données à l'aide du chiffrement côté serveur](https://docs.aws.amazon.com/AmazonS3/latest/dev/serv-side-encryption.html). Vous trouverez ci-dessous des rubriques qui vous guident dans la migration de votre cluster depuis l'extérieur ElastiCache pour Valkey ou Redis OSS vers ElastiCache Redis OSS. **Topics** + [ ## Étape 1 : créer une sauvegarde Valkey ou Redis OSS ](#backups-seeding-redis-create-backup) + [ ## Étape 2 : Créer un compartiment et un dossier Amazon S3 ](#backups-seeding-redis-create-s3-bucket) + [ ## Étape 3 : Charger votre sauvegarde sur Amazon S3 ](#backups-seeding-redis-upload) + [ ## Étape 4 : Accorder l'accès en ElastiCache lecture au fichier .rdb ](#backups-seeding-redis-grant-access) **Topics** + [ ## Étape 1 : créer une sauvegarde Valkey ou Redis OSS ](#backups-seeding-redis-create-backup) + [ ## Étape 2 : Créer un compartiment et un dossier Amazon S3 ](#backups-seeding-redis-create-s3-bucket) + [ ## Étape 3 : Charger votre sauvegarde sur Amazon S3 ](#backups-seeding-redis-upload) + [ ## Étape 4 : Accorder l'accès en ElastiCache lecture au fichier .rdb ](#backups-seeding-redis-grant-access) ## Étape 1 : créer une sauvegarde Valkey ou Redis OSS **Pour créer la sauvegarde Valkey ou Redis OSS afin de démarrer votre ElastiCache instance Redis OSS** 1. Connectez-vous à votre instance Valkey ou Redis OSS existante. 1. Exécutez l'`BGSAVE`une ou `SAVE` l'autre opération pour créer une sauvegarde. Notez l'emplacement de votre fichier .rdb. `BGSAVE` est asynchrone et ne bloque pas les autres clients lors du traitement. Pour plus d'informations, consultez [BGSAVE](https://valkey.io/commands/bgsave) sur le site Web de Valkey. `SAVE` est synchrone et bloque les autres processus jusqu'à la fin. Pour plus d'informations, consultez [SAVE](https://valkey.io/commands/save) sur le site Web de Valkey. Pour plus d'informations sur la création d'une sauvegarde, consultez [Persistence](https://valkey.io/topics/persistence) sur le site Web de Valkey. ## Étape 2 : Créer un compartiment et un dossier Amazon S3 Une fois que vous avez créé le fichier de sauvegarde, vous devez le télécharger dans un dossier du compartiment Amazon S3. Pour cela, vous devez disposer d'un compartiment Amazon S3 et d'un dossier dans ce compartiment. Si vous avez déjà un compartiment et un dossier Amazon S3 avec les autorisations appropriées, vous pouvez ignorer cette étape et passer à [Étape 3 : Charger votre sauvegarde sur Amazon S3](#backups-seeding-redis-upload). **Pour créer un compartiment Amazon S3** 1. Connectez-vous à la console Amazon S3 AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/). 1. Pour créer un compartiment Amazon S3, suivez les instructions de la section [Créer un compartiment](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket.html) dans le *Guide de l'utilisateur de la console Amazon Simple Storage Service*. Le nom de votre compartiment Amazon S3 doit être conforme au DNS. Sinon, ElastiCache vous ne pourrez pas accéder à votre fichier de sauvegarde. Les règles de conformité DNS sont les suivantes : + Les noms de compartiments doivent comporter entre 3 et 63 caractères. + Les noms doivent être une série d'une ou plusieurs étiquettes séparées par un point (.) où chaque étiquette : + Il doit commencer par une minuscule ou un chiffre. + Il doit terminer par une minuscule ou un chiffre. + Contient uniquement des lettres minuscules, des chiffres et des traits d'union. + Il ne peut pas présenter le même format qu'une adresse IP (par exemple, 192.0.2.0). Vous devez créer votre compartiment Amazon S3 dans la même AWS région que votre nouveau ElastiCache cluster Redis OSS. Cette approche garantit la vitesse de transfert de données la plus élevée lors de la ElastiCache lecture de votre fichier .rdb depuis Amazon S3. **Note** Pour sécuriser au maximum vos données, définissez les autorisations les plus restrictives possible sur votre compartiment Amazon S3. Dans le même temps, les autorisations doivent toujours autoriser l'utilisation du bucket et de son contenu pour démarrer votre nouveau cluster Valkey ou Redis OSS. **Pour ajouter un dossier à un compartiment Amazon S3** 1. Connectez-vous à la console Amazon S3 AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/). 1. Choisissez le nom du compartiment dans lequel le fichier .rdb sera téléchargé. 1. Choisissez **Créer un dossier**. 1. Saisissez un nom dans votre nouveau dossier. 1. Choisissez **Enregistrer**. Notez le nom du compartiment et celui du dossier. ## Étape 3 : Charger votre sauvegarde sur Amazon S3 Maintenant, téléchargez le fichier .rdb que vous avez créé dans [Étape 1 : créer une sauvegarde Valkey ou Redis OSS](#backups-seeding-redis-create-backup). Vous le téléchargez dans le compartiment Amazon S3 et le dossier que vous avez créé dans [Étape 2 : Créer un compartiment et un dossier Amazon S3](#backups-seeding-redis-create-s3-bucket). Pour plus d'informations sur cette tâche, veuillez consulter [Ajouter un objet à un compartiment](https://docs.aws.amazon.com/AmazonS3/latest/userguide/upload-objects.html). Entre les étapes 2 et 3, choisissez le nom du dossier que vous avez créé. **Pour charger votre fichier .rdb dans un dossier Amazon S3** 1. Connectez-vous à la console Amazon S3 AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/). 1. Choisissez le nom du compartiment Amazon S3 que vous avez créé à l'étape 2. 1. Choisissez le nom du dossier que vous avez créé à l'étape 2. 1. Choisissez **Charger**. 1. Choisissez **Add files**. 1. Recherchez le ou les fichiers que vous souhaitez charger, puis choisissez-les. Pour choisir plusieurs fichiers, maintenez la touche Ctrl enfoncée pendant que vous sélectionnez chaque nom de fichier. 1. Choisissez **Ouvrir**. 1. Vérifiez que le ou les bons fichiers figurent dans la boîte de dialogue **Charger**, puis choisissez **Charger**. Notez le chemin de votre fichier .rdb. Par exemple, si le nom de votre compartiment est `myBucket` et que le chemin est `myFolder/redis.rdb`, entrez `myBucket/myFolder/redis.rdb`. Vous avez besoin de ce chemin d'accès pour alimenter le nouveau cluster avec les données de cette sauvegarde. Pour de plus amples informations, veuillez consulter [Limites et restrictions applicables aux compartiments](https://docs.aws.amazon.com/AmazonS3/latest/userguide/BucketRestrictions.html) dans le *Guide de l'utilisateur Amazon Simple Storage Service*. ## Étape 4 : Accorder l'accès en ElastiCache lecture au fichier .rdb Accordez maintenant l'accès en ElastiCache lecture à votre fichier de sauvegarde .rdb. Vous accordez ElastiCache l'accès à votre fichier de sauvegarde d'une manière différente selon que votre compartiment se trouve dans une AWS région par défaut ou dans une AWS région optionnelle. AWS Les régions introduites avant le 20 mars 2019 sont activées par défaut. Vous pouvez commencer à travailler dans ces AWS régions immédiatement. Les régions introduites après le 20 mars 2019, telles que l'Asie-Pacifique (Hong Kong) et Moyen-Orient (Bahreïn), sont désactivées par défaut. Vous devez activer ces régions, ou vous y inscrire, avant de pouvoir les utiliser, comme décrit dans la rubrique [Gestion des régions AWS](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html) dans le document *Références générales AWS*. Choisissez votre approche en fonction de votre AWS région : + Pour une région par défaut, utilisez la procédure de [Accorder l'accès en ElastiCache lecture au fichier .rdb dans une région par défaut](#backups-seeding-redis-default-region). + Pour une région pour laquelle une inscription est nécessaire, utilisez la procédure de [Accorder l'accès en ElastiCache lecture au fichier .rdb dans une région optionnelle](#backups-seeding-opt-in-region). ### Accorder l'accès en ElastiCache lecture au fichier .rdb dans une région par défaut AWS Les régions introduites avant le 20 mars 2019 sont activées par défaut. Vous pouvez commencer à travailler dans ces AWS régions immédiatement. Les régions introduites après le 20 mars 2019, telles que l'Asie-Pacifique (Hong Kong) et Moyen-Orient (Bahreïn), sont désactivées par défaut. Vous devez activer ces régions, ou vous y inscrire, avant de pouvoir les utiliser, comme décrit dans la rubrique [Gestion des régions AWS](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html) dans le document *Références générales AWS*. **Pour accorder un accès en ElastiCache lecture au fichier de sauvegarde dans une AWS région activée par défaut** 1. Connectez-vous à la console Amazon S3 AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/). 1. Choisissez le nom du compartiment S3 qui contient votre fichier .rdb. 1. Choisissez le nom du dossier qui contient votre fichier .rdb. 1. Choisissez le nom de votre fichier de sauvegarde .rdb. Le nom du fichier sélectionné apparaît au-dessus des onglets en haut de la page. 1. Choisissez **Autorisations**. 1. Si **aws-scs-s3-readonly** ou l'un des modèles canoniques de la liste suivante n'est pas répertorié IDs en tant qu'utilisateur, procédez comme suit : 1. Sous **Accès pour les autres AWS comptes**, choisissez **Ajouter un bénéficiaire**. 1. Dans le champ, ajoutez l'identifiant canonique de la AWS région comme indiqué ci-dessous : + AWS GovCloud Région (ouest des États-Unis) : ``` 40fa568277ad703bd160f66ae4f83fc9dfdfd06c2f1b5060ca22442ac3ef8be6 ``` **Important** La sauvegarde doit se trouver dans un compartiment S3 AWS GovCloud (US) pour que vous puissiez la télécharger sur un cluster Valkey ou Redis OSS.AWS GovCloud (US) + AWS Régions activées par défaut : ``` 540804c33a284a299d2547575ce1010f2312ef3da9b3a053c8bc45bf233e4353 ``` 1. Définissez les autorisations sur le compartiment en choisissant **Oui** pour : + **Objet en liste/écriture** + **Autorisations ACL de l'objet en lecture/écriture** 1. Choisissez **Enregistrer**. 1. Choisissez **Présentation**, puis **Télécharger**. ### Accorder l'accès en ElastiCache lecture au fichier .rdb dans une région optionnelle AWS Les régions introduites avant le 20 mars 2019 sont activées par défaut. Vous pouvez commencer à travailler dans ces AWS régions immédiatement. Les régions introduites après le 20 mars 2019, telles que l'Asie-Pacifique (Hong Kong) et Moyen-Orient (Bahreïn), sont désactivées par défaut. Vous devez activer ces régions, ou vous y inscrire, avant de pouvoir les utiliser, comme décrit dans la rubrique [Gestion des régions AWS](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html) dans le document *Références générales AWS*. Accordez maintenant l'accès en ElastiCache lecture à votre fichier de sauvegarde .rdb. **Pour accorder un accès en ElastiCache lecture au fichier de sauvegarde** 1. Connectez-vous à la console Amazon S3 AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/). 1. Choisissez le nom du compartiment S3 qui contient votre fichier .rdb. 1. Choisissez le nom du dossier qui contient votre fichier .rdb. 1. Choisissez le nom de votre fichier de sauvegarde .rdb. Le nom du fichier sélectionné apparaît au-dessus des onglets en haut de la page. 1. Sélectionnez l’onglet **Autorisations**. 1. Sous **Permissions** (Autorisations), choisissez **Bucket policy** (Politique de compartiment), puis **Edit** (Modifier). 1. Mettez à jour la politique pour accorder les autorisations ElastiCache requises pour effectuer des opérations : + Ajoutez `[ "Service" : "region-full-name.elasticache-snapshot.amazonaws.com" ]` à `Principal`. + Ajoutez les autorisations suivantes requises pour exporter un instantané vers le compartiment Amazon S3 : + `"s3:GetObject"` + `"s3:ListBucket"` + `"s3:GetBucketAcl"` La politique mise à jour devrait ressembler à l'exemple suivant. ------ #### [ 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" ] } ] } ``` ------ 1. Sélectionnez **Enregistrer les modifications**. ### Ensemencez le ElastiCache cluster avec les données du fichier .rdb Vous êtes maintenant prêt à créer un ElastiCache cluster et à l'ensemencer avec les données du fichier .rdb. Pour créer le cluster, suivez les instructions de [Création d'un cluster pour Valkey ou Redis OSS](Clusters.Create.md) ou [Création d'un groupe de réplication Valkey ou Redis OSS à partir de zéro](Replication.CreatingReplGroup.NoExistingCluster.md). Assurez-vous de choisir Valkey ou Redis OSS comme moteur de cluster. La méthode que vous utilisez pour savoir ElastiCache où trouver la sauvegarde que vous avez téléchargée sur Amazon S3 dépend de la méthode que vous avez utilisée pour créer le cluster : **Ensemencez le ElastiCache cluster ou le groupe de réplication Redis OSS avec les données du fichier .rdb** + **Utilisation de la ElastiCache console** Lorsque vous sélectionnez **Cluster settings** (Paramètres du cluster), choisissez **Restore from backups** (Restaurer à partir de sauvegardes) comme méthode de création du cluster, puis choisissez **Other backups** (Autres sauvegardes) comme **Source** dans la section **Backup source** (Source de sauvegarde). Dans la zone **Seed RDB file S3 location (Ensemencer l'emplacement S3 du fichier RDB)**, tapez le chemin d'accès Amazon S3 pour le ou les fichiers. Si vous avez plusieurs fichiers .rdb, tapez le chemin d'accès à chaque fichier dans une liste séparée par des virgules. Le chemin Amazon S3 ressemble à `myBucket/myFolder/myBackupFilename.rdb`. + **En utilisant le AWS CLI** Si vous utilisez l'opération `create-cache-cluster` ou `create-replication-group`, définissez le paramètre `--snapshot-arns` afin de spécifier un ARN qualifié pour chaque fichier .rdb. Par exemple, `arn:aws:s3:::myBucket/myFolder/myBackupFilename.rdb`. L'ARN doit résoudre les fichiers de sauvegarde stockés dans Amazon S3. + **Utilisation de l' ElastiCache API** Si vous utilisez l'opération `CreateCacheCluster` ou l'`CreateReplicationGroup` ElastiCache API, utilisez le paramètre `SnapshotArns` pour spécifier un ARN complet pour chaque fichier .rdb. Par exemple, `arn:aws:s3:::myBucket/myFolder/myBackupFilename.rdb`. L'ARN doit résoudre les fichiers de sauvegarde stockés dans Amazon S3. **Important** Lors de l'amorçage d'un cluster Valkey ou Redis OSS (mode cluster activé), vous devez configurer chaque groupe de nœuds (partition) dans le nouveau cluster ou groupe de réplication. Pour ce faire, utilisez le paramètre `--node-group-configuration` (API : `NodeGroupConfiguration`). Pour plus d’informations, consultez les ressources suivantes : CLI : [create-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/create-replication-group.html)dans la AWS CLI référence API : [CreateReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_CreateReplicationGroup.html)dans la référence de ElastiCache l'API Au cours du processus de création de votre cluster, les données de votre sauvegarde Valkey ou Redis OSS sont écrites dans le cluster. Vous pouvez suivre la progression en consultant les messages des ElastiCache événements. Pour ce faire, consultez la ElastiCache console et choisissez **Cache Events**. Vous pouvez également utiliser l'interface de ligne de AWS ElastiCache commande ou l' ElastiCache API pour obtenir des messages d'événements. Pour de plus amples informations, veuillez consulter [Affichage des ElastiCache événements](ECEvents.Viewing.md).