AWS CLI에 사용되는 명명된 프로파일

명명된 프로파일은 AWS CLI 명령에 적용할 수 있는 설정 및 자격 증명 모음입니다. 명령을 실행할 프로파일을 지정하면 설정 및 자격 증명이 해당 명령을 실행하는 데 사용됩니다. 여러 명명된 프로파일을 config 및 credentials 파일에 저장할 수 있습니다.

명시적으로 참조된 프로파일이 없는 경우에 사용되는 default 프로파일을 하나 지정할 수 있습니다. 그 밖의 프로파일에는 개별 명령을 위한 명령줄에서 파라미터로 지정할 수 있는 이름이 있습니다. 또는 해당 세션에서 실행되는 명령에 대한 기본 프로파일을 재정의하는 AWS_PROFILE 환경 변수에 프로파일을 지정할 수 있습니다.

명명된 프로파일 생성

aws configure를 --profile 옵션과 함께 사용하거나 config 및 credentials 파일에 항목을 수동으로 추가하여 추가 프로파일을 구성할 수 있습니다. config 및 credentials 파일에 대한 자세한 내용은 구성 및 자격 증명 파일 설정 단원을 참조하세요.

자격 증명 프로파일

다음은 두 개의 프로파일이 있는 credentials 파일을 보여주는 예입니다. 첫 번째 [기본값]은 프로파일이 없는 AWS CLI 명령을 실행할 때 사용됩니다. 두 번째는 --profile user1 파라미터와 함께 AWS CLI 명령을 실행할 때 사용됩니다.

credentials 파일은 명명된 프로파일에 대해 AWS CLI config 파일과 다른 명명 형식을 사용합니다. profile 파일에서 항목을 생성할 때에는 credentials 단어를 사용하지 마십시오.

~/.aws/credentials(Linux 및 Mac) 또는 %USERPROFILE%\.aws\credentials(Windows)

[default]
aws_access_key_id=AKIAIOSFODNN7EXAMPLE
aws_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

[user1]
aws_access_key_id=AKIAI44QH8DHBEXAMPLE
aws_secret_access_key=je7MtGbClwBF/2Zp9Utk/h3yCo8nvbEXAMPLEKEY

구성 프로파일

각 프로파일은 다른 자격 증명을 지정하며(다른 IAM 사용자의 자격 증명), 다른 AWS 리전 및 출력 형식도 지정할 수 있습니다. config 파일에서 프로파일 이름을 지정할 때 접두사 ‘profile’을 포함시킵니다.

다음 예제에서는 default 및 user1 프로파일에 대한 리전 및 출력 정보를 지정합니다.

~/.aws/config(Linux 및 Mac) 또는 %USERPROFILE%\.aws\config(Windows)

[default]
region=us-west-2
output=json

[profile user1]
region=us-east-1
output=text

명명된 프로파일 사용

명명된 프로필을 사용하려면 --profile profile-name 옵션을 명령에 추가합니다. 다음은 이전 예제 파일의 user1 프로파일에 정의된 자격 증명 및 설정을 사용하여 Amazon EC2 인스턴스를 모두 나열하는 예입니다.

$ aws ec2 describe-instances --profile user1

여러 명령에 대해 명명된 프로파일을 사용하려는 경우, 명령줄에서 AWS_PROFILE 환경 변수를 설정하면 모든 명령에서 매번 프로파일을 지정하는 것을 피할 수 있습니다.

Linux 또는 macOS

$ export AWS_PROFILE=user1

Windows

C:\> setx AWS_PROFILE user1

환경 변수를 설정하는 데 set을 사용하면 사용되는 값이 변경되어 현재 명령 프롬프트 세션이 종료될 때까지 또는 변수를 다른 값으로 설정할 때까지 유지됩니다.

환경 변수를 설정하는 데 setx를 사용하면 명령 실행 후 생성한 모든 명령 셸의 값이 변경됩니다. 명령을 실행하는 시점에 이미 실행 중인 다른 명령 셸에는 영향이 미치지 않습니다. 이러한 변경 영향을 확인하려면 명령 셸을 닫고 다시 시작합니다.

환경 변수를 설정하면 기본 프로파일이 변경되어 셸 세션이 종료될 때까지 또는 변수를 다른 값으로 설정할 때까지 유지됩니다. 셸의 스타트업 스크립트에 이들 값을 배치하면 환경 변수가 향후 세션에서도 영구적으로 적용되도록 할 수 있습니다. 자세한 내용은 환경 변수를 사용하여 AWS CLI 구성 단원을 참조하세요.

참고

개별 명령에서 --profile로 프로파일을 지정하면 해당 명령에 대해서만 환경 변수에 지정된 설정을 재정의합니다.