Ricerca degli endpoint di connessione in ElastiCache

L'applicazione si connette al ElastiCache cluster utilizzando gli endpoint. Un endpoint corrisponde all'indirizzo univoco di un nodo o di un cluster.

Quali endpoint utilizzare con Valkey o Redis OSS

nodo autonomo, utilizza l'endpoint del nodo per operazioni di lettura e scrittura.
I cluster Valkery o Valkey o Redis OSS (modalità cluster disabilitata) utilizzano l'endpoint primario per tutte le operazioni di scrittura. Usa l'endpoint di lettura per dividere equamente le connessioni in arrivo verso l'endpoint tra tutte le repliche di lettura. Utilizza i singoli Node Endpoint per le operazioni di lettura (inAPI/CLIquesti sono denominati Read Endpoints).
I cluster Valkey o Redis OSS (modalità cluster abilitata), utilizzano l'endpoint di configurazione del cluster per tutte le operazioni che supportano i comandi abilitati in modalità cluster. È necessario utilizzare un client che supporti Valkey Cluster o Redis Cluster (Redis 3.2OSS). OSS È ancora possibile leggere dagli endpoint dei singoli nodi (inAPI/CLIquesti sono indicati come Read Endpoints).

Nelle sezioni seguenti è illustrato, fase per fase, il processo di individuazione degli endpoint necessari per il motore in esecuzione.

Quali endpoint usare con Memcached

Per una cache ElastiCache serverless con Memcached, è sufficiente acquisire l'endpoint DNS e la porta del cluster dalla console.

Da AWS CLI, usa il describe-serverless-caches comando per acquisire le informazioni sull'endpoint.

Linux


aws elasticache describe-serverless-caches --serverless-cache-name CacheName

Windows


aws elasticache describe-serverless-caches --serverless-cache-name CacheName

L'output dell'operazione precedente dovrebbe assomigliare a questo (JSONformato):


{
    "ServerlessCaches": [
        {
            "ServerlessCacheName": "serverless-memcached",
            "Description": "test",
            "CreateTime": 1697659642.136,
            "Status": "available",
            "Engine": "memcached",
            "MajorEngineVersion": "1.6",
            "FullEngineVersion": "21",
            "SecurityGroupIds": [
                "sg-083eda453e1e51310"
            ],
            "Endpoint": {
                "Address": "serverless-memcached-01.amazonaws.com",
                "Port":11211
            },
            "ARN": "<the ARN>",
            "SubnetIds": [
                "subnet-0cf759df15bd4dc65",
                "subnet-09e1307e8f1560d17"
            ],
            "SnapshotRetentionLimit": 0,
            "DailySnapshotTime": "03:00"
        }
    ]
}

Per un'istanza basata su cluster Memcached, se usi l'individuazione automatica puoi utilizzare l'endpoint di configurazione del cluster per impostare il client Memcached. È necessario quindi utilizzare un client che supporti la funzione di individuazione automatica Auto Discovery.

In caso contrario, occorre configurare il client in modo che si avvalga degli endpoint di nodo individuali per le operazioni di lettura e scrittura. È necessario, inoltre, tenere traccia dei nodi eventualmente aggiunti o rimossi.

Se un cluster Valkery o Valkey o Redis OSS (modalità cluster disabilitata) ha un solo nodo, l'endpoint del nodo viene utilizzato sia per le letture che per le scritture. Se un cluster Valkery o Valkey o Redis OSS (modalità cluster disabilitata) ha più nodi, esistono tre tipi di endpoint: l'endpoint primario, l'endpoint reader e gli endpoint del nodo.

L'endpoint primario è un DNS nome che si risolve sempre nel nodo primario del cluster. L'endpoint primario è immune a modifiche al cluster, ad esempio la promozione di una replica di lettura al ruolo primario. Per attività di scrittura, è preferibile collegare le applicazioni all'endpoint primario.

Un endpoint di lettura suddividerà in modo uniforme le connessioni in entrata all'endpoint tra tutte le repliche di lettura in un cluster (Redis). ElastiCache OSS Ulteriori fattori come, ad esempio, quando l'applicazione crea le connessioni o il modo in cui l'applicazione riutilizza le connessioni determineranno la distribuzione del traffico. Gli endpoint di lettura mantengono le modifiche ai cluster in tempo reale mano a mano che le repliche vengono aggiunte o rimosse. È possibile posizionare le repliche di lettura multiple del cluster ElastiCache (RedisOSS) in diverse zone di disponibilità (AZ) per garantire l'elevata AWS disponibilità degli endpoint di lettura.

Nota

Un endpoint di lettura non è un servizio di load balancer. È un DNS record che verrà risolto in un indirizzo IP di uno dei nodi di replica in modo round robin.

Per attività di lettura, le applicazioni possono inoltre connettersi a qualsiasi nodo nel cluster. A differenza dell'endpoint primario, gli endpoint dei nodi vengono risolti in endpoint specifici. Se apporti una modifica al cluster, ad esempio aggiungendo o eliminando una replica, devi aggiornare gli endpoint dei nodi nell'applicazione.

Per trovare gli endpoint di un cluster Valkery o Valkey o Redis OSS (modalità cluster disabilitata)

Accedi a AWS Management Console e apri la console all'indirizzo. ElastiCache https://console.aws.amazon.com/elasticache/
Dal pannello di navigazione, scegli cluster Valkey o cluster Redis OSS.

Apparirà la schermata dei cluster con un elenco di cluster Valkery o Valkey o Redis (modalità cluster disabilitata) e Valkey o Redis OSS (modalità cluster abilitata). OSS
Per trovare l’endpoint primario e/o l’endpoint di lettura del cluster, scegli il nome del cluster (non il pulsante alla sua sinistra).

Endpoint primari e Reader per un cluster Valkery o Valkey o Redis (modalità cluster disabilitata) OSS

Se il cluster annovera un solo nodo, non c'è alcun endpoint primario e si può passare alla fase successiva.
Se il cluster Valkery o Valkey o Redis OSS (modalità cluster disabilitata) dispone di nodi di replica, è possibile trovare gli endpoint del nodo di replica del cluster scegliendo il nome del cluster e quindi selezionando la scheda Nodi.

Così facendo, viene visualizzata una schermata con l'elenco di tutti i nodi del cluster, primario e di replica, e i relativi endpoint.

Endpoint di nodi per un cluster Valkery o Valkey o Redis (modalità cluster disabilitata) OSS
Per copiare un endpoint negli appunti:
1. Individua, uno alla volta, gli endpoint da copiare.
2. Scegli l'icona di copia direttamente davanti all'endpoint.
L'endpoint è stato correttamente copiato negli appunti. Per informazioni sull'utilizzo dell'endpoint per la connessione a un nodo, consulta Connessione ai nodi Memcached.

Un endpoint primario Valkery o Valkey o Redis OSS (modalità cluster disabilitata) ha un aspetto simile al seguente. Differisce in base all'avvenuta o mancata abilitazione della crittografia dati in transito.

Crittografia dati in transito non abilitata


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

Crittografia dati in transito abilitata


master.clusterName.xxxxxx.regionAndAz.cache.amazonaws.com:port

master.ncit.ameaqx.use1.cache.amazonaws.com:6379

Un cluster Valkey o Redis OSS (abilitato in modalità cluster) ha un unico endpoint di configurazione. Connettendosi all'endpoint di configurazione, la tua applicazione è in grado di scoprire gli endpoint primari e di lettura per ognle partizioni del cluster.

Per trovare l'endpoint di un cluster Valkey o Redis OSS (modalità cluster abilitata)

Accedi a AWS Management Console e apri la console all' ElastiCache indirizzo. https://console.aws.amazon.com/elasticache/
Dal pannello di navigazione, scegli cluster Valkey o cluster Redis OSS.

Apparirà la schermata dei cluster con un elenco di cluster. Scegli il cluster a cui desideri connetterti.
Per trovare l'endpoint di configurazione del cluster, scegli il nome del cluster (non il pulsante di opzione).
L’endpoint di configurazione è visualizzato sotto i dettagli del cluster. Per copiarlo scegli l'icona copia a sinistra dell'endpoint.

Tutti gli endpoint Memcached sono sia di lettura che di scrittura. Per connettersi ai nodi in un cluster Memcached, l'applicazione può utilizzare gli endpoint di ciascun nodo o l'endpoint di configurazione del cluster, insieme all'individuazione automatica. Per avvalersi dell'individuazione automatica è necessario utilizzare un client che la supporti.

Con l'individuazione automatica, l'applicazione client si connette al cluster Memcached tramite l'endpoint di configurazione. Nel momento in cui si ridimensiona il cluster aggiungendo o rimuovendo nodi, l'applicazione viene automaticamente e immediatamente a "conoscenza" di tutti i nodi del cluster ed è in grado di connettersi a essi. Senza l'individuazione automatica, l'applicazione deve fare da sé o spetta all'utente aggiornare manualmente gli endpoint nell'applicazione, per ogni aggiunta o rimozione di un nodo.

Per copiare un endpoint, scegli l'icona di copia direttamente davanti all'indirizzo dell'endpoint. Per informazioni sull'utilizzo dell'endpoint per la connessione a un nodo, consulta Connessione ai nodi Memcached.

Gli endpoint di configurazione e dei nodi sono molto simili. Le differenze sono riportate di seguito in grassetto.


myclustername.xxxxxx.cfg.usw2.cache.amazonaws.com:port   # configuration endpoint contains "cfg"
myclustername.xxxxxx.0001.usw2.cache.amazonaws.com:port  # node endpoint for node 0001

Importante

Se si sceglie di creare un CNAME endpoint di configurazione Memcached, affinché il client di rilevamento automatico lo riconosca CNAME come endpoint di configurazione, è necessario includere nel. .cfg. CNAME

Per Memcached, puoi usare for AWS CLI Amazon ElastiCache per scoprire gli endpoint per nodi e cluster.

Per Redis, puoi usare AWS CLI for Amazon per ElastiCache scoprire gli endpoint per nodi, cluster e anche gruppi di replica.

Argomenti

Individuazione degli endpoint per nodi e cluster (AWS CLI)
Individuazione degli endpoint per i gruppi di OSS replica Valkey o Redis ()AWS CLI

Individuazione degli endpoint per nodi e cluster (AWS CLI)

Puoi usare il AWS CLI per scoprire gli endpoint di un cluster e dei suoi nodi con il comando. describe-cache-clusters Per i cluster Valkey o Redis, il comando restituisce l'endpoint del OSS cluster. Per i cluster Memcached, il comando restituisce l'endpoint di configurazione. Se si include il parametro facoltativo --show-cache-node-info, il comando restituisce, inoltre, gli endpoint dei vari nodi nel cluster.

Il seguente comando recupera l'endpoint di configurazione (ConfigurationEndpoint) e gli endpoint dei singoli nodi (Endpoint) del cluster Memcached mycluster.

Per Linux, macOS o Unix:


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

Per Windows:


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

L'output dell'operazione precedente dovrebbe avere un aspetto simile al seguente (formato). JSON


{
   "CacheClusters": [
   {
       "Engine": "memcached", 
       "CacheNodes": [
          {
             "CacheNodeId": "0001", 
             "Endpoint": {
                "Port": 11211, 
                "Address": "mycluster.amazonaws.com"
             }, 
                "CacheNodeStatus": "available", 
                "ParameterGroupStatus": "in-sync", 
                "CacheNodeCreateTime": "2016-09-22T21:30:29.967Z", 
                "CustomerAvailabilityZone": "us-west-2b"
          }, 
          {
             "CacheNodeId": "0002", 
             "Endpoint": {
                "Port": 11211, 
                "Address": "mycluster.amazonaws.com"
             }, 
                "CacheNodeStatus": "available", 
                "ParameterGroupStatus": "in-sync", 
                "CacheNodeCreateTime": "2016-09-22T21:30:29.967Z", 
                "CustomerAvailabilityZone": "us-west-2b"
          }, 
          {
                "CacheNodeId": "0003", 
                "Endpoint": {
                   "Port": 11211, 
                   "Address": "mycluster.amazonaws.com"
                }, 
                   "CacheNodeStatus": "available", 
                   "ParameterGroupStatus": "in-sync", 
                   "CacheNodeCreateTime": "2016-09-22T21:30:29.967Z", 
                   "CustomerAvailabilityZone": "us-west-2b"
          }
       ], 
       "CacheParameterGroup": {
       "CacheNodeIdsToReboot": [], 
       "CacheParameterGroupName": "default.memcached1.4", 
       "ParameterApplyStatus": "in-sync"
            }, 
            "CacheClusterId": "mycluster", 
            "PreferredAvailabilityZone": "us-west-2b", 
            "ConfigurationEndpoint": {
                "Port": 11211, 
                "Address": "mycluster.amazonaws.com"
            }, 
            "CacheSecurityGroups": [], 
            "CacheClusterCreateTime": "2016-09-22T21:30:29.967Z", 
            "AutoMinorVersionUpgrade": true, 
            "CacheClusterStatus": "available", 
            "NumCacheNodes": 3, 
            "ClientDownloadLandingPage": "https://console.aws.amazon.com/elasticache/home#client-download:", 
            "CacheSubnetGroupName": "default", 
            "EngineVersion": "1.4.24", 
            "PendingModifiedValues": {}, 
            "PreferredMaintenanceWindow": "mon:09:00-mon:10:00", 
            "CacheNodeType": "cache.m4.large",
             "DataTiering": "disabled"
        }
    ]   
}

Importante

Se scegli di creare un CNAME endpoint di configurazione Memcached, affinché il tuo client di auto discovery lo riconosca CNAME come endpoint di configurazione, devi includere nel. .cfg. CNAME Ad esempio, mycluster.cfg.local nel file php.ini per il parametro session.save_path.

Per Valkey e RedisOSS, il comando seguente recupera le informazioni sul cluster a nodo singolo mycluster.

Importante

Il parametro --cache-cluster-id può essere utilizzato con ID cluster Valkey o Redis a nodo singolo OSS (modalità cluster disabilitata) o ID di nodo specifici nei gruppi di replica. Il valore --cache-cluster-id di un gruppo di replica è un valore a 4 cifre come. 0001 Se --cache-cluster-id è l'id di un cluster (nodo) in un gruppo di replica, replication-group-id viene incluso nell'output.

Per Linux, macOS o Unix:


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

Per Windows:


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

L'output dell'operazione precedente dovrebbe avere un aspetto simile al seguente (JSONformato).


{
    "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.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"
        }
    ]
}

Per ulteriori informazioni, consulta l'argomento describe-cache-clusters.

Individuazione degli endpoint per i gruppi di OSS replica Valkey o Redis ()AWS CLI

È possibile utilizzare il AWS CLI per scoprire gli endpoint di un gruppo di replica e dei relativi cluster con il comando. describe-replication-groups Il comando restituisce l'endpoint primario del gruppo di replica e l'elenco di tutti i cluster (nodi) nel gruppo di replica con i loro endpoint insieme all'endpoint di lettura.

L'operazione seguente recupera l'endpoint primario e l'endpoint di lettura per il gruppo di replica myreplgroup. Utilizza l'endpoint primario per tutte le operazioni di scrittura.


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

Per Windows:


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

L'output di questa operazione dovrebbe essere simile al seguente (formato)JSON.


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

Per ulteriori informazioni, vedere describe-replication-groupsnella Guida ai AWS CLI comandi.

Per Memcached, puoi usare Amazon ElastiCache API per scoprire gli endpoint per nodi e cluster.

Per Redis, puoi utilizzare Amazon ElastiCache API per scoprire gli endpoint per nodi, cluster e anche gruppi di replica.

Argomenti

Ricerca di endpoint per nodi e cluster () ElastiCache API
Ricerca degli endpoint per i gruppi di replica Valkey o Redis () OSS ElastiCache API

Ricerca di endpoint per nodi e cluster () ElastiCache API

Puoi usare il ElastiCache API per scoprire gli endpoint di un cluster e dei relativi nodi con l'azione. DescribeCacheClusters Per i cluster Valkey o Redis, il comando restituisce l'endpoint del OSS cluster. Per i cluster Memcached, il comando restituisce l'endpoint di configurazione. Se si include il parametro facoltativo ShowCacheNodeInfo, l'operazione restituisce, inoltre, gli endpoint dei vari nodi nel cluster.

Per Memcached, il comando seguente recupera l'endpoint di configurazione (ConfigurationEndpoint) e gli endpoint dei singoli nodi () per il cluster Memcached mycluster. Endpoint


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>

Importante

Ricerca degli endpoint per i gruppi di replica Valkey o Redis () OSS ElastiCache API

È possibile utilizzare l'azione ElastiCache API per scoprire gli endpoint di un gruppo di replica e dei relativi cluster. DescribeReplicationGroups Il comando restituisce l'endpoint primario del gruppo di replica e l'elenco di tutti i cluster nel gruppo di replica con i loro endpoint insieme all'endpoint di lettura.

La seguente operazione recupera l'endpoint primario (PrimaryEndpoint), l'endpoint del lettore () e gli endpoint dei singoli nodi (ReaderEndpoint) per il gruppo di replica. ReadEndpoint myreplgroup Utilizza l'endpoint primario per tutte le operazioni di scrittura.


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>

Per ulteriori informazioni, vedere. DescribeReplicationGroups

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Accesso al ElastiCache cluster o al gruppo di replica

Frammenti dentro ElastiCache