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.
Commencer à utiliser MemoryDB
Cet exercice explique les étapes à suivre pour créer, autoriser l'accès, s'y connecter et enfin supprimer un cluster MemoryDB à l'aide de la console de gestion MemoryDB.
Note
Dans le cadre de cet exercice, nous vous recommandons d'utiliser l'option Easy create lors de la création d'un cluster et de revenir 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 un Compte AWS
Si vous n'en avez pas Compte AWS, procédez comme suit pour en créer un.
Pour vous inscrire à un Compte AWS
Ouvrez l'https://portal.aws.amazon.com/billing/inscription.
Suivez les instructions en ligne.
Dans le cadre de la procédure d‘inscription, vous recevrez un appel téléphonique et vous saisirez un code de vérification en utilisant le clavier numérique du téléphone.
Lorsque vous vous inscrivez à un Compte AWS, un Utilisateur racine d'un compte AWSest créé. Par défaut, seul l‘utilisateur racine a accès à l‘ensemble des Services AWS et des ressources de ce compte. La meilleure pratique de sécurité consiste à attribuer un accès administratif à un utilisateur, et à utiliser uniquement l‘utilisateur racine pour effectuer les tâches nécessitant un accès utilisateur racine.
AWS vous envoie un e-mail de confirmation une fois le processus d'inscription terminé. À tout moment, vous pouvez consulter l'activité actuelle de votre compte et gérer votre compte en accédant à https://aws.amazon.com/
Création d'un utilisateur doté d'un accès administratif
Une fois que vous vous êtes inscrit à un utilisateur administratif Compte AWS, que vous Utilisateur racine d'un compte AWS l'avez sécurisé AWS IAM Identity Center, que vous l'avez activé et que vous en avez créé un, afin de ne pas utiliser l'utilisateur root pour les tâches quotidiennes.
Sécurisez votre Utilisateur racine d'un compte AWS
-
Connectez-vous en AWS Management Console
tant que propriétaire du compte en choisissant Utilisateur root et en saisissant votre adresse Compte AWS e-mail. Sur la page suivante, saisissez votre mot de passe. Pour obtenir de l‘aide pour vous connecter en utilisant l‘utilisateur racine, consultez Connexion en tant qu‘utilisateur racine dans le Guide de l‘utilisateur Connexion à AWS .
-
Activez l'authentification multifactorielle (MFA) pour votre utilisateur root.
Pour obtenir des instructions, voir Activer un MFA périphérique virtuel pour votre utilisateur Compte AWS root (console) dans le guide de IAM l'utilisateur.
Création d'un utilisateur doté d'un accès administratif
-
Activez IAM Identity Center.
Pour obtenir des instructions, consultez Activation d’ AWS IAM Identity Center dans le Guide de l’utilisateur AWS IAM Identity Center .
-
Dans IAM Identity Center, accordez un accès administratif à un utilisateur.
Pour un didacticiel sur l'utilisation du Répertoire IAM Identity Center comme source d'identité, voir Configurer l'accès utilisateur par défaut Répertoire IAM Identity Center dans le Guide de AWS IAM Identity Center l'utilisateur.
Connexion en tant qu‘utilisateur doté d'un accès administratif
-
Pour vous connecter avec votre utilisateur IAM Identity Center, utilisez l'URLidentifiant envoyé à votre adresse e-mail lorsque vous avez créé l'utilisateur IAM Identity Center.
Pour obtenir de l'aide pour vous connecter en utilisant un utilisateur d'IAMIdentity Center, consultez la section Connexion au portail AWS d'accès dans le guide de Connexion à AWS l'utilisateur.
Attribution d'un accès à d'autres utilisateurs
-
Dans IAM Identity Center, créez un ensemble d'autorisations conforme à la meilleure pratique consistant à appliquer les autorisations du moindre privilège.
Pour obtenir des instructions, consultez Création d’un ensemble d’autorisations dans le Guide de l’utilisateur AWS IAM Identity Center .
-
Attribuez des utilisateurs à un groupe, puis attribuez un accès par authentification unique au groupe.
Pour obtenir des instructions, consultez Ajout de groupes dans le Guide de l’utilisateur AWS IAM Identity Center .
Octroi d’un accès par programmation
Les utilisateurs ont besoin d'un accès programmatique s'ils souhaitent interagir avec AWS l'extérieur du AWS Management Console. La manière d'accorder un accès programmatique dépend du type d'utilisateur qui y accède AWS.
Pour accorder aux utilisateurs un accès programmatique, choisissez l’une des options suivantes.
Quel utilisateur a besoin d’un accès programmatique ? | Pour | Par |
---|---|---|
Identité de la main-d’œuvre (Utilisateurs gérés dans IAM Identity Center) |
Utilisez des informations d'identification temporaires pour signer les demandes programmatiques adressées au AWS CLI AWS SDKs, ou AWS APIs. |
Suivez les instructions de l’interface que vous souhaitez utiliser.
|
IAM | Utilisez des informations d'identification temporaires pour signer les demandes programmatiques adressées au AWS CLI AWS SDKs, ou AWS APIs. | Suivez les instructions de la section Utilisation d'informations d'identification temporaires avec les AWS ressources du Guide de IAM l'utilisateur. |
IAM | (Non recommandé) Utilisez des informations d'identification à long terme pour signer des demandes programmatiques adressées au AWS CLI AWS SDKs, ou AWS APIs. |
Suivez les instructions de l’interface que vous souhaitez utiliser.
|
Voir aussi:
Que contient IAM le guide de IAM l'utilisateur ?
AWS Informations d'identification de sécurité dans la référence AWS générale.
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 IAM via un fournisseur d'identité :
Créez un rôle pour la fédération d’identité. Suivez les instructions de la section Création d'un rôle pour un fournisseur d'identité tiers (fédération) dans le guide de IAM l'utilisateur.
-
IAMutilisateurs :
-
Créez un rôle que votre utilisateur peut assumer. Suivez les instructions de la section Création d'un rôle pour un IAM utilisateur dans le Guide de IAM l'utilisateur.
-
(Non recommandé) Attachez une politique directement à un utilisateur ou ajoutez un utilisateur à un groupe d’utilisateurs. Suivez les instructions de la section Ajouter des autorisations à un utilisateur (console) dans le guide de IAM l'utilisateur.
-
MemoryDB crée et utilise des rôles liés à des services pour fournir des ressources et accéder à d'autres AWS ressources et services en votre nom. Pour que MemoryDB crée un rôle lié à un service pour vous, utilisez la AWS politique -managed 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 :
Téléchargement et configuration du AWS CLI
AWS CLI Il est disponible sur http://aws.amazon.com/cli
Consultez le Guide de l'utilisateur de l'interface de ligne de commande AWS.
Suivez les instructions d'installation AWS CLI et de configuration du AWS CLI.
É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. Dans le cadre de cet exercice de mise en route, 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, consultez MemoryDB.
Votre cluster est lancé dans un cloud privé virtuel (VPC) basé sur le VPC service Amazon.
Création d'un cluster MemoryDB
Les exemples suivants montrent comment créer un cluster à l'aide de AWS Management Console, AWS CLI et MemoryDBAPI.
Pour créer un cluster à l'aide de la console MemoryDB
-
Connectez-vous à la console MemoryDB AWS Management Console et ouvrez-la à l'adresse. https://console.aws.amazon.com/memorydb/
-
Choisissez Clusters dans le volet de navigation de gauche, puis choisissez Create.
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 JSON réponse 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 statut 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 MemoryDBAPI, utilisez l'CreateClusteraction.
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, reportez-vous Authentification avec IAM aux sections etAuthentification des utilisateurs à l'aide de listes de contrôle d'accès () ACLs.
Étape 3 : Autoriser l'accès au cluster
Cette section part du principe que vous êtes familiarisé avec le lancement et la connexion aux EC2 instances Amazon. Pour plus d'informations, consultez le guide de EC2 démarrage Amazon.
Les clusters MemoryDB sont conçus pour être accessibles depuis une instance AmazonEC2. 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 EC2 instance Amazon dans le même Amazon Virtual Private Cloud VPC (Amazon), ce qui sera le cas pour cet exercice.
Avant de pouvoir vous connecter à un cluster à partir d'une EC2 instance, vous devez autoriser l'EC2instance à accéder au cluster.
Le cas d'utilisation le plus courant est celui où une application déployée sur une EC2 instance doit se connecter à un cluster de cette instanceVPC. Le moyen le plus simple de gérer l'accès entre les EC2 instances et les clusters d'une même instance VPC est de procéder comme suit :
-
Créez un groupe VPC de sécurité 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'TCPaccès en utilisant le 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 VPC de sécurité pour vos EC2 instances (serveurs Web et d'applications). Ce groupe de sécurité peut, si nécessaire, autoriser l'accès à l'EC2instance depuis Internet via la table VPC de routage. Par exemple, vous pouvez définir des règles sur ce groupe de sécurité pour autoriser l'TCPaccès à l'EC2instance via 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 EC2 instances. N'importe quel membre du groupe de sécurité peut ainsi accéder aux clusters.
Pour créer une règle dans un groupe VPC de sécurité qui autorise les connexions depuis un autre groupe de sécurité
-
Connectez-vous à la console de AWS gestion et ouvrez la VPC console Amazon à 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 TCPRègle 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 EC2 instances Amazon.
-
-
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 à partir d'un autre AmazonVPC, d'une autre AWS région ou même de votre réseau d'entreprise, consultez ce qui suit :
Étape 4 : Se connecter au cluster
Avant de continuer, terminez la section Étape 3 : Autoriser l'accès au cluster.
Cette section part du principe que vous avez créé une EC2 instance Amazon et que vous pouvez vous y connecter. Pour obtenir des instructions sur la procédure à suivre, consultez le guide de EC2 démarrage Amazon.
Une EC2 instance Amazon ne peut se connecter à un cluster que si vous l'y autorisez.
Trouvez le point de terminaison de votre cluster
Lorsque votre cluster est disponible et que vous y avez un accès autorisé, vous pouvez vous connecter à une EC2 instance Amazon et vous connecter au cluster. Pour cela, vous devez d'abord déterminer le point de terminaison.
Pour en savoir plus sur la manière de trouver vos points de terminaison, consultez les rubriques suivantes :
Se connecter à un cluster MemoryDB (Linux)
Maintenant que vous avez le point de terminaison dont vous avez besoin, vous pouvez vous connecter à une EC2 instance et vous connecter au cluster. Dans l'exemple suivant, vous utilisez l'utilitaire cli pour vous connecter à un cluster à l'aide d'Ubuntu 22. La dernière version de cli prend également en charge les clusters SSL/TLS for connecting encryption/authentication activés.
Connexion aux nœuds MemoryDB à l'aide de redis-cli
Pour accéder aux données depuis les nœuds MemoryDB, vous utilisez des clients qui fonctionnent avec Secure Socket Layer ()SSL. Vous pouvez également utiliser redis-cli avec/TLSsur SSL Amazon Linux et Amazon Linux 2.
Pour utiliser redis-cli pour vous 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 OSS logiciel Redis.
À l'invite de commande de votre EC2 instance, tapez les commandes appropriées pour la version de Linux que vous utilisez.
Amazon Linux 2023
Si vous utilisez Amazon Linux 2023, saisissez ce qui suit :
sudo yum install redis6 -y
Tapez ensuite la commande suivante, en remplaçant le point de terminaison et le port de votre cluster par ceux illustrés dans cet exemple.
redis-cli -h
Primary 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, entrez 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 ce qui suit :
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 install
Après avoir téléchargé et installé l'utilitaire redis-cli, il est recommandé d'exécuter la commande facultative.
make-test
-
Pour vous connecter à un cluster avec le chiffrement et l'authentification activés, entrez cette commande :
redis-cli -h
Primary or Configuration Endpoint
--tls -a'your-password'
-p 6379Note
Si vous installez redis6 sur Amazon Linux 2023, vous pouvez désormais utiliser
redis6-cli
la commande au lieu de :redis-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 de plus amples informations, veuillez consulter Instantané et restauration .
CreateSnapshot
une autorisation est requise pour créer un instantané final. Sans cette autorisation, l'APIappel échouera avec uneAccess Denied
exception.
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 à la console MemoryDB AWS Management Console et ouvrez-la à l'adresse. https://console.aws.amazon.com/memorydb/
-
Pour choisir le cluster à supprimer, cliquez sur le bouton radio situé à 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 de créer un instantané du cluster avant de le supprimer, puis entrez
delete
dans la case de confirmation et cliquez sur 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-name
my-cluster
L'delete-cluster
CLIopération ne supprime qu'un seul cluster. Pour supprimer plusieurs clusters, appelez delete-cluster
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-name
my-cluster
\ --regionus-east-1
Pour Windows :
aws memorydb delete-cluster ^ --cluster-name
my-cluster
^ --regionus-east-1
Pour de plus amples informations, veuillez consulter 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>
L'DeleteCluster
APIopération ne supprime qu'un seul cluster. Pour supprimer plusieurs clusters, appelez DeleteCluster
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 :