Menambahkan Penemuan Otomatis ke pustaka klien Memcached Anda - Amazon ElastiCache

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

Menambahkan Penemuan Otomatis ke pustaka klien Memcached Anda

Informasi konfigurasi untuk Auto Discovery disimpan secara berlebihan di setiap node cluster cache Memcached. Aplikasi klien dapat mengueri simpul cache apa pun dan memperoleh informasi konfigurasi untuk semua simpul di klaster tersebut.

Cara sebuah aplikasi melakukannya akan tergantung pada versi mesin cache:

  • Jika versi mesin cache adalah 1.4.14 atau lebih tinggi, gunakan perintah config.

  • Jika versi mesin cache lebih rendah dari 1.4.14, gunakan perintah get AmazonElastiCache:cluster.

Output dari kedua perintah ini identik, dan dijelaskan pada bagian Format Output di bawah ini.

Mesin Cache Versi 1.4.14 atau Lebih Tinggi

Untuk versi mesin cache 1.4.14 atau lebih tinggi, gunakan perintah config. Perintah ini telah ditambahkan ke protokol Memcached ASCII dan biner oleh ElastiCache, dan diimplementasikan di Cluster Client. ElastiCache Jika Anda ingin menggunakan Penemuan Otomatis dengan pustaka klien lain, maka pustaka itu akan perlu diperluas untuk mendukung perintah config.

catatan

Dokumentasi berikut berkaitan dengan ASCII protokol; Namun, config perintah mendukung keduanya ASCII dan biner. Jika Anda ingin menambahkan dukungan Auto Discovery menggunakan protokol biner, lihat kode sumber untuk Klien ElastiCache Cluster.

Sintaksis

config [sub-command] [key]

Opsi

Nama Deskripsi Wajib
sub-command

Sub-perintah yang digunakan untuk berinteraksi dengan simpul cache. Untuk Penemuan Otomatis, sub-perintah ini adalah get.

Ya
key

Kunci yang digunakan untuk menyimpan konfigurasi klaster. Untuk Penemuan Otomatis, kunci ini disebut cluster.

Ya

Untuk mendapatkan informasi konfigurasi klaster, gunakan perintah berikut:

config get cluster

Mesin Cache Versi Lebih Rendah dari 1.4.14

Untuk mendapatkan informasi konfigurasi klaster, gunakan perintah berikut:

get AmazonElastiCache:cluster
catatan

Jangan mengutak-atik tombol “: clusterAmazonElastiCache”, karena di sinilah informasi konfigurasi cluster berada. Jika Anda menimpa kunci ini, maka klien mungkin salah dikonfigurasi untuk jangka waktu singkat (tidak lebih dari 15 detik) sebelum memperbarui informasi konfigurasi ElastiCache secara otomatis dan benar.

Format Output

Tergantung pada Anda menggunakan config get cluster atau get AmazonElastiCache:cluster, balasannya terdiri dari dua baris:

  • Nomor versi informasi konfigurasi. Setiap kali simpul ditambahkan atau dihapus dari klaster cache, nomor versi bertambah satu angka.

  • Daftar simpul cache. Setiap simpul dalam daftar dinyatakan dengan grup hostname|ip-address|port, dan setiap simpul dibatasi dengan spasi.

Karakter carriage return dan linefeed (CR+LF) muncul di akhir setiap baris. Baris data mengandung karakter linefeed (LF) di bagian akhir, tempat CR + LF ditambahkan. Baris versi konfigurasi diakhiri dengan LF tanpa CR.

Klaster cache yang berisi tiga simpul akan dinyatakan sebagai berikut:

configversion\n hostname|ip-address|port hostname|ip-address|port hostname|ip-address|port\n\r\n

Setiap node ditampilkan dengan alamat IP pribadi CNAME dan pribadi. CNAMEAkan selalu ada; jika alamat IP pribadi tidak tersedia, itu tidak akan ditampilkan; Namun, karakter pipa "|" masih akan dicetak.

contoh

Berikut adalah contoh payload yang ditampilkan ketika Anda membuat kueri informasi konfigurasi:

CONFIG cluster 0 136\r\n 12\n myCluster.pc4ldq.0001.use1.cache.amazonaws.com|10.82.235.120|11211 myCluster.pc4ldq.0002.use1.cache.amazonaws.com|10.80.249.27|11211\n\r\n END\r\n
catatan
  • Baris kedua menunjukkan bahwa informasi konfigurasi telah diubah dua belas kali sampai saat ini.

  • Pada baris ketiga, daftar simpul ditampilkan dalam urutan abjad berdasarkan nama host. Pengurutan ini mungkin berbeda dengan yang Anda gunakan saat ini pada aplikasi klien Anda.