Recherche de points de terminaison de connexion - Amazon ElastiCache for Redis

Recherche de points de terminaison de connexion

Votre application se connecte à votre cluster à l'aide de points de terminaison. Un point de terminaison est l'adresse unique d'un nœud ou d'un cluster.

Les points de terminaison à utiliser

  • Nœud Redis autonome, utilisez le point de terminaison du nœud pour les opérations de lecture et d'écriture.

     

  • Clusters Redis (mode cluster désactivé), utilisez le point de terminaison primaire pour toutes les opérations d'écriture. Utilisez le Point de terminaison du lecteur pour répartir également les connexions entrantes vers le point de terminaison entre toutes les réplicas lues. Utilisez les points de terminaison de nœud individuels pour les opérations d'écriture (dans l'API/la CLI, ils sont appelés points de terminaison de lecture).

     

  • Clusters Redis (mode cluster activé), utilisez le Point de terminaison de configuration pour toutes les opérations qui prennent en charge les commandes activées en mode cluster. Vous devez utiliser un client qui prend en charge le Cluster Redis (Redis 3.2). Vous pouvez toujours lire à partir des points individuels de terminaison de nœuds (dans l'API/CLI, ceux-ci sont appelés Read Endpoints).

     

Les sections suivantes vous guident à travers la découverte de points de terminaison dont vous aurez besoin pour le moteur utilisé.

Si un cluster Redis (mode cluster désactivé) possède un seul nœud, le point de terminaison de ce dernier est utilisé pour les lectures et écritures. Si un cluster Redis (mode cluster désactivé) a plusieurs nœuds, il y a trois types de points de terminaison : le point de terminaison principal, le point de terminaison du lecteur et les points de terminaison des nœuds.

Le point de terminaison principal est un nom DNS qui est toujours résolu dans le nœud principal du cluster. Le point de terminaison principal n'est pas affecté par les changements apportés à votre cluster, tels que la promotion d'un réplica en lecture au rang de réplica principal. Pour l'activité d'écriture, il est préférable que vos applications se connectent au point de terminaison principal plutôt que directement au nœud principal.

Un point de terminaison du lecteur répartira également les connexions entrantes vers le point de terminaison entre toutes les répliques lues dans un cluster ElastiCache for Redis. Des facteurs supplémentaires, comme le moment où l'application crée les connexions ou la façon dont l'application utilise ou réutilise les connexions, détermineront la distribution du trafic. Les points de terminaison du lecteur suivent les changements de cluster en temps réel au fur et à mesure que des réplicas sont ajoutés ou supprimés. Vous pouvez placer les multiples réplicas en lecture de votre cluster ElastiCache for Redis dans différentes zones de disponibilité AWS (AZ), pour assurer une haute disponibilité des points de terminaison du lecteur.

Note

Un point de terminaison du lecteur n'est pas un équilibreur de charge. Il s'agit d'un enregistrement DNS qui se résoudra à une adresse IP de l'un des nœuds de réplica en mode round robin.

Pour l'activité de lecture, les applications peuvent également se connecter à n'importe quel nœud du cluster. Contrairement au point de terminaison principal, les points de terminaison des nœuds sont résolus dans des points de terminaison spécifiques. En cas de modification dans votre cluster, comme l'ajout ou la suppression d'un réplica, vous devez mettre à jour les points de terminaison des nœuds de votre application.

Pour rechercher les points de terminaison d'un cluster Redis (mode cluster désactivé)

  1. Connectez-vous à la AWS Management Console et ouvrez la console ElastiCache à l'adresse https://console.aws.amazon.com/elasticache/.

  2. Dans le volet de navigation, choisissez Redis.

    L'écran Cluster s'affiche avec la liste des clusters Redis (mode cluster désactivé) et Redis (mode cluster activé).

  3. Pour rechercher les point de terminaison principal et du lecteur du cluster, choisissez la zone située à gauche du nom du cluster.

    Image : point de terminaison principal d'un cluster Redis (mode cluster désactivé)

    Points de terminaison principaux et du lecteur pour un cluster Redis (mode cluster désactivé

    S'il y a un seul nœud dans le cluster, il n'y a aucun point de terminaison principal et vous pouvez passer à l'étape suivante.

  4. Si le cluster Redis (mode cluster désactivé) a des nœuds de réplica, vous pouvez identifier les points de terminaison des nœuds de réplica du cluster en sélectionnant le nom du cluster.

    L'écran des nœuds s'affiche avec chaque nœud du cluster, principal et de réplica, répertorié avec son point de terminaison.

    Image : points de terminaison de nœuds d'un cluster Redis (mode cluster désactivé)

    Points de terminaison de nœuds pour un cluster Redis (mode cluster désactivé

  5. Pour copier un point de terminaison dans le presse-papiers :

    1. Un point de terminaison à la fois : recherchez et sélectionnez le point de terminaison que vous souhaitez copier.

    2. Cliquez avec le bouton droit de la souris sur le point de terminaison en surbrillance, puis choisissez Copier dans le menu contextuel.

    Le point de terminaison en surbrillance est maintenant copié dans votre presse-papiers. Pour plus d'informations sur l'utilisation du point de terminaison pour se connecter à un nœud, consultez Connexion aux nœuds.

Un point de terminaison principal Redis (mode cluster désactivé) se présente comme suit. Il existe une différence selon que le chiffrement en transit est activé ou pas.

Chiffrement en transit non activé

clusterName.xxxxxx.nodeId.regionAndAz.cache.amazonaws.com:port redis-01.7abc2d.0001.usw2.cache.amazonaws.com:6379

Chiffrement en transit activé

primary.clusterName.xxxxxx.regionAndAz.cache.amazonaws.com:port primary.ncit.ameaqx.use1.cache.amazonaws.com:6379

Utilisez le point de terminaison de la configuration pour opérations de lecture et d'écriture. Redis détermine à quel nœud du cluster il doit accéder.

La procédure suivante montre comment rechercher et copier les points de terminaison d'un cluster Redis (mode cluster activé).

Pour rechercher le point de terminaison de configuration d'un cluster Redis (mode cluster activé)

  1. Connectez-vous à la AWS Management Console et ouvrez la console ElastiCache à l'adresse https://console.aws.amazon.com/elasticache/.

  2. Dans le volet de navigation, choisissez Redis.

    Une liste de clusters exécutant une version de Redis s'affiche.

  3. Dans la liste des clusters, choisissez la zone située à gauche d'un cluster exécutant « Clustered Redis ».

    L'écran se développe et affiche des détails sur le cluster sélectionné.

  4. Recherchez le point de terminaison de configuration.

    Image : Point de terminaison de configuration d'un cluster Redis (mode cluster activé)

    Point de terminaison de configuration d'un cluster Redis (mode cluster activé

Pour rechercher les points de terminaison de nœud d'un cluster Redis (mode cluster activé)

  1. Connectez-vous à la AWS Management Console et ouvrez la console ElastiCache à l'adresse https://console.aws.amazon.com/elasticache/.

  2. Dans le volet de navigation, choisissez Redis.

    Une liste de clusters exécutant une version de Redis s'affiche.

  3. Dans la liste des clusters, choisissez le nom d'un cluster exécutant « Clustered Redis ».

    La page des partitions s'ouvre.

  4. Choisissez le nom de la partition pour laquelle vous souhaitez un point de terminaison de nœud.

    Une liste des nœuds de la partition s'affiche avec le point de terminaison de chaque nœud.

  5. Recherchez la colonne Endpoint et lisez le point de terminaison de chaque nœud.

    Image : Points de terminaison de nœud d'un cluster Redis (mode cluster activé)

    Points de terminaison des nœuds pour un cluster Redis (mode cluster activé

Pour copier un point de terminaison dans le presse-papiers

  1. Recherchez le point de terminaison que vous souhaitez copier à l'aide de l'une des procédures précédentes.

  2. Mettez en surbrillance le point de terminaison que vous voulez copier.

  3. Cliquez avec le bouton droit de la souris sur le point de terminaison en surbrillance, puis choisissez Copier dans le menu contextuel.

    Le point de terminaison en surbrillance est maintenant copié dans votre presse-papiers. Pour plus d'informations sur l'utilisation du point de terminaison pour se connecter à un nœud, consultez Connexion aux nœuds.

Un point de terminaison de configuration Redis (mode cluster activé) se présente comme suit.

Chiffrement en transit non activé

clusterName.xxxxxx.regionAndAz.cache.amazonaws.com:port rce.ameaqx.use1.cache.amazonaws.com:6379

Chiffrement en transit activé

clustercfg.clusterName.xxxxxx.regionAndAz.cache.amazonaws.com:port clustercfg.rce.ameaqx.use1.cache.amazonaws.com:6379

Vous pouvez utiliser la AWS CLI pour Amazon ElastiCache afin de découvrir les points de terminaison des nœuds, des clusters et des groupes de réplication.

Recherche des points de terminaison des nœuds et des clusters (AWS CLI)

Vous pouvez utiliser l'AWS CLI pour découvrir les points de terminaison d'un cluster et de ses nœuds avec la commande describe-cache-clusters. Pour les clusters Redis, la commande renvoie le point de terminaison du cluster. Si vous ajoutez le paramètre facultatif --show-cache-node-info, la commande renvoie également les points de terminaison de chaque nœud figurant dans le cluster.

La commande suivante extrait les informations relatives au cluster pour le cluster Redis (mode cluster désactivé) à nœud simple mycluster.

Important

Il est possible d'utiliser le paramètre --cache-cluster-id avec un identifiant de cluster Redis (mode cluster désactivé) à nœud simple ou des identifiants de nœuds spécifiques dans les groupes de réplication Redis. L'--cache-cluster-id d'un groupe de réplication Redis est une valeur à quatre chiffres telle que 0001. Si --cache-cluster-id est l'identifiant d'un cluster (nœud) dans un groupe de réplication Redis, l'replication-group-id est inclus dans la sortie.

Pour Linux, macOS ou Unix :

aws elasticache describe-cache-clusters \ --cache-cluster-id redis-cluster \ --show-cache-node-info

Pour Windows :

aws elasticache describe-cache-clusters ^ --cache-cluster-id redis-cluster ^ --show-cache-node-info

Le résultat de l'opération ci-dessus doit ressembler à cet exemple (format JSON).

{ "CacheClusters": [ { "CacheClusterStatus": "available", "SecurityGroups": [ { "SecurityGroupId": "sg-77186e0d", "Status": "active" } ], "CacheNodes": [ { "CustomerAvailabilityZone": "us-east-1b", "CacheNodeCreateTime": "2018-04-25T18:19:28.241Z", "CacheNodeStatus": "available", "CacheNodeId": "0001", "Endpoint": { "Address": "redis-cluster.ameaqx.0001.use1.cache.amazonaws.com", "Port": 6379 }, "ParameterGroupStatus": "in-sync" } ], "AtRestEncryptionEnabled": false, "CacheClusterId": "redis-cluster", "TransitEncryptionEnabled": false, "CacheParameterGroup": { "ParameterApplyStatus": "in-sync", "CacheNodeIdsToReboot": [], "CacheParameterGroupName": "default.redis3.2" }, "NumCacheNodes": 1, "PreferredAvailabilityZone": "us-east-1b", "AutoMinorVersionUpgrade": true, "Engine": "redis", "AuthTokenEnabled": false, "PendingModifiedValues": {}, "PreferredMaintenanceWindow": "tue:08:30-tue:09:30", "CacheSecurityGroups": [], "CacheSubnetGroupName": "default", "CacheNodeType": "cache.t2.small", "DataTiering": "disabled" "EngineVersion": "3.2.10", "ClientDownloadLandingPage": "https://console.aws.amazon.com/elasticache/home#client-download:", "CacheClusterCreateTime": "2018-04-25T18:19:28.241Z" } ] }

Pour plus d'informations, consultez la rubrique describe-cache-clusters.

Recherche des points de terminaison pour les groupes de réplication (AWS CLI)

Vous pouvez utiliser l'AWS CLI pour découvrir les points de terminaison pour un groupe de réplication et ses clusters avec la commande describe-replication-groups. La commande renvoie le point de terminaison principal du groupe de réplication et une liste de tous les clusters (nœuds) figurant dans le groupe de réplication avec leurs points de terminaison et avec le point de terminaison du lecteur.

L'opération suivante extrait le point de terminaison principal et les points de terminaison du lecteur pour le groupe de réplication myreplgroup. Utilisez le point de terminaison principal pour toutes les opérations d'écriture.

aws elasticache describe-replication-groups \ --replication-group-id myreplgroup

Pour Windows :

aws elasticache describe-replication-groups ^ --replication-group-id myreplgroup

Le résultat de cette opération doit ressembler à cet exemple (format JSON).

{ "ReplicationGroups": [ { "Status": "available", "Description": "test", "NodeGroups": [ { "Status": "available", "NodeGroupMembers": [ { "CurrentRole": "primary", "PreferredAvailabilityZone": "us-west-2a", "CacheNodeId": "0001", "ReadEndpoint": { "Port": 6379, "Address": "myreplgroup-001.1abc4d.0001.usw2.cache.amazonaws.com" }, "CacheClusterId": "myreplgroup-001" }, { "CurrentRole": "replica", "PreferredAvailabilityZone": "us-west-2b", "CacheNodeId": "0001", "ReadEndpoint": { "Port": 6379, "Address": "myreplgroup-002.1abc4d.0001.usw2.cache.amazonaws.com" }, "CacheClusterId": "myreplgroup-002" }, { "CurrentRole": "replica", "PreferredAvailabilityZone": "us-west-2c", "CacheNodeId": "0001", "ReadEndpoint": { "Port": 6379, "Address": "myreplgroup-003.1abc4d.0001.usw2.cache.amazonaws.com" }, "CacheClusterId": "myreplgroup-003" } ], "NodeGroupId": "0001", "PrimaryEndpoint": { "Port": 6379, "Address": "myreplgroup.1abc4d.ng.0001.usw2.cache.amazonaws.com" }, "ReaderEndpoint": { "Port": 6379, "Address": "myreplgroup-ro.1abc4d.ng.0001.usw2.cache.amazonaws.com" } } ], "ReplicationGroupId": "myreplgroup", "AutomaticFailover": "enabled", "SnapshottingClusterId": "myreplgroup-002", "MemberClusters": [ "myreplgroup-001", "myreplgroup-002", "myreplgroup-003" ], "PendingModifiedValues": {} } ] }

Pour plus d'informations, veuillez consulter describe-replication-groups dans la Référence de commande la AWS CLI.

Vous pouvez utiliser l'API pour Amazon ElastiCache afin de découvrir les points de terminaison des nœuds, des clusters et des groupes de réplication.

Recherche des points de terminaison des nœuds et des clusters (API ElastiCache)

Vous pouvez utiliser l'API ElastiCache pour découvrir les points de terminaison d'un cluster et de ses nœuds avec l'action DescribeCacheClusters. Pour les clusters Redis, la commande renvoie le point de terminaison du cluster. Si vous ajoutez le paramètre facultatif ShowCacheNodeInfo, l'action renvoie également les points de terminaison de chaque nœud figurant dans le cluster.

https://elasticache.us-west-2.amazonaws.com/ ?Action=DescribeCacheClusters &CacheClusterId=mycluster &ShowCacheNodeInfo=true &SignatureVersion=4 &SignatureMethod=HmacSHA256 &Timestamp=20150202T192317Z &Version=2015-02-02 &X-Amz-Credential=<credential>

Recherche des points de terminaison pour les groupes de réplication (API ElastiCache)

Vous pouvez utiliser l'API ElastiCache pour découvrir les points de terminaison d'un groupe de réplication et ses clusters avec l'action DescribeReplicationGroups. L'action renvoie le point de terminaison principal du groupe de réplication et une liste de tous les clusters figurant dans le groupe de réplication avec le point de terminaison du lecteur.

L'opération suivante extrait le point de terminaison principal (PrimaryEndpoint), le points de terminaison du lecteur (ReaderEndpoint) et les points de terminaison du nœud individuels (ReadEndpoint) pour le groupe de réplication myreplgroup. Utilisez le point de terminaison principal pour toutes les opérations d'écriture.

https://elasticache.us-west-2.amazonaws.com/ ?Action=DescribeReplicationGroups &ReplicationGroupId=myreplgroup &SignatureVersion=4 &SignatureMethod=HmacSHA256 &Timestamp=20150202T192317Z &Version=2015-02-02 &X-Amz-Credential=<credential>

Pour plus d'informations, consultez DescribeReplicationGroups.