Découvrez comment activer et libérer les points de terminaison en connexion directe pour les instances de cluster classiques, et comprenez les limites du mode de connexion directe.
Prérequis
Avant de commencer, assurez-vous que votre instance répond à toutes les exigences suivantes.
Utilisez l'architecture de cluster avec le paramètre Deployment Mode défini sur Classic
Pour une instance de cluster cloud-native déjà en mode de connexion directe, un point de terminaison en connexion directe est fourni par défaut et ne nécessite pas d'activation. L'architecture de cluster cloud-native en mode proxy ne prend pas en charge l'activation du mode de connexion directe.
Pour activer la connexion directe, assurez-vous également que :
L'instance est compatible avec Redis 5.0 et mise à jour vers la dernière version mineure
La sécurité de la couche de transport (TLS) est désactivée — consultez Chiffrement TLS
Le vSwitch dispose de suffisamment d'adresses IP disponibles : la connexion directe alloue une adresse IP au nœud principal de chaque shard, plus une pour le point de terminaison lui-même. Pour une instance à 8 shards, le vSwitch doit disposer d'au moins 9 adresses IP disponibles. Pour vérifier, consultez Interroger le nombre d'adresses IP disponibles pour le vSwitch d'une instance
Pour libérer le point de terminaison privé, assurez-vous également que :
Le mode de connexion directe est déjà activé sur l'instance.
Votre application a été mise à jour pour utiliser un autre point de terminaison, tel que le point de terminaison interne en mode proxy. Consultez Afficher les points de terminaison
Une fois le point de terminaison privé libéré, les clients utilisant ce point de terminaison ne peuvent plus se connecter à l'instance. Mettez à jour la configuration de connexion de votre application avant de procéder.
Limites
Réduction des connexions par shard : Étant donné que le proxy est contourné, le nombre maximal de connexions par shard chute à 10 000 (Redis Open-Source Edition cluster) ou 30 000 (Tair (Enterprise Edition) cluster). En cas de déséquilibre des données — où un shard est fortement sollicité tandis que les autres sont principalement inactifs — les connexions vers ce shard peuvent être épuisées, entraînant l'échec des nouvelles demandes de connexion. Pour diagnostiquer le déséquilibre des données causé par des clés à fort trafic ou des clés volumineuses, consultez Statistiques Top Key et Analyse complète hors ligne des clés.
Mises à niveau majeures et changements de zone bloqués : Après avoir activé le mode de connexion directe, vous ne pouvez pas mettre à niveau la version majeure ni changer la zone de l'instance. Libérez d'abord le point de terminaison privé, puis effectuez la mise à niveau ou le changement de zone. Consultez Mettre à niveau la version majeure et Migrer une instance entre zones.
Modifications de configuration limitées : Lors de la modification de la configuration d'une instance avec connexion directe activée, modifiez uniquement le nombre de shards ou les spécifications des shards, et un seul élément à la fois. Consultez Pourquoi ne puis-je pas modifier les configurations d'une instance de cluster classique (basée sur disque local) ?
Activer la connexion directe
Par défaut, une instance Tair (compatible Redis OSS) utilisant l'architecture de cluster classique se connecte via un point de terminaison de proxy de base de données. Pour rendre l'instance compatible avec le protocole natif Redis Cluster, activez le mode de connexion directe et utilisez le point de terminaison en connexion directe depuis votre client. Cela permet à votre client de contourner le nœud proxy et d'accéder directement aux nœuds de données backend, réduisant ainsi la latence en éliminant le traitement des requêtes par le proxy.
Modes de connexion
| Mode | Fonctionnement | Compromis |
|---|---|---|
| Connexion directe | Le client contourne le proxy et se connecte directement aux nœuds de données backend. | Latence réduite. Le nombre maximal de connexions par shard est réduit : 10 000 pour Redis Open-Source Edition, 30 000 pour Tair (Enterprise Edition). |
| Mode proxy | Les requêtes du client sont transférées par le nœud proxy vers les nœuds de données. Consultez Fonctionnalités Tair Proxy. | Limites de connexion plus élevées. Faible surcharge de traitement par requête. |
Activer la connexion directe
L'activation de la connexion directe n'interrompt pas votre service.
Connectez-vous à la console et accédez à la page Instances. Dans la barre de navigation supérieure, sélectionnez la région de l'instance. Recherchez l'instance et cliquez sur son ID.
Dans la zone Connection Information, cliquez sur Request à droite de Direct Connection.
-
Dans le panneau qui s'affiche, configurez le point de terminaison et le port.
Configuration Description Endpoint Actuellement, seul le préfixe de l'adresse de connexion peut être modifié. Le préfixe est par défaut l'ID de l'instance suivi de pi(par exemple,{InstanceId}pi). Le préfixe personnalisé doit répondre aux exigences suivantes : commence par une lettre minuscule, se termine par une lettre minuscule ou un chiffre, contient uniquement des lettres minuscules, des chiffres et des traits d'union (-), et sa longueur est comprise entre 8 et 66 caractères.Port Number Doit être compris entre 1024 et 65535. Vous pouvez modifier le numéro de port lors de la modification du point de terminaison. Cliquez sur OK.
Pour un exemple de connexion, consultez Se connecter à une instance en mode de connexion directe.
Libérer un point de terminaison privé
Libérez le point de terminaison privé d'une instance ApsaraDB for Redis pour désactiver le mode de connexion directe. Cette opération est requise avant certaines opérations non prises en charge par le mode de connexion directe, telles que la modification des configurations de l'instance ou la mise à niveau d'une version majeure.
Libérer le point de terminaison privé
Connectez-vous à la console et accédez à la page Instances. Dans la barre de navigation supérieure, sélectionnez la région où réside l'instance, puis cliquez sur l'ID de l'instance.
Dans la section Connection Information, cliquez sur Release Connection Address à droite de Private Endpoint (Host).
Dans le panneau qui s'affiche, cliquez sur OK.
FAQ
Je remplis tous les prérequis, mais je ne trouve pas le bouton Apply for Endpoint. Que dois-je faire ?
Mettez à jour l'instance vers la dernière version mineure. Consultez Mettre à jour la version mineure et la version du proxy.
Puis-je utiliser simultanément le point de terminaison en connexion directe et le point de terminaison proxy ?
Pour une architecture de cluster classique, oui — les deux modes peuvent être actifs simultanément. Pour une architecture de cluster cloud-native, un seul mode peut être actif à la fois.
Référence API
| Opération API | Description |
|---|---|
| AllocateDirectConnection | Demander un point de terminaison en connexion directe pour une instance de cluster. |
| ReleaseDirectConnection | Libérer le point de terminaison en connexion directe d'une instance de cluster. |