Riferimento - Amazon ElastiCache
Configura il AWS CLI per ElastiCache

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Riferimento

Gli argomenti di questa sezione riguardano l'utilizzo dell' ElastiCache API Amazon e la ElastiCache sezione di AWS CLI. Sono inclusi anche i messaggi di errore e le notifiche di servizio più frequenti.

Configurazione dell'interfaccia ElastiCache a riga di comando

Questa sezione descrive i prerequisiti per ottenere gli strumenti a riga di comando, dove trovarli, come impostare gli strumenti e il loro ambiente; include una serie di esempi comuni di utilizzo degli strumenti.

Segui le istruzioni riportate in questo argomento solo se intendi utilizzare AWS CLI la ElastiCache forchetta.

Importante

L'Amazon ElastiCache Command Line Interface (CLI) non supporta alcun ElastiCache miglioramento dopo la versione dell'API 2014-09-30. Per utilizzare ElastiCache funzionalità più recenti dalla riga di comando, usa l'interfaccia a riga di comando.AWS

Prerequisiti

In questo documento si presuppone che si possa lavorare in un ambiente Linux/UNIX o Windows. Gli strumenti a riga di ElastiCache comando di Amazon funzionano anche su Mac OS X, che è un ambiente basato su Unix; tuttavia, in questa guida non sono incluse istruzioni specifiche per Mac OS X.

Per convenzione, tutti i testi a riga di comando hanno un prefisso costituito da un prompt generico PROMPT> della riga di comando. Il prompt della riga di comando sul tuo computer potrebbe essere diverso. Utilizziamo anche $ per indicare un comando specifico Linux/UNIX e C:\> per un comando specifico Windows. L'output di esempio derivante dal comando viene visualizzato subito dopo, senza alcun prefisso.

Java Runtime Environment

Per l'esecuzione, gli strumenti a riga di comando utilizzati in questa guida richiedono almeno la versione 5 di Java. È accettabile l'installazione di JRE o di JDK. Per visualizzare e scaricare JREs per una vasta gamma di piattaforme, tra cui Linux/UNIX e Windows, consulta Java SE Downloads.

Impostazione della variabile Java Home

Gli strumenti a riga di comando dipendono da una variabile di ambiente (JAVA_HOME) per l'individuazione di Java Runtime. Tale variabile deve essere impostata sul percorso completo della directory contenente una sottodirectory denominata bin, che a sua volta contiene il file eseguibile java (su Linux e UNIX) o il file eseguibile java.exe (su Windows).

Per impostare la variabile Java Home

  1. Impostare la variabile Java Home.

    • In Linux e UNIX, immettere il seguente comando:

      $ export JAVA_HOME=<PATH>

    • In Windows immetti il seguente comando:

      C:\> set JAVA_HOME=<PATH>

  2. Confermare l'impostazione del percorso eseguendo il comando $JAVA_HOME/bin/java -version e verificando l'output.

    • Su Linux/UNIX, l'aspetto dell'output sarà simile al seguente:

      
$ $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)

    • Su Windows, l'aspetto dell'output sarà simile al seguente:

      
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)

Ottenere gli strumenti a riga di comando

Gli strumenti a riga di comando sono disponibili come file .zip sul Sito Web degli strumenti per sviluppatori di ElastiCache . Questi strumenti sono scritti in Java e includono script di shell per Windows 2000/ e Mac OSX. XP/Vista/Windows 7, Linux/UNIX Il file .zip è autonomo e non occorre installarlo; basta scaricarlo e decomprimerlo in una directory sul computer locale.

Configurazione degli strumenti

Gli strumenti a riga di comando dipendono da una variabile di ambiente (AWS_ELASTICACHE_HOME) per l'individuazione delle librerie di support. Prima di poter utilizzare gli strumenti, occorre impostare questa variabile. Impostala sul percorso della directory in cui hai decompresso gli strumenti a riga di comando. Questa directory è denominata ElastiCacheCli -A.B.nnnn (A, B e n sono numeri di versione/release) e contiene le sottodirectory denominate bin e lib.

Per AWS impostare la variabile di ambiente _ELASTICACHE_HOME

  • Apri una finestra della riga di comando e inserisci uno dei seguenti comandi per impostare la variabile di ambiente _ELASTICACHE_HOME. AWS

    • In Linux e UNIX, immettere il seguente comando:

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

    • In Windows immetti il seguente comando:

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

Per semplificare l'utilizzo degli strumenti, consigliamo di aggiungere la directory BIN degli strumenti al PATH di sistema. Il resto della guida presuppone che la directory BIN si trovi nel percorso di sistema.

Per aggiungere la directory BIN degli strumenti al percorso di sistema

  • Immettere i seguenti comandi per aggiungere la directory BIN degli strumenti al PATH di sistema.

    • In Linux e UNIX, immettere il seguente comando:

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

    • In Windows immetti il seguente comando:

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

Quando si chiude la finestra dei comandi, le variabili di ambiente Windows vengono resettate. Si possono anche impostare in modo definitivo. Per ulteriori informazioni, consulta la documentazione relativa alla versione di Windows in uso.

Nota

I percorsi che contengono uno spazio devono essere racchiusi tra virgolette, ad esempio:

"C:\Program Files\Java"

Fornire le credenziali per gli strumenti

Gli strumenti da riga di comando richiedono la chiave di AWS accesso e la chiave di accesso segreta fornite con l'account. AWS Puoi ottenerle tramite la riga di comando o da un file di credenziali presente nel sistema locale.

La distribuzione include un file modello $ {AWS_ELASTICACHE_HOME}/credential-file-path.template che devi modificare con le tue informazioni. Di seguito i contenuti del file di modello:


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

In UNIX, limita le autorizzazioni al proprietario del file delle credenziali:

$ chmod 600 <the file created above>

Con la configurazione del file di credenziali, dovrai impostare la variabile di ambiente AWS_CREDENTIAL_FILE in modo che gli strumenti possano trovare le tue informazioni. ElastiCache

Per impostare la variabile di ambiente _CREDENTIAL_FILE AWS

  1. Imposta la variabile di ambiente :

    • Su Linux e UNIX, impostare la variabile di ambiente utilizzando il comando seguente:

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

    • Su Windows, impostare la variabile di ambiente utilizzando il comando seguente:

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

  2. Verificare il corretto funzionamento della configurazione tramite il comando seguente:

    elasticache --help

    Dovrebbe comparire la pagina di utilizzo di tutti i comandi ElastiCache.

Variabili di ambiente

Le variabili di ambiente possono essere utili per lo script e la configurazione delle impostazioni predefinite o per la loro provvisoria sostituzione.

Oltre alla variabile di ambiente AWS_CREDENTIAL_FILE, la maggior parte degli strumenti API inclusi nell'interfaccia a riga di comando supporta le seguenti variabili: ElastiCache

  • EC2_REGION — La regione da utilizzare. AWS

  • AWS_ELASTICACHE_URL— L'URL da utilizzare per la chiamata di servizio. Non è necessario specificare un endpoint regionale diverso se viene specificato EC2 _REGION o viene passato il parametro --region.

Gli esempi seguenti mostrano come impostare la variabile di ambiente EC2 _REGION per configurare la regione utilizzata dagli strumenti API:

Linux, OS X o Unix


$ export EC2_REGION=us-west-1

Windows


$ set EC2_REGION=us-west-1