Menambahkan Penemuan Otomatis ke Pustaka Klien Anda

Informasi konfigurasi untuk Penemuan Otomatis disimpan secara redundan di setiap simpul klaster cache. Aplikasi klien dapat mengkueri 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 ASCII dan protokol biner Memcached oleh ElastiCache, dan diimplementasikan di dalam ElastiCache Cluster Client. 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 protokol ASCII; namun, perintah config mendukung baik ASCII maupun biner. Jika Anda ingin menambahkan dukungan Penemuan Otomatis menggunakan protokol biner, lihat Kode sumber untuk ElastiCache Cluster Client.

Sintaksis

config [sub-command] [key]

Opsi

Nama	Deskripsi	Diperlukan
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 kunci "AmazonElastiCache:cluster", karena kunci ini menyimpan informasi konfigurasi klaster. Jika Anda melakukan perubahan pada kunci ini, maka klien dapat salah dikonfigurasi untuk jangka waktu singkat (tidak lebih dari 15 detik) sebelum ElastiCache melakukan pembaruan dengan informasi konfigurasi yang benar secara otomatis.

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 simpul ditampilkan dengan CNAME dan alamat IP privat. CNAME akan selalu ada; jika alamat IP privat tidak tersedia, maka tidak akan ditampilkan; namun, karakter pipa ”|“ akan tetap 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 dimodifikasi 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.