aws cli
1.0.0
이 패키지는 Amazon Web Services에 대한 통합 명령줄 인터페이스를 제공합니다.
다음으로 이동:
이 README는 AWS CLI 버전 1에 대한 것입니다. AWS CLI 버전 2에 대한 정보를 찾고 있다면 v2 브랜치를 방문하세요.
aws-cli 패키지는 Python 버전에서 작동합니다.
2022년 5월 30일에 Python 3.6에 대한 지원이 종료되었습니다. 이는 2021년 12월 23일에 발생한 Python Software Foundation의 런타임 지원 종료에 따른 것입니다.
2023년 12월 13일에 Python 3.7에 대한 지원이 종료되었습니다. 이는 2023년 6월 27일에 발생한 Python Software Foundation의 런타임 지원 종료에 따른 것입니다. 자세한 내용은 이 블로그 게시물을 참조하세요.
주목!
모든 고객은 Amazon Web Services 보안 게시판 웹 사이트를 정기적으로 모니터링하여 aws-cli와 관련된 중요한 보안 게시판을 확인하는 것이 좋습니다 .
AWS CLI 버전 1은 2013년 9월 2일에 정식 출시되었으며 현재 가용성 수명 주기의 전체 지원 단계에 있습니다.
SDK 메이저 버전과 기본 종속성에 대한 유지 관리 및 지원에 대한 자세한 내용은 AWS SDK 및 도구 공유 구성 및 자격 증명 참조 가이드 의 유지 관리 정책 섹션을 참조하세요.
AWS CLI 및 해당 종속성을 설치하려면 pip 및 setuptools 에서 제공하는 다양한 패키징 기능을 사용합니다. 원활한 설치를 위해서는 다음을 사용하는 것이 좋습니다.
pip : 9.0.2 이상setuptools : 36.2.0 이상 AWS CLI를 설치하는 가장 안전한 방법은 virtualenv 에서 pip를 사용하는 것입니다.
$ python -m pip 설치 awscli
또는 virtualenv 에 설치하지 않는 경우 전역적으로 설치하려면 다음을 수행하세요.
$ sudo python -m pip 설치 awscli
또는 사용자의 경우:
$ python -m pip install --user awscli
aws-cli 패키지가 설치되어 있고 최신 버전으로 업그레이드하려는 경우 다음을 실행할 수 있습니다.
$ python -m pip install --upgrade awscli
그러면 aws-cli 패키지와 모든 종속성이 설치됩니다.
메모
macOS에서 El Capitan의 distutils 와 함께 제공된 six 버전과 관련된 오류가 표시되면 --ignore-installed 옵션을 사용하세요.
$ sudo python -m pip install awscli --ignore-installed six
Linux 및 Mac OS에서는 번들 설치 프로그램을 사용하여 AWS CLI를 설치할 수 있습니다. AWS CLI는 MSI 설치 프로그램을 통해 Windows에 설치할 수도 있습니다.
AWS CLI의 develop 브랜치를 실행하려면 기여 가이드의 개발 버전 섹션을 참조하세요.
자세한 내용은 AWS CLI 사용 설명서의 설치 섹션을 참조하십시오.
AWS CLI를 사용하기 전에 AWS 자격 증명을 구성해야 합니다. 여러 가지 방법으로 이 작업을 수행할 수 있습니다.
시작하는 가장 빠른 방법은 aws configure 명령을 실행하는 것입니다.
$ AWS 구성 AWS 액세스 키 ID: MYACCESSKEY AWS 비밀 액세스 키: MYSECRETKEY 기본 지역 이름 [us-west-2]: us-west-2 기본 출력 형식 [없음]: json
환경 변수를 사용하려면 다음을 수행합니다.
$ 내보내기 AWS_ACCESS_KEY_ID=<액세스_키> $ 내보내기 AWS_SECRET_ACCESS_KEY=<비밀_키>
공유 자격 증명 파일을 사용하려면 다음과 같은 INI 형식의 파일을 만듭니다.
[기본] aws_access_key_id=MYACCESSKEY aws_secret_access_key=MYSECRETKEY [테스트] aws_access_key_id=MYACCESSKEY aws_secret_access_key=MYSECRETKEY
~/.aws/credentials (또는 Windows의 경우 %UserProfile%.aws/credentials )에 배치합니다. 위에서 지정한 위치가 아닌 다른 위치에 공유 자격 증명 파일을 배치하려면 aws-cli에 해당 파일을 찾을 수 있는 위치를 알려주어야 합니다. 적절한 환경 변수를 설정하여 이를 수행합니다.
$ 내보내기 AWS_SHARED_CREDENTIALS_FILE=/path/to/shared_credentials_file
구성 파일을 사용하려면 다음과 같이 INI 형식의 파일을 만듭니다.
[기본] aws_access_key_id=<기본 액세스 키> aws_secret_access_key=<기본 비밀 키> # 이 프로필에 대한 기본 지역을 정의하려면 선택 사항입니다. 지역=us-west-1 [프로필 테스트] aws_access_key_id=<액세스 키 테스트> aws_secret_access_key=<비밀 키 테스트> 지역=us-west-2
~/.aws/config (또는 Windows의 경우 %UserProfile%.awsconfig )에 배치합니다. 위에서 지정한 위치가 아닌 다른 위치에 구성 파일을 배치하려면 AWS CLI에 해당 파일을 찾을 수 있는 위치를 알려주어야 합니다. 적절한 환경 변수를 설정하여 이를 수행합니다.
$ 내보내기 AWS_CONFIG_FILE=/path/to/config_file
보시다시피 공유 자격 증명 파일과 구성 파일 모두에 여러 profiles 정의할 수 있습니다. 그런 다음 --profile 옵션을 사용하여 사용할 프로필을 지정할 수 있습니다. 프로필을 지정하지 않으면 default 프로필이 사용됩니다.
구성 파일에서 기본 프로필을 제외하고 프로필 그룹의 각 구성 섹션 앞에 profile 붙여야 합니다 . 예를 들어 "testing"이라는 프로필이 있는 경우 섹션 헤더는 [profile testing] 입니다.
EC2 인스턴스에서 AWS CLI를 사용하는 경우 자격 증명의 마지막 옵션을 적극 권장합니다. IAM 역할은 인스턴스에 자격 증명을 자동으로 설치하는 좋은 방법입니다. IAM 역할을 사용하는 경우 AWS CLI가 자동으로 이를 찾아 사용합니다.
자격 증명 외에도 환경 변수, 구성 파일 항목 또는 둘 다를 사용하여 여러 다른 변수를 구성할 수 있습니다. 자세한 내용은 AWS 도구 및 SDK 공유 구성 및 자격 증명 참조 가이드를 참조하십시오.
구성 옵션에 대한 자세한 내용은 AWS CLI 구성 변수 항목을 참조하십시오. aws help config-vars 실행하여 AWS CLI에서도 이 주제에 액세스할 수 있습니다.
AWS CLI 명령의 구조는 다음과 같습니다.
$ aws <명령> <하위 명령> [옵션 및 매개변수]
예를 들어 S3 버킷을 나열하려면 명령은 다음과 같습니다.
$ aws s3 ls
도움말 문서를 보려면 다음 중 하나를 사용하십시오.
$ AWS 도움말 $ aws <명령> 도움말 $ aws <명령> <하위 명령> 도움말
AWS CLI 버전을 얻으려면:
$ aws --버전
디버깅 출력을 켜려면:
$ aws --debug <명령> <하위 명령>
AWS CLI 사용 설명서의 AWS CLI 사용 장에 대한 자세한 내용을 읽을 수 있습니다.
aws-cli 패키지에는 Unix 계열 시스템을 위한 명령 완성 기능이 포함되어 있습니다. 이 기능은 자동으로 설치되지 않으므로 수동으로 구성해야 합니다. 자세히 알아보려면 AWS CLI 명령 완성 주제를 읽어보세요.
우리 팀과 상호 작용하는 가장 좋은 방법은 GitHub를 이용하는 것입니다. 문제를 열고 지침, 버그 보고서 또는 기능 요청을 위한 템플릿 중 하나를 선택할 수 있습니다.
aws-cli 태그가 있는 Stack Overflow 커뮤니티나 CLI용 AWS 토론 포럼에서 도움을 받을 수 있습니다. AWS Support에 대한 지원 계획이 있는 경우 새 지원 사례를 생성할 수도 있습니다.
다른 문제를 열기 전에 유사한 문제가 열려 있는지 확인하세요.
AWS CLI는 AWS 서비스 API를 구현합니다. 서비스 또는 제한 사항과 관련된 일반적인 문제의 경우 Amazon Web Services 토론 포럼이 도움이 될 수 있습니다.
