ecs-cli configure profile - Amazon Elastic Container Service

ecs-cli configure profile

~/.ecs/credentials 파일에 저장되어 있는 이름인 지정된 Amazon ECS 프로필에 AWS 자격 증명을 구성합니다. 프로필을 여러 개 생성한 경우, ecs-cli configure profile default 명령으로 기본 사용 프로필을 변경할 수 있습니다. 자세한 내용은 ecs-cli configure profile default 섹션을 참조하세요.

중요

설명된 일부 기능은 최신 Amazon ECS CLI 버전에만 제공될 수도 있습니다. 최신 버전을 가져오는 방법에 대한 자세한 내용은 Amazon ECS CLI 설치 섹션을 참조하세요.

AWS 자격 증명은 여러 가지 방법으로 구성할 수 있습니다.

  • AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEYAWS_SESSION_TOKEN 환경 변수를 설정할 수 있습니다. ecs-cli configure profile을 실행하면 해당 변수의 값이 Amazon ECS CLI 구성 파일에 저장됩니다.

  • --access-key, --secret-key--session-token 옵션을 사용하여 명령줄에서 직접 자격 증명을 전달할 수 있습니다.

  • 새 프로필 이름에 --profile-name 플래그를 붙일 수 있습니다. 프로필 이름을 입력하지 않으면 default가 프로필 이름이 됩니다.

  • 첫 번째로 구성한 프로필이 기본 프로필로 설정됩니다. --ecs-profile 플래그를 사용하지 않는 한 Amazon ECS CLI는 이 프로필에 지정된 자격 증명을 사용합니다.

여러 프로필로 작업

프로필을 여러 개 사용하는 경우, 다음에 주의해야 합니다.

  • 프로필을 여러 개 구성할 수 있지만 항상 한 개는 기본 프로필이어야 합니다. 자격 증명이 필요한 Amazon ECS CLI 명령을 실행할 때 이 프로필을 사용하게 됩니다.

  • 첫 번째로 생성된 프로필이 기본 프로필로 설정됩니다.

  • 기본 프로필을 변경하려면 ecs-cli configure profile default 명령을 사용합니다. 자세한 내용은 ecs-cli configure profile default 섹션을 참조하세요.

  • 기본이 아닌 프로필은 --ecs-profile 플래그를 사용하여 명령에 참조할 수 있습니다.

구문

ecs-cli configure profile --profile-name profile_name --access-key aws_access_key_id --secret-key aws_secret_access_key [--session-token token] [--help]

옵션

이름

설명

--profile-name profile_name

이 ECS 프로필의 이름을 지정합니다. --ecs-profile 플래그를 사용하면 이 이름을 명령에 참조하게 됩니다. 이 옵션을 생략하면 이름은 default로 설정됩니다.

유형: String

필수 항목 여부: 예

--access-key aws_access_key_id

사용할 AWS 액세스 키를 지정합니다. ecs-cli configure profile일 실행될 때 AWS_ACCESS_KEY_ID 환경 변수가 설정되어 있는 경우 AWS 액세스 키 ID가 해당 환경 변수의 값으로 설정됩니다.

유형: String

필수 항목 여부: 예

--secret-key aws_secret_access_key

사용할 AWS 보안 키를 지정합니다. ecs-cli configure profile일 실행될 때 AWS_SECRET_ACCESS_KEY 환경 변수가 설정되어 있는 경우 AWS 보안 액세스 키가 해당 환경 변수의 값으로 설정됩니다.

유형: String

필수 항목 여부: 예

--session-token token

사용할 AWS 세션 토큰을 지정합니다. ecs-cli configure profile일 실행될 때 AWS_SESSION_TOKEN 환경 변수가 설정되어 있는 경우 AWS 세션 토큰이 해당 환경 변수의 값으로 설정됩니다. 임시 액세스에서 세션 토큰을 사용하는 방법에 대한 자세한 내용은 임시 보안 자격 증명 요청을 참조하세요.

유형: 문자열

필수 항목 여부: 아니요

--help, -h

지정한 명령에 대한 도움말을 표시합니다.

필수 항목 여부: 아니요

예제

예 1

이 예제에서는 default라는 이름의 프로필을 생성하고 여러 가지 액세스 키와 함께 사용하도록 Amazon ECS CLI를 구성합니다.

ecs-cli configure profile --profile-name default --access-key $AWS_ACCESS_KEY_ID --secret-key $AWS_SECRET_ACCESS_KEY

출력:

INFO[0000] Saved ECS CLI profile configuration default.

예 2

이 예제에서는 default라는 이름의 프로필을 생성하고 여러 가지 액세스 키 및 AWS 세션 토큰과 함께 사용하도록 Amazon ECS CLI를 구성합니다.

ecs-cli configure profile --profile-name default --access-key $AWS_ACCESS_KEY_ID --secret-key $AWS_SECRET_ACCESS_KEY --session-token $AWS_SESSION_TOKEN

출력:

INFO[0000] Saved ECS CLI profile configuration default.