Menemukan titik akhir koneksi di ElastiCache

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

Anda juga dapat membuat koneksi pribadi antara titik akhir VPC dan ElastiCache API dengan membuat antarmuka titik akhir VPC 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 Redis OSS (mode cluster dinonaktifkan), gunakan Titik Akhir Utama untuk semua operasi penulisan. Gunakan Titik Akhir Pembaca untuk membagi koneksi masuk ke titik akhir secara merata di antara semua replika baca. Gunakan masing-masing Titik Akhir Node untuk operasi baca (Dalam hal API/CLI ini disebut sebagai Titik Akhir Baca).
Untuk cluster Valkey atau Redis OSS (mode cluster diaktifkan), gunakan Titik Akhir Konfigurasi cluster untuk semua operasi yang mendukung perintah yang diaktifkan mode cluster. Anda harus menggunakan klien yang mendukung Valkey Cluster atau Redis OSS Cluster. Anda masih dapat membaca dari titik akhir node individual (Dalam hal API/CLI ini disebut sebagai Read Endpoint).

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

Titik akhir mana yang digunakan dengan Memcached.

Untuk cache ElastiCache tanpa server untuk Memcached, cukup dapatkan DNS titik akhir cluster dan port 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 Redis OSS (mode cluster dinonaktifkan) hanya memiliki satu node, titik akhir node digunakan untuk membaca dan menulis. Jika cluster Valkey atau Redis OSS (mode cluster dinonaktifkan) memiliki beberapa node, ada tiga jenis titik akhir; titik akhir utama, 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 secara merata membagi koneksi masuk ke titik akhir antara semua replika baca dalam 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 cluster Redis OSS Anda ElastiCache di Availability Zones (AZ) yang berbeda AWS 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 Redis OSS (mode cluster dinonaktifkan)

Masuk ke Konsol Manajemen AWS 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 Redis OSS (mode cluster dinonaktifkan) dan Valkey atau Redis OSS (mode cluster diaktifkan) cluster.
Untuk menemukan titik akhir Pemb and/or aca Utama cluster, pilih nama cluster (bukan tombol di sebelah kiri).

Titik akhir primer dan Pembaca untuk cluster 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 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 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 Redis OSS (mode cluster dinonaktifkan) terlihat seperti berikut. Ada perbedaan tergantung pada apakah In-Transit enkripsi diaktifkan atau tidak.

In-transit enkripsi tidak diaktifkan


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

In-transit enkripsi diaktifkan


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

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

Cluster Valkey atau Redis OSS (mode cluster diaktifkan) 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 diaktifkan)

Masuk ke Konsol Manajemen AWS 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. read/write 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 AWS CLI for Amazon ElastiCache untuk menemukan titik akhir untuk node dan cluster.

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

Topik

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

Menemukan Titik Akhir untuk Node dan Cluster (AWS CLI)

Anda dapat menggunakan AWS CLI untuk menemukan titik akhir untuk cluster dan node-node-nya 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.

contoh

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.

contoh

Untuk Valkey dan Redis OSS, perintah berikut mengambil informasi cluster untuk cluster mycluster simpul tunggal.

penting

Parameter --cache-cluster-id dapat digunakan dengan ID cluster Valkey node tunggal atau Redis OSS (mode cluster dinonaktifkan) atau id node tertentu dalam grup replikasi. Grup replik --cache-cluster-id asi adalah nilai 4 digit seperti0001. Jika --cache-cluster-id adalah id dari cluster (node) dalam grup replikasi, replication-group-id itu termasuk dalam output.

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.redis7"
            },
            "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": "7.1",
            "ClientDownloadLandingPage": "https://console.aws.amazon.com/elasticache/home#client-download:",
            "CacheClusterCreateTime": "2018-04-25T18:19:28.241Z"
        }
    ]
}

Untuk informasi selengkapnya, lihat topik 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 klasternya dengan describe-replication-groups perintah. 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 Referensi Perintah AWS CLI .

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 Titik Akhir untuk Node dan Cluster (ElastiCache API)
Menemukan Titik Akhir untuk Grup Replikasi Valkey atau Redis OSS (API) ElastiCache

Menemukan Titik Akhir untuk Node dan Cluster (ElastiCache API)

Anda dapat menggunakan ElastiCache API untuk menemukan titik akhir untuk cluster dan node-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.

contoh

Untuk Memcached, perintah berikut mengambil titik akhir konfigurasi (ConfigurationEndpoint) dan titik akhir node individual (Endpoint) untuk cluster mycluster Memcached.


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 DescribeReplicationGroups tindakan tersebut. 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 titik akhir utama (PrimaryEndpoint), titik akhir pembaca (ReaderEndpoint) dan titik akhir node individual (ReadEndpoint) 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>

Lihat informasi yang lebih lengkap di 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 cluster Anda atau grup replikasi

Pecahan di ElastiCache