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.
Premiers pas avec MemoryDB
Cet exercice explique les étapes à suivre pour créer un cluster MemoryDB, lui accorder l'accès, s'y connecter et enfin le supprimer à l'aide de la console de gestion MemoryDB.
Note
Pour les besoins de cet exercice, nous vous recommandons d'utiliser Création facile lors de la création d'un cluster et revenez aux deux autres options une fois que vous aurez exploré plus en détail les fonctionnalités de MemoryDB.
Rubriques
Étape 1 : Configuration
Vous trouverez ci-dessous des rubriques qui décrivent les actions ponctuelles que vous devez effectuer pour commencer à utiliser MemoryDB.
Inscrivez-vous pour Compte AWS
Pour commencer AWS, vous avez besoin d'un Compte AWS. Il existe deux manières de s'inscrire AWS. Si vous souhaitez contrôler totalement la configuration de votre compte et l'emplacement de stockage de votre contenu, ou si vous avez des charges de travail réglementées telles que HIPAA ou FedRAMP, utilisez Inscrivez-vous pour AWS (avancé). Si vous êtes un nouvel utilisateur et que vous souhaitez utiliser un identifiant que vous possédez déjà pour vous connecter AWS et créez un AWS environnement avec des valeurs par défaut préconfigurées dans select Régions AWS, utiliser Inscrivez-vous pour AWS.
Configurez vos autorisations (nouveaux utilisateurs de MemoryDB uniquement)
Pour activer l’accès, ajoutez des autorisations à vos utilisateurs, groupes ou rôles :
-
Utilisateurs et groupes dans AWS IAM Identity Center:
Créez un jeu d’autorisations. Suivez les instructions de la rubrique Création d’un jeu d’autorisations du Guide de l’utilisateur AWS IAM Identity Center .
-
Utilisateurs gérés dans IAM par un fournisseur d’identité :
Créez un rôle pour la fédération d’identité. Suivez les instructions de la rubrique Création d’un rôle pour un fournisseur d’identité tiers (fédération) dans le Guide de l’utilisateur IAM.
-
Utilisateurs IAM :
-
Créez un rôle que votre utilisateur peut assumer. Suivez les instructions de la rubrique Création d’un rôle pour un utilisateur IAM dans le Guide de l’utilisateur IAM.
-
(Non recommandé) Attachez une politique directement à un utilisateur ou ajoutez un utilisateur à un groupe d’utilisateurs. Suivez les instructions de la rubrique Ajout d’autorisations à un utilisateur (console) du Guide de l’utilisateur IAM.
-
MemoryDB crée et utilise des rôles liés à des services pour provisionner des ressources et accéder à d'autres AWS ressources et services en votre nom. Pour que MemoryDB vous crée un rôle lié à un service, utilisez AWS-politique gérée nommée AmazonMemoryDBFullAccess. Ce rôle est préconfiguré avec l'autorisation que le service requiert pour créer un rôle lié au service en votre nom.
Vous pouvez décider de ne pas utiliser la politique par défaut et d'utiliser une politique gérée personnalisée. Dans ce cas, assurez-vous que vous êtes autorisé à appeler iam:createServiceLinkedRole ou que vous avez créé le rôle lié au service MemoryDB.
Pour plus d’informations, consultez les ressources suivantes :
Étape 2 : Créer un cluster
Avant de créer un cluster pour une utilisation en production, vous devez évidemment réfléchir à la façon dont vous allez configurer le cluster pour répondre aux besoins métier. Ces questions sont abordées dans la section Préparation d'un cluster. Aux fins de cet exercice de démarrage, vous pouvez accepter les valeurs de configuration par défaut lorsqu'elles s'appliquent.
Le cluster que vous allez créer sera opérationnel, et non pas exécuté dans un environnement de test (sandbox). Vous devrez payer les frais d'utilisation standard de MemoryDB pour l'instance jusqu'à ce que vous la supprimiez. Le total frais seront minimes (généralement moins d'un dollar) si vous terminez l'exercice décrit ici en une seule fois et que vous supprimez votre cluster quand vous avez terminé. Pour plus d'informations sur les taux d'utilisation de MemoryDB, voir Base de données mémoire
Votre cluster est lancé dans un cloud privé virtuel (VPC) basé sur le service Amazon VPC.
Création d'un cluster MemoryDB
Les exemples suivants montrent comment créer un cluster à l'aide du Console de gestion AWS, AWS CLI et l'API MemoryDB.
Pour créer un cluster à l'aide de la console MemoryDB
-
Connectez-vous au Console de gestion AWS et ouvrez la console MemoryDB à l'adresse https://console.aws.amazon.com/memorydb/
. -
Choisissez Clusters Dans le volet de navigation de gauche, puis choisissez Créez.
Pour créer un cluster à l'aide du AWS CLI, voir create-cluster. Voici un exemple :
Pour Linux, macOS ou Unix :
aws memorydb create-cluster \ --cluster-name my-cluster \ --node-type db.r6g.large \ --acl-name my-acl \ --engine valkey \ --subnet-group my-sg
Pour Windows :
aws memorydb create-cluster ^ --cluster-name my-cluster ^ --node-type db.r6g.large ^ --acl-name my-acl ^ --engine valkey --subnet-group my-sg
Vous devriez obtenir la réponse JSON suivante :
{ "Cluster": { "Name": "my-cluster", "Status": "creating", "NumberOfShards": 1, "AvailabilityMode": "MultiAZ", "ClusterEndpoint": { "Port": 6379 }, "NodeType": "db.r6g.large", "EngineVersion": "7.2", "EnginePatchVersion": "7.2.6", "ParameterGroupName": "default.memorydb-valkey7", "Engine": "valkey" "ParameterGroupStatus": "in-sync", "SubnetGroupName": "my-sg", "TLSEnabled": true, "ARN":"arn:aws:memorydb:us-east-1:xxxxxxxxxxxxxx:cluster/my-cluster", "SnapshotRetentionLimit": 0, "MaintenanceWindow": "wed:03:00-wed:04:00", "SnapshotWindow": "04:30-05:30", "ACLName": "my-acl", "DataTiering": "false", "AutoMinorVersionUpgrade": true } }
Vous pouvez commencer à utiliser le cluster une fois que son état passe à available.
Important
Dès que votre cluster est disponible, vous êtes facturé pour chaque heure ou heure partielle où le cluster est actif, même si vous ne l'utilisez pas activement. Pour ne plus être facturé pour ce cluster, vous devez le supprimer. Consultez Étape 5 : Suppression d’un cluster.
Pour créer un cluster à l'aide de l'API MemoryDB, utilisez le CreateCluster action.
Important
Dès que votre cluster est disponible, vous serez facturé pour chaque heure ou heure partielle où le cluster est actif, même si vous l'utilisez pas. Pour ne plus être facturé pour ce cluster, vous devez le supprimer. Consultez Étape 5 : Suppression d’un cluster.
Configuration de l’authentification
Pour plus d'informations sur la configuration de l'authentification pour votre cluster, consultez Authentification avec IAM et Authentification des utilisateurs à l'aide de listes de contrôle d'accès () ACLs.
Étape 4 : Autoriser l'accès au cluster
Cette section part du principe que vous savez lancer des instances Amazon EC2 et établir des connexions à ces instances. Pour plus d'informations, consultez le Guide de démarrage Amazon EC2.
Les clusters MemoryDB sont conçus pour être accessibles depuis une instance Amazon EC2. Ils sont également accessibles par des applications conteneurisées ou sans serveur exécutées dans Amazon Elastic Container Service ou AWS Lambda. Le scénario le plus courant consiste à accéder à un cluster MemoryDB à partir d'une instance Amazon EC2 dans le même Amazon Virtual Private Cloud (Amazon VPC), ce qui sera le cas pour cet exercice.
Avant de vous connecter à un cluster à partir d'une instance EC2, vous devez autoriser l'instance EC2 à accéder au cluster.
Le cas d'utilisation le plus courant concerne une application déployée sur une instance EC2 qui doit se connecter à un cluster du même VPC. La solution la plus simple pour gérer l'accès entre les instances EC2 et les clusters du même VPC consiste à agir ainsi :
-
Créez un groupe de sécurité VPC pour votre cluster. Ce groupe de sécurité peut être utilisé pour restreindre l'accès aux clusters. Par exemple, vous pouvez créer une règle personnalisée pour ce groupe de sécurité, qui autorise l'accès TCP à l'aide du port que vous avez attribué au cluster lorsque vous l'avez créé et une adresse IP que vous utiliserez pour accéder au cluster.
Le port par défaut pour les clusters MemoryDB est
6379. -
Créez un groupe de sécurité VPC pour vos instances EC2 (serveurs web et d'application). Ce groupe de sécurité peut, si nécessaire, autoriser l'accès à l'instance EC2 à partir d'Internet via la table de routage du VPC. Par exemple, vous pouvez définir des règles sur ce groupe de sécurité pour autoriser l’accès TCP à l’instance EC2 sur le port 22.
-
Créez des règles personnalisées dans le groupe de sécurité de votre cluster qui autorisent les connexions à partir du groupe de sécurité que vous avez créé pour vos instances EC2. N'importe quel membre du groupe de sécurité peut ainsi accéder aux clusters.
Pour créer une règle dans un groupe de sécurité VPC qui autorise les connexions à partir d'un autre groupe de sécurité
-
Connectez-vous au AWS Console de gestion et ouvrez la console Amazon VPC à l'adresse https://console.aws.amazon.com/vpc
. -
Dans le volet de navigation de gauche, sélectionnez Security Groups.
-
Sélectionnez ou créez un groupe de sécurité que vous utiliserez pour vos clusters. Sous Règles entrantes, sélectionnez Modifier les règles entrantes, puis Ajouter une règle. Ce groupe de sécurité autorisera l'accès aux membres d'un autre groupe de sécurité.
-
Dans Type, choisissez Règle TCP personnalisée.
-
Pour Plage de ports, spécifiez le port utilisé lors de la création de votre cluster.
Le port par défaut pour les clusters MemoryDB est
6379. -
Dans le champ Source, saisissez l'ID de votre groupe de sécurité. Dans la liste, sélectionnez le groupe de sécurité que vous utiliserez pour vos instances Amazon EC2.
-
-
Choisissez Enregistrer lorsque vous avez terminé.
Une fois que vous avez activé l'accès, vous êtes prêt à vous connecter au cluster, comme indiqué dans la section suivante.
Pour plus d'informations sur l'accès à votre cluster MemoryDB depuis un autre Amazon VPC, AWS Selon votre région, ou même votre réseau d'entreprise, consultez les informations suivantes :
Étape 4 : connexion au cluster
Avant de continuer, terminez la section Étape 4 : Autoriser l'accès au cluster.
Cette section suppose que vous avez créé une instance Amazon EC2 et que vous pouvez vous y connecter. Pour obtenir des instructions sur la façon de procéder, consultez le Guide de démarrage Amazon EC2.
Une instance Amazon EC2 ne peut se connecter à un cluster que si vous l'y avez autorisée.
Trouvez le point de terminaison de votre cluster
Une fois que votre cluster a l'état available (disponible) et que vous avez autorisé l'accès à ce cluster, vous pouvez vous connecter à une instance Amazon EC2 et vous connecter au cluster. Pour cela, vous devez d'abord déterminer le point de terminaison.
Pour en savoir plus sur la façon de trouver vos points de terminaison, consultez les rubriques suivantes :
Connexion à un cluster MemoryDB (Linux)
Maintenant que vous disposez du point de terminaison dont vous avez besoin, vous pouvez vous connecter à une instance EC2 et vous connecter au cluster. Dans l'exemple suivant, vous utilisez cli utilitaire pour se connecter à un cluster à l'aide d'Ubuntu 22. La dernière version de cli prend également en charge SSL/TLS pour connecter encryption/authentication clusters activés.
Connexion aux nœuds MemoryDB à l'aide de redis-cli
Pour accéder aux données des nœuds MemoryDB, vous utilisez des clients qui fonctionnent avec le protocole SSL (Secure Socket Layer). Vous pouvez également utiliser redis-cli avec TLS/SSL sur Amazon Linux et Amazon Linux 2.
Pour utiliser redis-cli pour se connecter à un cluster MemoryDB sur Amazon Linux 2 ou Amazon Linux
Téléchargez et compilez l'utilitaire redis-cli. Cet utilitaire est inclus dans la distribution du logiciel Redis OSS.
À l'invite de commande de votre instance EC2, tapez les commandes appropriées pour la version de Linux que vous utilisez.
Amazon Linux 2023
Si vous utilisez Amazon Linux 2023, saisissez ceci :
sudo yum install redis6 -yTapez ensuite la commande suivante, en remplaçant le point de terminaison et le port de votre cluster par ce qui est illustré dans cet exemple.
redis-cli -hPrimary or Configuration Endpoint--tls -p 6379Pour plus d'informations sur la recherche du point de terminaison, veuillez consulter Rechercher vos points de terminaison de nœud.
Amazon Linux 2
Si vous utilisez Amazon Linux 2, saisissez ceci :
sudo yum -y install openssl-devel gcc wget https://download.redis.io/releases/redis-7.2.5.tar.gz tar xvzf redis-7.2.5.tar.gz cd redis-7.2.5 make distclean make redis-cli BUILD_TLS=yes sudo install -m 755 src/redis-cli /usr/local/bin/Amazon Linux
Si vous utilisez Amazon Linux, saisissez ceci :
sudo yum install gcc jemalloc-devel openssl-devel tcl tcl-devel clang wget wget https://download.redis.io/releases/redis-7.2.5.tar.gz tar xvzf redis-7.2.5.tar.gz cd redis-7.2.5 make redis-cli CC=clang BUILD_TLS=yes sudo install -m 755 src/redis-cli /usr/local/bin/Sur Amazon Linux, vous pouvez également avoir besoin de suivre les étapes suivantes :
sudo yum install clang CC=clang make sudo make installAprès avoir téléchargé et installé l'utilitaire redis-cli, il est recommandé d'exécuter l'utilitaire facultatif
make-testcommande.-
Pour vous connecter à un cluster avec le chiffrement et l'authentification activés, entrez cette commande :
redis-cli -hPrimary or Configuration Endpoint--tls -a'your-password'-p 6379Note
Si vous installez redis6 sur Amazon Linux 2023, vous pouvez désormais utiliser la commande
redis6-cliau lieu deredis-cli:redis6-cli -h Primary or Configuration Endpoint --tls -p 6379
Étape 5 : Suppression d’un cluster
Tant que l'état d'un cluster est available, ce cluster vous est facturé, que vous l'utilisiez activement ou pas. Pour ne plus être facturé, supprimez le cluster.
Avertissement
Lorsque vous supprimez un cluster MemoryDB, vos instantanés manuels sont conservés. Vous pouvez également créer un instantané final avant la suppression du cluster. Les instantanés automatiques ne sont pas conservés. Pour plus d’informations, consultez Instantané et restauration.
CreateSnapshotune autorisation est requise pour créer un instantané final. Sans cette autorisation, l'appel d'API échouera avec unAccess Deniedexception.
La procédure suivante supprime un cluster unique de votre déploiement. Pour supprimer plusieurs clusters, répétez la procédure pour chaque cluster à supprimer. Vous n'avez pas besoin d'attendre la fin de la suppression d'un cluster avant de démarrer la procédure pour en supprimer un autre.
Pour supprimer un cluster
-
Connectez-vous au Console de gestion AWS et ouvrez la console MemoryDB à l'adresse https://console.aws.amazon.com/memorydb/
. -
Pour choisir le cluster à supprimer, cliquez sur le bouton radio à côté du nom du cluster dans la liste des clusters. Dans ce cas, le nom du cluster que vous avez créé sur Étape 2 : Créer un cluster.
-
Pour Actions, choisissez Supprimer.
-
Choisissez d'abord si vous souhaitez créer un instantané du cluster avant de le supprimer, puis entrez
deletedans la boîte de confirmation et Supprimer pour supprimer le cluster, ou choisissez Annuler pour conserver le cluster.Si vous choisissez Delete, le cluster passe à l'état Suppression en cours.
Dès que votre cluster n'est plus répertorié dans la liste des clusters, il n'est plus facturé.
Le code suivant supprime le cluster my-cluster. Dans ce cas, remplacez my-cluster par le nom du cluster que vous avez créé sur Étape 2 : Créer un cluster.
aws memorydb delete-cluster --cluster-namemy-cluster
Le delete-cluster L'opération CLI ne supprime qu'un seul cluster. Pour supprimer plusieurs clusters, appelez delete-cluster pour chaque cluster que vous souhaitez supprimer. Il n'est pas nécessaire d'attendre la fin de la suppression d'un cluster pour en supprimer un autre.
Pour Linux, macOS ou Unix :
aws memorydb delete-cluster \ --cluster-namemy-cluster\ --regionus-east-1
Pour Windows :
aws memorydb delete-cluster ^ --cluster-namemy-cluster^ --regionus-east-1
Pour plus d’informations, consultez delete-cluster.
Le code suivant supprime le cluster my-cluster. Dans ce cas, remplacez my-cluster par le nom du cluster que vous avez créé sur Étape 2 : Créer un cluster.
https://memory-db.us-east-1.amazonaws.com/ ?Action=DeleteCluster &ClusterName=my-cluster &Region=us-east-1 &SignatureVersion=4 &SignatureMethod=HmacSHA256 &Timestamp=20210802T220302Z &X-Amz-Algorithm=Amazon4-HMAC-SHA256 &X-Amz-Date=20210802T220302Z &X-Amz-SignedHeaders=Host &X-Amz-Expires=20210802T220302Z &X-Amz-Credential=<credential> &X-Amz-Signature=<signature>
Le DeleteCluster L'opération d'API ne supprime qu'un seul cluster. Pour supprimer plusieurs clusters, appelez DeleteCluster pour chaque cluster que vous souhaitez supprimer. Il n'est pas nécessaire d'attendre la fin de la suppression d'un cluster pour en supprimer un autre.
Pour plus d’informations, consultez DeleteCluster.
Étapes suivantes
Maintenant que vous avez essayé l'exercice Getting Started, vous pouvez explorer les sections suivantes pour en savoir plus sur MemoryDB et les outils disponibles :
