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 Configuration Endpoint (point de terminaison de la 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.

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 panneau de navigation, choisissez Redis clusters (Clusters 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 points de terminaison principaux et/ou lecteurs du cluster, choisissez le nom du cluster (et non le bouton à sa gauche).

    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, puis l'onglet Nodes (Nœuds).

    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 le point de terminaison que vous souhaitez copier.

    2. Cliquez sur l'icône de copie située juste devant le point de terminaison.

    Le point de terminaison 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é

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

Un cluster Redis (mode cluster activé) possède un seul point de terminaison de configuration. En se connectant au point de terminaison de configuration, votre application est en mesure de découvrir les points de terminaison principal et de lecture pour chaque partition du cluster.

Pour rechercher le point de terminaison 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 panneau de navigation, choisissez Redis clusters (Clusters Redis).

    L'écran Cluster s'affiche avec la liste des clusters Redis (mode cluster désactivé) et Redis (mode cluster activé). Choisissez le cluster Redis (mode cluster activé) auquel vous souhaitez vous connecter.

  3. Pour rechercher le point de terminaison de la configuration du cluster, choisissez le nom du cluster (et non le bouton radio).

  4. Le Configuration endpoint (point de terminaison de la configuration) est affiché sous Cluster details (Détails du cluster). Pour le copier, choisissez l'icône de copie à gauche du point de terminaison.

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.