Menemukan titik akhir koneksi di ElastiCache - Amazon ElastiCache

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Menemukan titik akhir koneksi di ElastiCache

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

Titik akhir mana yang digunakan dengan Valkey atau Redis OSS
  • node mandiri, gunakan titik akhir node untuk operasi baca dan tulis.

     

  • Valkery atau Valkey atau Redis OSS (mode cluster dinonaktifkan) cluster, 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 Endpoint Node individual untuk operasi baca (DiAPI/CLIini disebut sebagai Read Endpoints).

     

  • Valkey atau Redis OSS (mode cluster enabled) cluster, 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 (Redis 3.2OSS). Anda masih dapat membaca dari titik akhir node individual (DiAPI/CLIini 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 digunakan dengan Memcached

Untuk cache ElastiCache tanpa server dengan Memcached, cukup dapatkan titik akhir DNS dan port 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 akan terlihat seperti ini (JSONformat):

{ "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 klaster Memcached berbasis instans, jika Anda menggunakan Penemuan Otomatis, maka Anda dapat menggunakan titik akhir konfigurasi klaster 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 Valkery atau Valkey atau Redis OSS (mode cluster dinonaktifkan) hanya memiliki satu node, titik akhir node digunakan untuk membaca dan menulis. Jika klaster Valkery 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 DNS nama yang selalu menyelesaikan simpul utama di cluster. 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 dalam cluster ElastiCache (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 ElastiCache (RedisOSS) Anda di AWS Availability Zones (AZ) yang berbeda untuk memastikan ketersediaan titik akhir pembaca yang tinggi.

catatan

Titik akhir pembaca bukan penyeimbang beban. Ini adalah DNS catatan yang akan menyelesaikan ke alamat IP dari salah satu node replika dengan cara 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 Valkery atau Valkey atau Redis OSS (mode cluster dinonaktifkan)
  1. Masuk ke AWS Management Console dan buka ElastiCache konsol di https://console.aws.amazon.com/elasticache/.

  2. Dari panel navigasi, pilih cluster Valkey atau cluster Redis. OSS

    Layar cluster akan muncul dengan daftar Valkery atau Valkey atau Redis (mode cluster dinonaktifkan) dan Valkey atau Redis OSS OSS (mode cluster diaktifkan) cluster.

  3. Untuk menemukan titik akhir Primer dan/atau Pembaca klaster, pilih nama klaster (bukan tombol di sebelah kirinya).

    Gambar: Titik akhir utama untuk cluster Valkery atau Valkey atau Redis OSS (mode cluster dinonaktifkan)

    Titik akhir Primer dan Pembaca untuk cluster Valkery 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.

  4. Jika cluster Valkery 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.

    Gambar: Titik akhir node untuk cluster Valkery atau Valkey atau Redis OSS (mode cluster dinonaktifkan)

    Titik akhir node untuk cluster Valkery atau Valkey atau Redis OSS (mode cluster dinonaktifkan)

  5. 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 Valkery 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 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 klaster Valkey atau Redis OSS (mode cluster diaktifkan)
  1. Masuk ke AWS Management Console dan buka ElastiCache konsol di https://console.aws.amazon.com/elasticache/.

  2. Dari panel navigasi, pilih cluster Valkey atau cluster Redis. OSS

    Layar cluster akan muncul dengan daftar cluster. Pilih cluster yang ingin Anda sambungkan.

  3. Untuk menemukan titik akhir Konfigurasi klaster, pilih nama klaster (bukan tombol radio).

  4. 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 CNAME untuk membuat titik akhir konfigurasi Memcached untuk Anda, agar klien penemuan otomatis Anda mengenali titik akhir konfigurasi CNAME sebagai konfigurasi, Anda harus menyertakan dalam. .cfg. CNAME

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

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

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, perintah mengembalikan titik akhir OSS 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 ini (JSONformat).

{ "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 CNAME untuk membuat titik akhir konfigurasi Memcached untuk Anda, agar klien penemuan otomatis Anda mengenali titik akhir konfigurasi CNAME sebagai konfigurasi, Anda harus menyertakan dalam. .cfg. CNAME Misalnya, mycluster.cfg.local dalam file php.ini untuk parameter session.save_path.

Untuk Valkey dan RedisOSS, 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 ini (JSONformat).

{ "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 OSS Replikasi Valkey atau Redis ()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 akan terlihat seperti ini (JSONformat).

{ "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-groupsdi Referensi AWS CLI Perintah.

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

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

Menemukan Endpoint untuk Node dan Cluster () ElastiCache API

Anda dapat menggunakan ElastiCache API untuk menemukan titik akhir untuk cluster dan node dengan DescribeCacheClusters tindakan. Untuk cluster Valkey atau Redis, perintah mengembalikan titik akhir OSS 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

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

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

Anda dapat menggunakan ElastiCache API untuk menemukan titik akhir untuk grup replikasi dan klaster dengan tindakan. 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 lebih lanjut, lihat DescribeReplicationGroups.