AWS CLI 설치 및 설정하기

이번 포스트에서는 macOS 에 AWS CLI 를 설치하고 기본 설정을 하는 방법을 안내한다.

AWS CLI 를 사용하기 전, AWS IAM 자격 증명을 통한 액세스 키 정보가 필요하니, 사전 설정을 하지 않으신 독자는 링크를 통해 관련 정보를 얻기 바란다.

 

aws-cli 설치하기

본격적인 세팅을 하기 전에, 다음 명령어를 통해 aws-cli 를 손쉽게 설치할 수 있다.

brew install awscli

 

aws config 파일 작성하기

AWS IAM 자격 증명의 액세스 키 정보를 알고 있다면, .aws 디렉토리 내에 config 파일을 생성한다.

nvim ~/.aws/config

이후 해당 파일에 다음 포맷으로 액세스 키 아이디 (Access Key ID) 와 시크릿 엑세스 키 (Secret Access Key) 를 작성한다.

[default]
aws_access_key_id={ACCESS_KEY_ID}
aws_secret_access_key={SECRET_ACCESS_KEY}

이후 저장하고, 다음 명령어를 통해 현재 설정된 aws 계정 정보를 확인할 수 있다.

aws sts get-caller-identity

 

기본 region 설정하기

자격 증명 외에도 aws-cli 에는 여러 가지 정보를 설정할 수 있다. 이번에는 기본 region 을 설정해 보자. aws 는 소수의 글로벌 서비스를 제외하고 나면, 대부분은 지역 단위의 region 기반 서비스이다. 따라서 기본 region 을 설정하지 않았다면, 명령어 수행 시 --region 옵션을 매번 실행해야 한다.

 

예를 들어, ec2의 key pair 목록을 가져와 보여주는 명령을 실행했을 때, ec2는 region 기반 서비스이므로 region 을 명시해야 한다는 경고가 발생하며 명령어가 실행되지 않는 것을 볼 수 있다.

 

이 경우, 우선 다음과 같이 명령어 뒤에 --region 옵션을 붙여 지정할 수는 있다.

(key pair 보안을 위해 실제 출력값은 포스트에 담지 않았다.)

 

이제 기본 리전 설정을 통해 --region 옵션을 생략할 수 있도록 설정해 보자.

이전에 설정했던 config 파일의 default 섹션에 다음과 같이 region 관련 설정을 추가한다.

region=ap-northeast-2

 

region 을 설정하고 다시 위 명령을 수행하면, 정상적으로 수행되는 것을 확인할 수 있다.

(key pair 보안을 위해 실제 출력값은 포스트에 담지 않았다.)

 

AWS CLI 결과 출력 형식 설정

다음으로는 AWS CLI 결과의 출력 형식을 설정해야 한다.  기본적으로 JSON 형태로 결과를 출력하게 된다. 하지만, AWS CLI 는 여러 출력 형식을 지원한다.

• JSON
• TEXT
• TABLE
• YAML
• YAML STREAM

 

우선 설정하기 전에, 옵션을 통해 다른 출력 옵션으로 결과값을 출력해 보면 다음과 같이 YAML 과 TABLE 형태로 출력된다.

aws ec2 describe-key-pairs --output yaml

aws ec2 describe-key-pairs --output table

 

이번에는 AWS Config 파일에 output 형태를 yaml 로 지정해 보자.

output=yaml

 

다시 명령어를 실행하면, 결과가 yaml 로 출력될 것이다.

(key pair 보안을 위해 실제 출력값은 포스트에 담지 않았다.)

 

이외에도, 하나의 config 파일에 여러 사용자를 정의하여 명령어마다 다른 사용자의 자격 증명을 사용할 수도 있다.

해당 내용은 공식 문서를 참조하면 된다.

https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-profiles.html

Named profiles for the AWS CLI - AWS Command Line Interface