Referensi - Amazon ElastiCache
Mengatur AWS CLI untuk ElastiCache

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

Referensi

Topik di bagian ini mencakup bekerja dengan Amazon ElastiCache API dan ElastiCache bagian dari AWS CLI. Juga disertakan pada bagian ini adalah pesan kesalahan dan notifikasi layanan yang umum.

Menyiapkan antarmuka baris ElastiCache perintah

Bagian ini menjelaskan prasyarat untuk menjalankan alat baris perintah, tempat mendapatkannya, cara mengatur lingkungannya, dan contoh umum penggunaan alat ini.

Ikuti instruksi dalam topik ini hanya jika Anda mau ElastiCache. AWS CLI

penting

Amazon ElastiCache Command Line Interface (CLI) tidak mendukung ElastiCache perbaikan apa pun setelah versi API 2014-09-30. Untuk menggunakan ElastiCache fungsionalitas yang lebih baru dari baris perintah, gunakan antarmuka baris AWS perintah.

Prasyarat

Dokumen ini mengasumsikan bahwa Anda dapat bekerja di lingkungan Linux/UNIX atau Windows. Alat baris ElastiCache perintah Amazon juga berfungsi pada Mac OS X, yang merupakan lingkungan berbasis Unix; Namun, tidak ada instruksi Mac OS X tertentu yang disertakan dalam panduan ini.

Sebagai konvensi, semua teks baris perintah diawali dengan prompt baris perintah PROMPT> generik. Prompt baris perintah yang sebenarnya pada mesin Anda mungkin berbeda. Kami juga menggunakan $ untuk menunjukkan perintah Linux/UNIX tertentu dan C:\> untuk perintah khusus Windows. Contoh output yang dihasilkan dari perintah ditampilkan tepat setelahnya tanpa awalan apa pun.

Lingkungan runtime Java

Alat baris perintah yang digunakan dalam panduan ini memerlukan Java versi 5 atau yang lebih baru. Dapat menggunakan penginstalan JRE atau JDK. Untuk melihat dan mengunduh JREs berbagai platform, termasuk Linux/UNIX dan Windows, lihat Unduhan Java SE.

Mengatur variabel Java Home

Alat baris perintah bergantung pada variabel lingkungan (JAVA_HOME) untuk menemukan Java Runtime. Variabel lingkungan ini harus ditetapkan ke jalur lengkap dari direktori yang berisi subdirektori bernama bin yang berisi executable java (di Linux dan UNIX) atau executable java.exe (di Windows).

Untuk mengatur variabel Java Home

  1. Atur variabel Java Home.

    • Di Linux dan UNIX, masukkan perintah berikut:

      $ export JAVA_HOME=<PATH>

    • Di Windows, masukkan perintah berikut:

      C:\> set JAVA_HOME=<PATH>

  2. Konfirmasikan pengaturan jalur dengan menjalankan $JAVA_HOME/bin/java -version dan memeriksa output-nya.

    • Di Linux/UNIX, Anda akan melihat output seperti yang berikut ini:

      
$ $JAVA_HOME/bin/java -version
java version "1.6.0_23"
Java(TM) SE Runtime Environment (build 1.6.0_23-b05)
Java HotSpot(TM) Client VM (build 19.0-b09, mixed mode, sharing)

    • Di Windows, Anda akan melihat output seperti yang berikut ini:

      
C:\> %JAVA_HOME%\bin\java -version
java version "1.6.0_23"
Java(TM) SE Runtime Environment (build 1.6.0_23-b05)
Java HotSpot(TM) Client VM (build 19.0-b09, mixed mode, sharing)

Mendapatkan alat baris perintah

Alat baris perintah tersedia sebagai file ZIP pada ElastiCache situs web Alat Developer. Alat-alat ini ditulis dalam Java, dan termasuk skrip shell untuk Windows 2000/XP/Vista/Windows 7, Linux/UNIX, dan Mac OSX. File ZIP bersifat mandiri dan tidak memerlukan penginstalan; cukup unduh file zip lalu ekstrak ke direktori di mesin lokal Anda.

Menyiapkan alat

Alat baris perintah bergantung pada variabel lingkungan (AWS_ELASTICACHE_HOME) untuk menemukan pustaka pendukung. Anda perlu mengatur variabel lingkungan ini sebelum dapat menggunakan alat tersebut. Tetapkan ke jalur direktori tempat Anda mengekstrak file alat baris perintah. Direktori ini bernama ElastiCacheCli -A.B.NNNN (A, B dan n adalah versi/nomor rilis), dan berisi subdirektori bernama bin dan lib.

Untuk mengatur variabel lingkungan AWS_ELASTICACHE_HOME

  • Buka jendela baris perintah dan masukkan salah satu perintah berikut untuk mengatur variabel lingkungan AWS_ELASTICACHE_HOME.

    • Di Linux dan UNIX, masukkan perintah berikut:

      $ export &AWS;_ELASTICACHE_HOME=<path-to-tools>

    • Di Windows, masukkan perintah berikut:

      C:\> set &AWS;_ELASTICACHE_HOME=<path-to-tools>

Agar alat ini lebih mudah digunakan, sebaiknya tambahkan direktori BIN alat ini ke PATH sistem Anda. Sisa dari panduan ini akan mengasumsikan bahwa direktori BIN sudah ada dalam jalur sistem Anda.

Untuk menambahkan direktori BIN alat ini ke jalur sistem Anda

  • Masukkan perintah berikut untuk menambahkan direktori BIN alat ini ke PATH sistem Anda.

    • Di Linux dan UNIX, masukkan perintah berikut:

      $ export PATH=$PATH:$&AWS;_ELASTICACHE_HOME/bin

    • Di Windows, masukkan perintah berikut:

      C:\> set PATH=%PATH%;%&AWS;_ELASTICACHE_HOME%\bin
catatan

Variabel lingkungan Windows direset ketika Anda menutup jendela perintah. Anda sebaiknya menetapkannya secara permanen. Lihat dokumentasi untuk versi Windows Anda untuk informasi selengkapnya.

catatan

Jalur yang berisi spasi harus di-wrapping dengan tanda kutip ganda, misalnya:

"C:\Program Files\Java"

Memberikan kredensial untuk alat

Alat baris perintah memerlukan Kunci AWS Akses dan Kunci Akses Rahasia yang disediakan dengan AWS akun Anda. Anda bisa mendapatkannya menggunakan baris perintah atau dari file kredensial yang terletak di sistem lokal Anda.

Penerapan menyertakan file template $ {AWS_ELASTICACHE_HOME}/credential-file-path.template yang perlu Anda edit dengan informasi Anda. Berikut adalah konten file templat:


AWS AccessKeyId=<Write your AWS access ID>
AWS SecretKey=<Write your AWS secret key>
penting

Di UNIX, batasi izin untuk pemilik file kredensial:

$ chmod 600 <the file created above>

Dengan pengaturan file kredensial, Anda harus mengatur variabel lingkungan AWS_CREDENTIAL_FILE sehingga alat dapat menemukan informasi Anda. ElastiCache

Untuk mengatur variabel lingkungan AWS_CREDENTIAL_FILE

  1. Atur variabel lingkungan:

    • Di Linux dan UNIX, perbarui variabel menggunakan perintah berikut:

      $ export &AWS;_CREDENTIAL_FILE=<the file created above>

    • Di Windows, tetapkan variabel menggunakan perintah berikut:

      C:\> set &AWS;_CREDENTIAL_FILE=<the file created above>

  2. Periksa bahwa pengaturan Anda bekerja dengan baik, jalankan perintah berikut:

    elasticache --help

    Anda harus melihat halaman penggunaan untuk semua perintah ElastiCache.

Variabel lingkungan

Variabel lingkungan dapat berguna untuk membuat skrip, mengonfigurasi nilai default, atau mengganti variabel untuk sementara.

Selain variabel lingkungan AWS_CREDENTIAL_FILE, sebagian besar alat API yang disertakan dengan Antarmuka Baris ElastiCache Perintah mendukung variabel berikut:

  • EC2_REGION - AWS Wilayah yang akan digunakan.

  • AWS_ELASTICACHE_URL – URL yang digunakan untuk panggilan layanan. Tidak diperlukan untuk menentukan titik akhir regional yang berbeda jika EC2 _REGION ditentukan atau parameter --region dilewatkan.

Contoh berikut menunjukkan cara menyetel variabel lingkungan EC2 _REGION untuk mengonfigurasi wilayah yang digunakan oleh alat API:

Linux, OS X, atau Unix


$ export EC2_REGION=us-west-1

Windows


$ set EC2_REGION=us-west-1