Reference
이 섹션의 본 주제에서는 Amazon ElastiCache API 및 AWS CLI의 ElastiCache 섹션 관련 작업을 다룹니다. 또한 여기에는 일반적인 오류 메시지와 서비스 알림에 관한 설명이 포함되어 있습니다.
ElastiCache 명령줄 인터페이스 설정
이 섹션은 명령줄 도구 실행을 위한 필수 조건, 명령줄 도구를 구할 수 있는 위치, 도구 및 환경 설정 방법을 설명하고 도구 사용의 몇몇 일반적인 예를 포함하고 있습니다.
ElastiCache용 AWS CLI로 이동하는 경우에만 이 주제의 지침을 따르십시오.
중요
Amazon ElastiCache 명령줄 인터페이스(CLI)는 API 버전 2014-09-30 이후의 ElastiCache 개선 사항을 지원하지 않습니다. 명령줄에서 최신 ElastiCache 기능을 사용하려면 AWS 명령줄 인터페이스
사전 조건
이 문서는 Linux/UNIX 또는 Windows 환경에서 작업할 수 있음을 가정합니다. 또한 Amazon ElastiCache 명령줄 도구는 UNIX 기반 환경인 Mac OS X에서도 작동하지만 이 설명서에는 특정 Mac OS X 지침이 포함되어 있지 않습니다.
하나의 규칙으로서 모든 명령줄 텍스트 앞에 일반적인 PROMPT> $ C:\>
Java 런타임 환경
이 설명서에 사용된 명령줄 도구를 실행하려면 Java 버전 5 이상이 있어야 합니다. JRE 또는 JDK 설치가 허용됩니다. Linux/UNIX 및 Windows를 포함한 다양한 플랫폼 용도의 JRE를 살펴보고 다운로드하려면 Java SE Downloads
Java Home 변수 설정
명령줄 도구는 Java 런타임을 찾기 위해 환경 변수(JAVA_HOME)를 사용합니다. 이 환경 변수는 실행 가능한 java(Linux 및 UNIX) 또는 java.exe(Windows) 실행 파일을 차례로 포함하고 있는 bin이라는 하위 디렉토리가 있는 디렉토리의 전체 경로로 설정되어야 합니다.
Java Home 변수를 설정하려면
-
Java Home 변수를 설정합니다.
-
Linux 및 UNIX에서 다음 명령을 입력합니다.
$export JAVA_HOME=<PATH> -
Windows에서 다음 명령을 입력합니다.
C:\>set JAVA_HOME=<PATH>
-
-
$JAVA_HOME/bin/java -version을 실행하고 출력을 확인하여 경로 설정을 확인합니다.-
Linux/UNIX에서 다음과 유사한 출력을 확인할 수 있습니다.
$$JAVA_HOME/bin/java -versionjava 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) -
Windows에서 다음과 유사한 출력을 확인할 수 있습니다.
C:\>%JAVA_HOME%\bin\java -versionjava 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)
-
명령줄 도구 얻기
명령줄 도구는 ElastiCache 개발자 도구 웹 사이트
도구 설정
명령줄 도구는 지원 라이브러리를 찾기 위해 환경 변수(AWS_ELASTICACHE_HOME)를 사용합니다. 이 환경 변수를 먼저 설정해야 도구를 사용할 수 있습니다. 환경 변수를 명령줄 도구의 압축을 푼 디렉토리 경로로 설정합니다. 이 디렉토리 이름은 ElastiCacheCli-A.B.nnnn(A, B 및 n은 버전/릴리스 번호)이며 bin 및 lib라는 하위 디렉토리를 포함하고 있습니다.
AWS_ELASTICACHE_HOME 환경 변수를 설정하려면
-
명령줄 창을 열고 다음 명령 중 하나를 입력하여 AWS_ELASTICACHE_HOME 환경 변수를 설정합니다.
-
Linux 및 UNIX에서 다음 명령을 입력합니다.
$ export &AWS;_ELASTICACHE_HOME=<path-to-tools> -
Windows에서 다음 명령을 입력합니다.
C:\> set &AWS;_ELASTICACHE_HOME=<path-to-tools>
-
도구 사용을 좀 더 쉽게 하려면 도구의 BIN 디렉토리를 시스템 경로에 추가하는 것이 좋습니다. 이 설명서의 나머지 부분은 BIN 디렉토리가 시스템 경로에 있음을 가정합니다.
도구의 BIN 디렉토리를 시스템 경로에 추가하려면
-
다음 명령을 입력하여 도구의 BIN 디렉토리를 시스템 경로에 추가합니다.
-
Linux 및 UNIX에서 다음 명령을 입력합니다.
$ export PATH=$PATH:$&AWS;_ELASTICACHE_HOME/bin -
Windows에서 다음 명령을 입력합니다.
C:\> set PATH=%PATH%;%&AWS;_ELASTICACHE_HOME%\bin
-
참고
Windows 환경 변수는 명령 창을 닫으면 재설정됩니다. 이러한 변수를 영구적으로 설정할 수 있습니다. 자세한 내용은 현재 Windows 버전의 설명서를 참조하세요.
참고
경로에 공백이 포함된 경우 다음 예에서처럼 큰따옴표로 묶어야 합니다.
"C:\Program Files\Java"
도구에 대한 자격 증명 제공
명령줄 도구에는 AWS 계정과 함께 제공되는 AWS 액세스 키 및 보안 액세스 키가 필요합니다. 명령줄을 사용하거나 로컬 시스템에 위치하는 자격 증명 파일에서 이러한 키를 얻을 수 있습니다.
배포 파일에는 개별 정보를 사용하여 수정해야 하는 템플릿 파일인 ${AWS_ELASTICACHE_HOME}/credential-file-path.template가 포함되어 있습니다. 다음은 템플릿 파일의 콘텐츠입니다.
AWSAccessKeyId=<Write your AWS access ID> AWSSecretKey=<Write your AWS secret key>
중요
UNIX에서는 자격 증명 파일의 소유자로 권한을 제한합니다.
$ chmod 600 <the file created above>
자격 증명 파일 설정을 사용하여 AWS_CREDENTIAL_FILE 환경 변수를 설정해야 ElastiCache 도구가 정보를 찾을 수 있습니다.
AWS_CREDENTIAL_FILE 환경 변수를 설정하려면
-
환경 변수를 설정합니다.
-
Linux 및 UNIX에서는 다음 명령을 사용하여 변수를 업데이트합니다.
$ export &AWS;_CREDENTIAL_FILE=<the file created above> -
Windows에서는 다음 명령을 사용하여 변수를 설정합니다.
C:\> set &AWS;_CREDENTIAL_FILE=<the file created above>
-
-
설정한 것이 제대로 작동하는지 확인하려면 다음 명령을 실행합니다.
elasticache --help모든 ElastiCache 명령에 대한 사용법 페이지가 표시됩니다.
환경 변수
환경 변수는 스크립팅, 기본값 구성 또는 기본값 임시 재정의에 유용할 수 있습니다.
AWS_CREDENTIAL_FILE 환경 변수뿐만 아니라 ElastiCache 명령줄 인터페이스와 함께 포함된 API 도구는 대부분 다음 변수를 지원하지 않습니다.
-
EC2_REGION - 사용할 AWS 리전입니다.
-
AWS_ELASTICACHE_URL - 서비스 호출에 사용할 URL입니다. EC2_REGION이 지정되어 있거나 --region 파라미터가 전달되는 경우 다른 리전 엔드포인트를 지정할 필요가 없습니다.
다음 예제에서는 EC2_REGION이라는 환경 변수를 설정하여 API 도구에서 사용하는 리전을 구성하는 방법을 보여줍니다.
Linux, OS X 또는 Unix
$ export EC2_REGION=us-west-1
Windows
$ set EC2_REGION=us-west-1
