Menemukan titik akhir koneksi di ElastiCache

Aplikasi Anda terhubung ke ElastiCache klaster Anda menggunakan endpoint. Titik akhir adalah alamat unik dari simpul atau klaster.

Anda juga dapat membuat koneksi pribadi antara VPC dan titik akhir ElastiCache API Anda dengan membuat titik akhir VPC antarmuka melalui. AWS PrivateLink Untuk informasi selengkapnya, lihat ElastiCache API dan antarmuka VPC endpoint ()AWS PrivateLink.

Titik akhir mana yang digunakan dengan Valkey atau Redis OSS.

Untuk node mandiri, gunakan titik akhir node untuk operasi baca dan tulis.
Untuk cluster Valkey atau Valkey atau Redis OSS (mode cluster dinonaktifkan), gunakan Endpoint Utama untuk semua operasi penulisan. Gunakan Titik Akhir Pembaca untuk membagi koneksi masuk ke titik akhir secara merata di antara semua replika baca. Gunakan Titik Akhir Simpul individual untuk operasi baca (Dalam API/CLI, ini disebut sebagai Titik Akhir Baca).
Untuk cluster Valkey atau Redis OSS (mode cluster enabled), gunakan Configuration Endpoint cluster untuk semua operasi yang mendukung perintah yang diaktifkan mode cluster. Anda harus menggunakan klien yang mendukung Valkey Cluster, atau Redis OSS Cluster pada Redis OSS 3.2 dan di atasnya. Anda masih dapat membaca dari titik akhir simpul individual (Dalam API/CLI, ini disebut sebagai Titik Akhir Baca).

Bagian berikut memandu Anda menemukan titik akhir yang Anda perlukan untuk mesin yang sedang Anda jalankan.

Titik akhir mana yang akan digunakan dengan Memcached.

Untuk cache ElastiCache tanpa server untuk Memcached, cukup dapatkan DNS dan port titik akhir cluster dari konsol.

Dari AWS CLI, gunakan describe-serverless-caches perintah untuk memperoleh informasi Endpoint.

Linux


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

Windows


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

Output dari operasi di atas terlihat seperti berikut ini (format JSON):


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

Untuk cluster Memcached berbasis instance, jika Anda menggunakan Automatic Discovery maka Anda dapat menggunakan titik akhir konfigurasi cluster untuk mengonfigurasi klien Memcached Anda. Hal ini berarti Anda harus menggunakan klien yang mendukung Penemuan Otomatis.

Jika tidak menggunakan Penemuan Otomatis, Anda harus mengonfigurasi klien Anda untuk menggunakan titik akhir simpul individual untuk operasi baca dan tulis. Anda juga harus melacak titik akhir saat menambahkan dan menghapus simpul.

Jika cluster Valkey atau Valkey atau Redis OSS (mode cluster dinonaktifkan) hanya memiliki satu node, titik akhir node digunakan untuk membaca dan menulis. Jika klaster Valkey atau Valkey atau Redis OSS (mode cluster dinonaktifkan) memiliki beberapa node, ada tiga jenis titik akhir; titik akhir primer, titik akhir pembaca dan titik akhir node.

Titik akhir primer adalah nama DNS yang selalu diresolusi ke simpul primer di klaster. Titik akhir primer tidak terpengaruh oleh perubahan klaster Anda, seperti promosi replika baca ke peran primer. Untuk aktivitas tulis, sebaiknya aplikasi Anda terhubung ke titik akhir primer.

Titik akhir pembaca akan membagi koneksi masuk secara merata ke titik akhir antara semua replika baca di cluster ElastiCache for Redis OSS. Faktor lain seperti saat aplikasi membuat koneksi atau cara aplikasi menggunakan atau menggunakan ulang koneksi akan menentukan distribusi lalu lintas. Titik akhir pembaca tetap mengikuti perubahan klaster dalam waktu nyata saat replika ditambahkan atau dihapus. Anda dapat menempatkan beberapa replika baca klaster Redis OSS Anda ElastiCache di AWS Availability Zones (AZ) yang berbeda untuk memastikan ketersediaan titik akhir pembaca yang tinggi.

catatan

Titik akhir pembaca bukan penyeimbang beban. Ini adalah catatan DNS yang akan diresolusi sebagai alamat IP dari salah satu simpul replika dengan metode round robin.

Untuk aktivitas baca, aplikasi juga dapat menghubungkan ke simpul mana pun di klaster. Tidak seperti titik akhir primer, titik akhir simpul diresolusi ke titik akhir tertentu. Jika Anda membuat perubahan dalam klaster Anda, seperti menambahkan atau menghapus replika, Anda harus memperbarui titik akhir simpul di aplikasi Anda.

Untuk menemukan titik akhir cluster Valkey atau Valkey atau Redis OSS (mode cluster dinonaktifkan)

Masuk ke AWS Management Console dan buka ElastiCache konsol di https://console.aws.amazon.com/elasticache/.
Dari panel navigasi, pilih cluster Valkey atau cluster Redis OSS.

Layar cluster akan muncul dengan daftar Valkey atau Valkey atau Redis OSS (mode cluster dinonaktifkan) dan Valkey atau Redis OSS (mode cluster diaktifkan) cluster.
Untuk menemukan titik akhir Primer dan/atau Pembaca klaster, pilih nama klaster (bukan tombol di sebelah kirinya).

Titik akhir Primer dan Pembaca untuk cluster Valkey atau Valkey atau Redis OSS (mode cluster dinonaktifkan)

Jika hanya ada satu simpul dalam klaster, berarti tidak ada titik akhir primer dan Anda dapat melanjutkan ke langkah berikutnya.
Jika cluster Valkey atau Valkey atau Redis OSS (mode cluster dinonaktifkan) memiliki node replika, Anda dapat menemukan titik akhir node replika cluster dengan memilih nama cluster dan kemudian memilih tab Nodes.

Layar simpul muncul dengan setiap simpul yang ada di klaster, primer dan replika, yang tercantum dengan titik akhirnya.

Titik akhir node untuk cluster Valkey atau Valkey atau Redis OSS (mode cluster dinonaktifkan)
Untuk menyalin titik akhir ke clipboard Anda:
1. Temukan satu per satu titik akhir yang ingin Anda salin.
2. Pilih ikon salin langsung di depan titik akhir.
Titik akhir sekarang disalin ke clipboard Anda. Untuk informasi tentang menggunakan titik akhir agar terhubung ke simpul, lihat Menghubungkan ke node Memcached.

Titik akhir utama Valkey atau Valkey atau Redis OSS (mode cluster dinonaktifkan) terlihat seperti berikut ini. Ada perbedaan yang tergantung pada apakah enkripsi Bergerak aktif atau tidak.

Enkripsi bergerak tidak diaktifkan


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

Enkripsi bergerak diaktifkan


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

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

Cluster Valkey atau Redis OSS (mode cluster enabled) memiliki titik akhir konfigurasi tunggal. Dengan terhubung ke titik akhir konfigurasi, aplikasi Anda mampu menemukan titik akhir primer dan baca untuk setiap serpihan di klaster.

Untuk menemukan titik akhir cluster Valkey atau Redis OSS (mode cluster enabled)

Masuk ke AWS Management Console dan buka ElastiCache konsol di https://console.aws.amazon.com/elasticache/.
Dari panel navigasi, pilih cluster Valkey atau cluster Redis OSS.

Layar cluster akan muncul dengan daftar cluster. Pilih cluster yang ingin Anda sambungkan.
Untuk menemukan titik akhir Konfigurasi klaster, pilih nama klaster (bukan tombol radio).
Titik akhir konfigurasi ditampilkan di bagian Detail klaster. Untuk menyalinnya, pilih ikon salin di sebelah kiri titik akhir.

Semua titik akhir Memcached adalah titik akhir baca/tulis. Untuk terhubung ke simpul dalam klaster Memcached, aplikasi Anda dapat menggunakan titik akhir untuk setiap simpul, atau titik akhir konfigurasi dari klaster bersama dengan Penemuan Otomatis. Untuk menggunakan Penemuan Otomatis, Anda harus menggunakan klien yang mendukung Penemuan Otomatis.

Saat menggunakan Penemuan Otomatis, aplikasi klien Anda terhubung ke klaster Memcached Anda menggunakan titik akhir konfigurasi. Begitu Anda menskalakan klaster Anda dengan menambahkan atau menghapus simpul, aplikasi Anda akan secara otomatis "mengetahui" semua simpul dalam klaster dan dapat terhubung ke semua simpul tersebut. Tanpa Penemuan Otomatis, aplikasi Anda harus melakukannya, atau Anda harus secara manual memperbarui titik akhir dalam aplikasi Anda setiap kali Anda menambahkan atau menghapus simpul.

Untuk menyalin titik akhir, pilih ikon salin secara langsung di depan alamat titik akhir. Untuk informasi tentang menggunakan titik akhir agar terhubung ke simpul, lihat Menghubungkan ke node Memcached.

Titik akhir konfigurasi dan simpul terlihat sangat mirip. Perbedaannya disorot dengan cetak tebal seperti berikut.


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

penting

Jika Anda memilih untuk membuat CNAME untuk titik akhir konfigurasi Memcached, agar klien penemuan otomatis Anda mengenali CNAME sebagai titik akhir konfigurasi, Anda harus menyertakan .cfg. pada CNAME.

Untuk Memcached, Anda dapat menggunakan for AWS CLI Amazon ElastiCache untuk menemukan titik akhir untuk node dan cluster.

Untuk Redis OSS, Anda dapat menggunakan for AWS CLI Amazon ElastiCache untuk menemukan titik akhir untuk node, cluster, dan juga grup replikasi.

Topik

Menemukan Titik Akhir untuk Simpul dan Klaster (AWS CLI)
Menemukan Titik Akhir untuk Grup Replikasi Valkey atau Redis OSS ()AWS CLI

Menemukan Titik Akhir untuk Simpul dan Klaster (AWS CLI)

Anda dapat menggunakan AWS CLI untuk menemukan titik akhir untuk cluster dan node dengan describe-cache-clusters perintah. Untuk cluster Valkey atau Redis OSS, perintah mengembalikan titik akhir cluster. Untuk klaster Memcached, perintah tersebut akan menampilkan titik akhir konfigurasi. Jika Anda menyertakan parameter opsional --show-cache-node-info, perintah tersebut juga akan menampilkan titik akhir simpul individual di klaster.

Perintah berikut mengambil titik akhir konfigurasi (ConfigurationEndpoint) dan titik akhir simpul individual (Endpoint) untuk klaster Memcached mycluster.

Untuk Linux, macOS, atau Unix:


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

Untuk Windows:


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

Output dari operasi di atas akan terlihat seperti berikut (format 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"
        }
    ]   
}

penting

Jika Anda memilih untuk membuat CNAME untuk titik akhir konfigurasi Memcached agar klien penemuan otomatis Anda mengenali CNAME sebagai titik akhir konfigurasi, Anda harus menyertakan .cfg. pada CNAME. Misalnya, mycluster.cfg.local dalam file php.ini untuk parameter session.save_path.

Untuk Valkey dan Redis OSS, perintah berikut mengambil informasi cluster untuk mycluster single-node cluster.

penting

Parameter --cache-cluster-id dapat digunakan dengan id cluster Valkey atau Redis OSS (mode cluster dinonaktifkan) node tunggal atau id node tertentu dalam grup replikasi. Kelompok replikasi adalah nilai 4 digit seperti. --cache-cluster-id 0001 Jika --cache-cluster-id adalah id dari cluster (node) dalam grup replikasi, termasuk dalam output. replication-group-id

Untuk Linux, macOS, atau Unix:


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

Untuk Windows:


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

Output dari operasi di atas akan terlihat seperti berikut (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.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"
        }
    ]
}

Untuk informasi lebih lanjut, lihat topiknya describe-cache-clusters.

Menemukan Titik Akhir untuk Grup Replikasi Valkey atau Redis OSS ()AWS CLI

Anda dapat menggunakan AWS CLI untuk menemukan titik akhir untuk grup replikasi dan klaster dengan perintah. describe-replication-groups Perintah ini menampilkan titik akhir primer grup replikasi dan daftar semua klaster (simpul) dalam grup replikasi dengan titik akhirnya, bersama dengan titik akhir pembaca.

Operasi berikut mengambil titik akhir primer dan titik akhir pembaca untuk grup replikasi myreplgroup. Gunakan titik akhir primer untuk semua operasi tulis.


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

Untuk Windows:


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

Output dari operasi ini terlihat seperti berikut (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.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": {}
      }
   ]
}

Untuk informasi selengkapnya, lihat describe-replication-groups dalam AWS CLI Referensi Perintah.

Untuk Memcached, Anda dapat menggunakan Amazon ElastiCache API untuk menemukan titik akhir untuk node dan cluster.

Untuk Redis OSS, Anda dapat menggunakan Amazon ElastiCache API untuk menemukan titik akhir untuk node, cluster, dan juga grup replikasi.

Topik

Menemukan Endpoint untuk Node dan Cluster (API) ElastiCache
Menemukan Titik Akhir untuk Grup Replikasi Valkey atau Redis OSS (API) ElastiCache

Menemukan Endpoint untuk Node dan Cluster (API) ElastiCache

Anda dapat menggunakan ElastiCache API untuk menemukan titik akhir untuk klaster dan node-nya dengan DescribeCacheClusters tindakan tersebut. Untuk cluster Valkey atau Redis OSS, perintah mengembalikan titik akhir cluster. Untuk klaster Memcached, perintah tersebut akan menampilkan titik akhir konfigurasi. Jika Anda menyertakan parameter opsional ShowCacheNodeInfo, tindakan tersebut juga akan menampilkan titik akhir simpul individual di klaster.

Untuk Memcached, perintah berikut mengambil konfigurasi endpoint (ConfigurationEndpoint) dan titik akhir node individual (Endpoint) untuk mycluster Memcached 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>

penting

Menemukan Titik Akhir untuk Grup Replikasi Valkey atau Redis OSS (API) ElastiCache

Anda dapat menggunakan ElastiCache API untuk menemukan titik akhir untuk grup replikasi dan klasternya dengan tindakan tersebut. DescribeReplicationGroups Perintah ini menampilkan titik akhir primer grup replikasi dan daftar semua klaster dalam grup replikasi dengan titik akhirnya, bersama dengan titik akhir pembaca.

Operasi berikut mengambil endpoint utama (PrimaryEndpoint), endpoint pembaca () dan titik akhir node individu (ReaderEndpointReadEndpoint) untuk grup replikasi. myreplgroup Gunakan titik akhir primer untuk semua operasi tulis.


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>

Untuk informasi selengkapnya, lihat DescribeReplicationGroups.

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Mengakses ElastiCache klaster atau grup replikasi Anda

Pecahan di ElastiCache