**이 문서는 AWS CLI의 버전 1에만 해당합니다.**
곧 AWS CLI 버전 1에 대한 지원이 종료될 예정임을 알려드립니다. AWS CLI 버전 2로 마이그레이션하는 것이 좋습니다. 마이그레이션 날짜, 추가 세부 정보 및 방법에 대한 자세한 내용은 [공지 사항](https://aws.amazon.com/blogs/developer/cli-v1-maintenance-mode-announcement/)을 참조하세요. AWS CLI의 버전 2와 관련된 문서는 [버전 2 사용 설명서](https://docs.aws.amazon.com/cli/latest/userguide/)를 참조하세요.
# AWS CLI 설치, 업데이트 및 제거
이 주제에서는 AWS Command Line Interface(AWS CLI)의 원래 버전을 설치, 업데이트 및 제거하기 위한 링크를 제공합니다. AWS CLI 버전 1은 현재 지원되지만 AWS CLI 버전 2에 추가된 새로운 기능은 AWS CLI 버전 1에 추가되어 있지 않을 수 있습니다. 이러한 기능을 사용하려면 AWS CLI 버전 2를 설치해야 합니다. 버전 2 설치 방법에 대한 자세한 내용은 [AWS CLI 버전 2 설치](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html)를 참조하세요.
**Topics**
+ [Python 버전 요구 사항](#cli-chap-install-python)
+ [Amazon Linux](install-linux-al2017.md)
+ [Linux](install-linux.md)
+ [macOS](install-macos.md)
+ [Windows](install-windows.md)
+ [Virtualenv](install-virtualenv.md)
## Python 버전 요구 사항
AWS CLI 버전 1은 Python용 SDK를 사용하여 빌드되므로 호환되는 버전의 Python을 설치해야 합니다.
**Python 버전 지원 매트릭스**
| AWS CLI version | 지원되는 Python 버전 |
| --- | --- |
| 1.39.0\$1현재 | Python 3.9 이상 |
| 1.32.0\$11.38.38 | Python 3.8 이상 |
| 1.27.0\$11.31.x | Python 3.7 이상 |
| 1.20.0\$11.26.x | Python 3.6 이상 |
| 1.19.0\$11.19.x | Python 2.7 이상, Python 3.6 이상 |
| 1.17 \$1 1.18.x | Python 2.7 이상, Python 3.4 이상 |
| 1.0 \$1 1.16.x | Python 2.6 이상, Python 3.3 이상 |
AWS CLI의 최신 릴리스에 대한 자세한 내용은 GitHub에서 [AWS CLI 버전 2 변경 로그](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst)를 참조하세요.
# Amazon Linux에서 AWS CLI 버전 1 설치, 업데이트 및 제거
AWS CLI 버전 1은 Amazon Linux 및 Amazon Linux 2에 사전 설치되어 있습니다. 다음 명령을 사용하여 현재 설치된 버전을 점검하세요.
```
$ aws --version
aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
```
Amazon Linux 인스턴스를 언제 생성했는지에 따라 AWS CLI 버전 1은 다음 패키지 관리자 중 하나를 사용하여 사전 설치됩니다.
+ [pip](#install-amazon-linux-pip):
+ [yum](#install-amazon-linux-yum)
## 사전 조건
Python 3.8 이상이 설치되어 있어야 합니다. 설치 지침은 Python *초급 가이드*의 [Python 다운로드](https://wiki.python.org/moin/BeginnersGuide/Download) 페이지를 참조하세요.
**Python 버전 지원 매트릭스**
| AWS CLI version | 지원되는 Python 버전 |
| --- | --- |
| 1.39.0\$1현재 | Python 3.9 이상 |
| 1.32.0\$11.38.38 | Python 3.8 이상 |
| 1.27.0\$11.31.x | Python 3.7 이상 |
| 1.20.0\$11.26.x | Python 3.6 이상 |
| 1.19.0\$11.19.x | Python 2.7 이상, Python 3.6 이상 |
| 1.17 \$1 1.18.x | Python 2.7 이상, Python 3.4 이상 |
| 1.0 \$1 1.16.x | Python 2.6 이상, Python 3.3 이상 |
## pip를 사용한 설치, 업데이트 또는 제거
대부분의 Amazon Linux 인스턴스에서는 pip를 사용하여 AWS CLI 버전 1을 사전에 설치합니다.
### pip를 사용하여 AWS CLI 버전 1 설치 또는 업데이트
현재 사용자에 대해 AWS CLI 버전 1의 최신 버전을 설치하려면 다음 지침을 사용합니다.
1. Python 버전 3 이상이 설치되어 있으면 `pip3`을 사용하는 것이 좋습니다. `pip3 install`을 사용하여 최신 버전의 AWS CLI 버전 1을 설치하거나 업데이트합니다. [Python 가상 환경(venv)](https://docs.python.org/3/library/venv.html) 내에서 해당 명령을 실행할 경우, `--user` 옵션을 사용할 필요가 없습니다.
```
$ pip3 install --upgrade --user awscli
```
1. `aws`가 포함된 폴더가 `PATH` 변수의 일부인지 확인하세요.
1. 사용자 디렉터리에서 셸의 프로파일 스크립트를 찾습니다. 어떤 셸을 가지고 있는지 잘 모르는 경우 `echo $SHELL`을 실행합니다.
```
$ ls -a ~
. .. .bash_logout .bash_profile .bashrc Desktop Documents Downloads
```
+ **Bash** – `.bash_profile`, `.profile` 또는 `.bash_login`
+ **Zsh** – `.zshrc`
+ **Tcsh** – `.tcshrc`, `.cshrc` 또는 `.login`
1. 다음 예제와 유사한 프로필 스크립트 끝에 내보내기 명령을 추가합니다.
```
export PATH=$HOME/.local/bin:$PATH
```
이 명령은 경로(이 예제에서 `$HOME/.local/bin`)를 기존 `$PATH` 변수 앞에 삽입합니다.
1. 현재 세션에 프로필을 다시 로드하여 해당 변경 사항을 적용합니다.
```
$ source ~/.bash_profile
```
1. 새 버전을 실행 중인지 확인하려면 `aws --version` 명령을 사용합니다.
```
$ aws --version
aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
```
### pip를 사용하여 AWS CLI 버전 1 제거
AWS CLI를 제거해야 하는 경우 `pip uninstall`을 사용하세요.
```
$ pip3 uninstall awscli
```
## yum을 사용한 설치, 업데이트 또는 제거
대부분의 Amazon Linux 2 인스턴스에서는 yum을 사용하여 AWS CLI 버전 1을 사전에 설치합니다.
### Amazon Linux에서 yum을 사용하여 AWS CLI 버전 1 설치 또는 업데이트
Amazon Linux에서 사용할 수 있는 AWS CLI 버전 1의 최신 버전을 설치하려면 다음 명령을 실행합니다.
```
$ sudo yum install awscli
```
Amazon Linux에서 사용할 수 있는 AWS CLI 버전 1의 최신 버전으로 업데이트하려면 다음 명령을 실행합니다.
```
$ sudo yum update awscli
```
최신 버전을 실행 중인지 확인하려면 `aws --version` 명령을 사용합니다.
```
$ aws --version
aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
```
### yum을 사용하여 AWS CLI 버전 1 제거
AWS CLI를 제거하려면 `yum remove`을 사용합니다.
```
$ sudo yum remove awscli
```
## AWS CLI 설치 및 제거 오류 문제 해결
AWS CLI를 설치하거나 제거한 후 문제가 발생할 경우 [AWS CLI에 대한 오류 문제 해결](cli-chap-troubleshooting.md)에 나온 문제 해결 단계를 참조하세요. 가장 관련성이 높은 문제 해결 단계는 [명령을 찾을 수 없음 오류](cli-chap-troubleshooting.md#tshoot-install-not-found), ['`aws --version`' 명령이 설치한 버전과 다른 버전을 반환함](cli-chap-troubleshooting.md#tshoot-install-wrong-version) 및 [AWS CLI를 제거한 후 '`aws --version`' 명령이 버전을 반환함](cli-chap-troubleshooting.md#tshoot-uninstall-1) 섹션을 참조하세요.
# Linux에서 AWS CLI 버전 1 설치, 업데이트 및 제거
AWS Command Line Interface 패키지 관리자 또는 번들 설치 관리자를 사용하여 대부분의 Linux 배포에 AWS CLI(`pip`) 버전 1 및 해당 종속성을 설치할 수 있습니다.
`awscli` 패키지는 `apt` 및 `yum`과 같은 다른 패키지 관리자를 위한 리포지토리에서 사용할 수 있지만 AWS에서 생성, 관리 또는 지원하지 않습니다. 이 가이드에 설명된 대로 공식 AWS CLI 배포 지점을 통해서 만 AWS를 설치하는 것이 좋습니다.
**Topics**
+ [사전 조건](#install-linux-prereqs)
+ [번들 설치 관리자를 사용하여 Linux에서 AWS CLI 버전 1 설치 및 제거](#install-linux-bundled)
+ [pip를 사용하여 AWS CLI 버전 1 설치 및 제거](#install-linux-pip)
+ [Snapcraft를 사용하여 AWS CLI 버전 1 설치 및 제거](#install-linux-snap)
+ [AWS CLI 버전 1 실행 파일을 명령줄 경로에 추가](#install-linux-path)
+ [AWS CLI 설치 및 제거 오류 문제 해결](#install-linux-tshoot)
## 사전 조건
Python 3.8 이상이 설치되어 있어야 합니다. 설치 지침은 Python *초급 가이드*의 [Python 다운로드](https://wiki.python.org/moin/BeginnersGuide/Download) 페이지를 참조하세요.
**Python 버전 지원 매트릭스**
| AWS CLI version | 지원되는 Python 버전 |
| --- | --- |
| 1.39.0\$1현재 | Python 3.9 이상 |
| 1.32.0\$11.38.38 | Python 3.8 이상 |
| 1.27.0\$11.31.x | Python 3.7 이상 |
| 1.20.0\$11.26.x | Python 3.6 이상 |
| 1.19.0\$11.19.x | Python 2.7 이상, Python 3.6 이상 |
| 1.17 \$1 1.18.x | Python 2.7 이상, Python 3.4 이상 |
| 1.0 \$1 1.16.x | Python 2.6 이상, Python 3.3 이상 |
## 번들 설치 관리자를 사용하여 Linux에서 AWS CLI 버전 1 설치 및 제거
Linux 또는 macOS에서는 번들 설치 관리자를 사용하여 AWS CLI의 버전 1을 설치할 수 있습니다. 번들 설치 관리자에는 모든 종속 항목이 포함되고 오프라인으로 사용할 수 있습니다.
**참고**
번들 설치 관리자는 공백을 포함하는 경로에 설치하는 것을 지원하지 않습니다.
**Topics**
+ [`sudo`와 함께 제공되는 번들 설치 관리자를 사용하여 AWS CLI 버전 1 설치](#install-linux-bundled-sudo)
+ [`sudo`가 없는 번들 설치 관리자를 사용하여 AWS CLI 버전 1 설치](#install-linux-bundled-no-sudo)
+ [AWS CLI 버전 1 번들 설치 관리자 제거](#install-linux-bundled-uninstall)
### `sudo`와 함께 제공되는 번들 설치 관리자를 사용하여 AWS CLI 버전 1 설치
다음 단계를 수행하여 Linux 또는 macOS 빌드의 명령줄에서 AWS CLI 버전 1을 설치할 수 있습니다.
다음은 단일 명령 집합으로 실행하기 위해 잘라내어 붙여 넣을 수 있는 아래에 설명된 설치 명령의 요약입니다.
**최신 버전의 AWS CLI의 경우** 다음 명령 블록을 사용하세요.
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
unzip awscli-bundle.zip
sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
```
**특정 버전의 AWS CLI의 경우** 파일 이름에 하이픈과 버전 번호를 추가하세요. 이 예제의 경우 버전 *1.16.312*의 파일 이름은 `awscli-bundle-1.16.312.zip`이므로 명령은 다음과 같습니다.
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
unzip awscli-bundle.zip
sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
```
번들 설치 관리자를 사용하여 AWS CLI 버전 1을 설치하려면 명령줄에서 다음 단계를 수행합니다.
**번들 설치 관리자를 사용하여 AWS CLI 버전 1을 설치하려면**
1. 다음 방법 중 하나를 사용하여 AWS CLI 버전 1 번들 설치 관리자를 다운로드합니다.
+ `curl` 명령을 사용하여 다운로드합니다.
**최신 버전의 AWS CLI의 경우** 다음 명령 블록을 사용하세요.
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
```
**특정 버전의 AWS CLI의 경우** 파일 이름에 하이픈과 버전 번호를 추가하세요. 이 예제의 경우 버전 *1.16.312*의 파일 이름은 `awscli-bundle-1.16.312.zip`이므로 명령은 다음과 같습니다.
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
```
+ 직접 링크를 사용하여 다운로드합니다.
**의 최신 버전인 경우:AWS CLI **[https://s3.amazonaws.com/aws-cli/awscli-bundle.zip](https://s3.amazonaws.com/aws-cli/awscli-bundle.zip)
**특정 버전의 AWS CLI의 경우** 파일 이름에 하이픈과 버전 번호를 추가하세요. 이 예제의 경우 버전 *1.16.312*의 파일 이름은 `awscli-bundle-1.16.312.zip`이므로 URL은 다음과 같습니다. [https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip](https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip)
1. 패키지에서 파일을 추출합니다. 파일을 추출하기 위한 `unzip`이 없는 경우 Linux 배포의 기본 제공된 패키지 관리자를 사용하여 설치하세요.
```
$ unzip awscli-bundle.zip
```
1. 설치 프로그램을 실행합니다. 설치 관리자는 AWS CLI에서 `/usr/local/aws`를 설치하고 `aws` 디렉터리에 `/usr/local/bin`를 생성합니다. `-b` 옵션을 사용하여 symlink를 생성하면 사용자의 `$PATH` 변수에 설치 디렉터리를 지정할 필요가 없습니다. 이렇게 하면 모든 사용자가 임의 디렉터리에서 AWS CLI를 입력하여 `aws`를 호출할 수 있습니다.
```
$ sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
```
기본적으로 설치 스크립트는 시스템 기본 버전의 Python에서 실행됩니다. 대체 버전의 Python을 설치하고 이 버전을 사용하여 AWS CLI를 설치하려는 경우, 다음과 같이 Python 실행 파일에 대한 절대 경로로 해당 버전의 설치 스크립트를 실행합니다.
```
$ sudo /usr/local/bin/python3.7 awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
```
1. AWS CLI가 올바르게 설치되었는지 확인하세요.
```
$ aws --version
aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
```
오류가 발생한 경우 [AWS CLI에 대한 오류 문제 해결](cli-chap-troubleshooting.md) 단원을 참조하세요.
### `sudo`가 없는 번들 설치 관리자를 사용하여 AWS CLI 버전 1 설치
`sudo` 권한이 없거나 현재 사용자에 대해서만 AWS CLI를 설치할 경우, 위 명령의 수정된 버전을 사용할 수 있습니다. 처음 두 명령은 동일합니다.
**최신 버전의 AWS CLI의 경우** 다음 명령 블록을 사용하세요.
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
unzip awscli-bundle.zip
./awscli-bundle/install -b ~/bin/aws
```
**특정 버전의 AWS CLI의 경우** 파일 이름에 하이픈과 버전 번호를 추가하세요. 이 예제의 경우 버전 *1.16.312*의 파일 이름은 `awscli-bundle-1.16.312.zip`이므로 명령은 다음과 같습니다.
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
unzip awscli-bundle.zip
./awscli-bundle/install -b ~/bin/aws
```
**현재 사용자에 대해 AWS CLI 버전 1을 설치하려면**
1. 다음 방법 중 하나로 AWS CLI 버전 1 번들 설치 관리자를 다운로드합니다.
+ `curl` 명령을 사용하여 다운로드합니다.
**최신 버전의 AWS CLI의 경우** 다음 명령 블록을 사용하세요.
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
```
**특정 버전의 AWS CLI의 경우** 파일 이름에 하이픈과 버전 번호를 추가하세요. 이 예제의 경우 버전 *1.16.312*의 파일 이름은 `awscli-bundle-1.16.312.zip`이므로 명령은 다음과 같습니다.
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
```
+ 직접 링크를 사용하여 다운로드합니다.
**의 최신 버전인 경우:AWS CLI **[https://s3.amazonaws.com/aws-cli/awscli-bundle.zip](https://s3.amazonaws.com/aws-cli/awscli-bundle.zip)
**특정 버전의 AWS CLI의 경우** 파일 이름에 하이픈과 버전 번호를 추가하세요. 이 예제의 경우 버전 *1.16.312*의 파일 이름은 `awscli-bundle-1.16.312.zip`이므로 URL은 다음과 같습니다. [https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip](https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip)
1. `unzip`을 사용하여 패키지에서 파일을 추출합니다. `unzip`이 없는 경우 Linux 배포의 내장된 패키지 관리자를 사용하여 설치하세요.
```
$ unzip awscli-bundle.zip
```
1. 설치 프로그램을 실행합니다. 설치 관리자는 AWS CLI에서 `/usr/local/aws`를 설치하고 `aws` 디렉터리에 `/usr/local/bin`를 생성합니다. 이 명령은 `-b` 파라미터를 사용하여 설치 관리자가 `aws` symlink 파일을 저장할 디렉터리를 지정합니다. 지정된 폴더에 대한 쓰기 권한이 있어야 합니다.
```
$ ./awscli-bundle/install -b ~/bin/aws
```
이렇게 하여 AWS CLI를 기본값 위치(`~/.local/lib/aws`)에 설치하고 `~/bin/aws`에 심볼 링크(symlink)를 생성합니다. symlink가 작동하려면 `~/bin`이 `PATH` 환경 변수에 있어야 합니다.
```
$ echo $PATH | grep ~/bin // See if $PATH contains ~/bin (output will be empty if it doesn't)
$ export PATH=~/bin:$PATH // Add ~/bin to $PATH if necessary
```
1. AWS CLI 버전 1이 `PATH` 변수의 일부인지 확인합니다.
1. 사용자 폴더에서 셸의 프로파일 스크립트를 찾습니다. 어떤 셸을 가지고 있는지 잘 모르는 경우 `echo $SHELL`을 실행합니다.
```
$ ls -a ~
. .. .bash_logout .bash_profile .bashrc Desktop Documents Downloads
```
+ **Bash** – `.bash_profile`, `.profile` 또는 `.bash_login`
+ **Zsh** – `.zshrc`
+ **Tcsh** – `.tcshrc`, `.cshrc` 또는 `.login`
1. 다음 예제와 유사한 프로필 스크립트 끝에 내보내기 명령을 추가합니다.
```
export PATH=~/.local/bin:$PATH
```
이 명령은 경로(이 예제에서 `~/.local/bin`)를 기존 `PATH` 변수 앞에 삽입합니다.
1. 현재 세션에 프로필을 다시 로드하여 해당 변경 사항을 적용합니다.
```
$ source ~/.bash_profile
```
1. AWS CLI가 올바르게 설치되었는지 확인하세요.
```
$ aws --version
aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
```
오류가 발생한 경우 [AWS CLI에 대한 오류 문제 해결](cli-chap-troubleshooting.md) 단원을 참조하세요.
### AWS CLI 버전 1 번들 설치 관리자 제거
1. 번들 설치 관리자를 사용하여 AWS CLI을(를) 설치한 경우 다음 지침을 따릅니다. 번들 설치 관리자는 선택적 symlink를 제외하고 설치 디렉터리 외부에 아무 것도 넣지 않으므로, 설치 제거는 이 두 항목을 삭제하는 것만큼 간단합니다.
```
$ sudo rm -rf /usr/local/aws
$ sudo rm -rf /usr/local/bin/aws
```
1. **(선택 사항)** `.aws` 폴더에서 공유 AWS SDK 및 AWS CLI 설정 정보를 제거합니다.
**주의**
이러한 구성 및 자격 증명 설정은 모든 AWS SDK 및 AWS CLI에서 공유됩니다. 이 폴더를 제거하면 아직 시스템에 있는 AWS SDK에서 액세스할 수 없습니다.
`.aws` 폴더의 기본 위치는 플랫폼마다 다르며 기본적으로 폴더는 *\$1/.aws/*에 있습니다. 사용자에게 이 디렉터리에 대한 쓰기 권한이 있으면 `sudo`를 사용할 필요가 없습니다.
```
$ sudo rm -r ~/.aws/
```
## pip를 사용하여 AWS CLI 버전 1 설치 및 제거
**Topics**
+ [PIP 설치](#install-linux-pip-pip)
+ [pip를 사용하여 AWS CLI 버전 1 설치 및 업데이트](#install-linux-awscli)
+ [pip를 사용하여 AWS CLI 제거](#post-install-uninstall)
### PIP 설치
`pip`가 아직 설치되지 않은 경우 *Python Packaging Authority*에서 제공하는 스크립트를 사용하여 설치할 수 있습니다. `pip --version`을 실행하여 해당 버전의 Linux에 Python과 `pip`가 이미 포함되어 있는지 확인합니다. Python 버전 3 이상이 설치되어 있으면 `pip3` 명령을 사용하는 것이 좋습니다.
1. `curl` 명령을 사용하여 설치 스크립트를 다운로드합니다. 다음 명령은 `-O`(대문자 “O”) 파라미터를 사용하여 다운로드된 파일을 원격 호스트에서와 동일한 이름을 사용하여 현재 디렉터리에 저장하도록 지정합니다.
```
$ curl -O https://bootstrap.pypa.io/get-pip.py
```
1. `python` 또는 `python3` 명령으로 스크립트를 실행하여 `pip` 및 기타 필요한 지원 패키지의 최신 버전을 다운로드하여 설치합니다. `--user` 스위치를 포함하면 스크립트는 `pip`를 `~/.local/bin` 경로에 설치합니다.
```
$ python3 get-pip.py --user
```
1. `pip`가 포함된 디렉터리가 `PATH` 변수의 일부인지 확인합니다.
1. 사용자 폴더에서 셸의 프로파일 스크립트를 찾습니다. 어떤 셸을 가지고 있는지 잘 모르는 경우 `echo $SHELL`을 실행합니다.
```
$ ls -a ~
. .. .bash_logout .bash_profile .bashrc Desktop Documents Downloads
```
+ **Bash** – `.bash_profile`, `.profile` 또는 `.bash_login`
+ **Zsh** – `.zshrc`
+ **Tcsh** – `.tcshrc`, `.cshrc` 또는 `.login`
1. 다음 예제와 유사한 프로필 스크립트 끝에 내보내기 명령을 추가합니다.
```
export PATH=~/.local/bin:$PATH
```
이 명령은 경로(이 예제에서 `~/.local/bin`)를 기존 `PATH` 변수 앞에 삽입합니다.
1. 현재 세션에 프로필을 다시 로드하여 해당 변경 사항을 적용합니다.
```
$ source ~/.bash_profile
```
1. `pip` 또는 `pip3`이 제대로 설치되었는지 확인하려면 다음 명령을 실행합니다.
```
$ pip3 --version
pip 24.0 from ~/.local/lib/python3.7/site-packages (python 3.7)
```
### pip를 사용하여 AWS CLI 버전 1 설치 및 업데이트
1. `pip` 또는 `pip3` 명령을 사용하여 AWS CLI를 설치하거나 업데이트합니다. Python 버전 3 이상을 사용하는 경우에는 `pip3` 명령을 사용하는 것이 좋습니다. `--user` 스위치, `pip`는 AWS CLI를 `~/.local/bin`에 설치합니다.
**최신 버전의 AWS CLI의 경우** 다음 명령 블록을 사용하세요.
```
$ pip3 install awscli --upgrade --user
```
**특정 버전의 AWS CLI의 경우** 파일 이름에 두 개의 등호(`=`)와 버전 번호를 추가합니다. 이 예제의 경우 버전 *1.16.312*의 파일 이름은 *==1.16.312*이므로 명령은 다음과 같습니다.
```
$ pip3 install awscli==1.16.312 --upgrade --user
```
**참고**
터미널에 해당하는 인용 규칙을 사용합니다. `=` 문자를 사용하려는 경우 제대로 이스케이프 처리하기 위해 작은따옴표 또는 큰따옴표를 사용해야 할 수 있습니다. 다음 예제에서는 작은따옴표를 사용하여 이스케이프 처리합니다.
```
$ pip3 install 'awscli==1.16.312' --upgrade --user
```
1. AWS CLI가 올바르게 설치되었는지 확인하세요.
```
$ aws --version
aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
```
오류가 발생한 경우 [AWS CLI에 대한 오류 문제 해결](cli-chap-troubleshooting.md) 섹션을 참조하세요.
### pip를 사용하여 AWS CLI 제거
1. `pip`를 사용하여 AWS CLI 버전 1을 설치한 경우 제거할 때도 `pip`를 사용해야 합니다.
```
$ pip uninstall awscli
```
Python 2 또는 3 버전을 사용하는 경우 `pip2` 또는 `pip3` 명령을 사용해야 할 수 있습니다. `aws --version` 명령을 사용하여 설치된 AWS CLI 버전 1과 관련된 Python 버전을 확인합니다.
```
$ pip3 uninstall awscli
```
모든 파일을 제거하려면 명령 프롬프트 창이나 컴퓨터를 다시 시작해야 할 수 있습니다.
1. **(선택 사항)** `.aws` 폴더에서 공유 AWS SDK 및 AWS CLI 설정 정보를 제거합니다.
**주의**
이러한 구성 및 자격 증명 설정은 모든 AWS SDK 및 AWS CLI에서 공유됩니다. 이 폴더를 제거하면 아직 시스템에 있는 AWS SDK에서 액세스할 수 없습니다.
`.aws` 폴더의 기본 위치는 플랫폼마다 다르며 기본적으로 폴더는 *\$1/.aws/*에 있습니다. 사용자에게 이 디렉터리에 대한 쓰기 권한이 있으면 `sudo`를 사용할 필요가 없습니다.
```
$ sudo rm -r ~/.aws/
```
## Snapcraft를 사용하여 AWS CLI 버전 1 설치 및 제거
**Topics**
+ [스냅 설치](#install-linux-snap-install)
+ [스냅을 사용하여 AWS CLI 버전 1 설치 및 업데이트](#install-linux-snap-update)
+ [스냅을 사용하여 AWS CLI 제거](#install-linux-snap-uninstall)
### 스냅 설치
아직 `snap`이 설치되어 있지 않은 경우 **Canonical Snapcraft에서 제공하는 지침을 사용하여 설치할 수 있습니다. `snap version`을 실행하여 해당 버전의 Linux에 `snap`이 이미 포함되어 있는지 확인합니다.
1. 플랫폼에 Snapcraft를 설치합니다. Snapcraft 설치에 대한 자세한 내용은 **Snap 설명서의 [데몬 설치](https://snapcraft.io/docs/installing-snapd)를 참조하세요.
1. `PATH` 변수가 올바르게 업데이트되도록 시스템을 다시 시작합니다. 설치에 문제가 있는 경우 **Snap 설명서의 [일반적인 문제 해결](https://snapcraft.io/docs/fix-common-issues)에 나와 있는 단계를 따르세요.
1. `snap`이 올바르게 설치되었는지 확인하려면 다음 명령을 실행합니다.
```
$ snap version
```
### 스냅을 사용하여 AWS CLI 버전 1 설치 및 업데이트
1. AWS CLI 버전 1의 경우 다음 `snap install` 명령을 실행합니다.
```
$ snap install aws-cli --channel=v1/stable --classic
```
권한에 따라 명령에 `sudo`를 추가해야 할 수도 있습니다.
```
$ sudo snap install aws-cli --channel=v1/stable --classic
```
1. AWS CLI가 올바르게 설치되었는지 확인하세요.
```
$ aws --version
aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
```
오류가 발생한 경우 [AWS CLI에 대한 오류 문제 해결](cli-chap-troubleshooting.md) 섹션을 참조하세요.
### 스냅을 사용하여 AWS CLI 제거
1. `snap`를 사용하여 AWS CLI 버전 1을 설치한 경우 제거할 때도 `snap`를 사용해야 합니다.
```
$ snap remove aws-cli
```
모든 파일을 제거하려면 명령 프롬프트 창이나 컴퓨터를 다시 시작해야 할 수 있습니다.
1. **(선택 사항)** `.aws` 폴더에서 공유 AWS SDK 및 AWS CLI 설정 정보를 제거합니다.
**주의**
이러한 구성 및 자격 증명 설정은 모든 AWS SDK 및 AWS CLI에서 공유됩니다. 이 폴더를 제거하면 아직 시스템에 있는 AWS SDK에서 액세스할 수 없습니다.
`.aws` 폴더의 기본 위치는 플랫폼마다 다르며 기본적으로 폴더는 *\$1/.aws/*에 있습니다. 이 디렉터리에 대한 쓰기 권한이 있는 경우 `sudo`를 사용할 필요가 없습니다.
```
$ sudo rm -r ~/.aws/
```
## AWS CLI 버전 1 실행 파일을 명령줄 경로에 추가
`pip` 또는 `snap`를 사용하여 설치한 후 `aws` 실행 파일을 운영 체제의 `PATH` 환경 변수에 추가해야 할 수 있습니다.
다음 명령을 실행하여 `pip`가 AWS CLI를 설치한 폴더를 확인할 수 있습니다.
```
$ which aws
/home/username/.local/bin/aws
```
이를 `~/.local/bin/`이라고 할 수 있는데, Linux에서 `/home/username`은 `~`에 해당하기 때문입니다.
`--user` 스위치를 생략하여 사용자 모드에서 설치하지 않았다면 실행 파일이 Python의 `bin` 폴더에 있을 수 있습니다. Python 설치 위치를 모르는 경우, 다음 명령을 실행하세요.
```
$ which python
/usr/local/bin/python
```
실제 실행 파일이 아니라 symlink 경로가 출력될 수 있습니다. `ls -al`을 실행하여 어디를 가리키는지 확인합니다.
```
$ ls -al /usr/local/bin/python
/usr/local/bin/python -> ~/.local/Python/3.6/bin/python3.6
```
`pip`는 Python 애플리케이션이 있는 것과 동일한 폴더에 프로그램을 설치합니다. 이 폴더를 `PATH` 변수에 추가합니다.
**`PATH` 변수를 수정하려면**
1. 사용자 디렉터리에서 셸의 프로파일 스크립트를 찾습니다. 어떤 셸을 가지고 있는지 잘 모르는 경우 `echo $SHELL`을 실행합니다.
```
$ ls -a ~
. .. .bash_logout .bash_profile .bashrc Desktop Documents Downloads
```
+ **Bash** – `.bash_profile`, `.profile` 또는 `.bash_login`
+ **Zsh** – `.zshrc`
+ **Tcsh** – `.tcshrc`, `.cshrc` 또는 `.login`
1. 내보내기 명령을 프로필 스크립트에 추가하세요.
```
export PATH=~/.local/bin:$PATH
```
이 명령은 이 예제의 `~/.local/bin` 경로를 현재 `PATH` 변수에 추가합니다.
1. 현재 세션에 업데이트된 프로필을 로드합니다.
```
$ source ~/.bash_profile
```
## AWS CLI 설치 및 제거 오류 문제 해결
AWS CLI를 설치하거나 제거한 후 문제가 발생할 경우 [AWS CLI에 대한 오류 문제 해결](cli-chap-troubleshooting.md)에 나온 문제 해결 단계를 참조하세요. 가장 관련성이 높은 문제 해결 단계는 [명령을 찾을 수 없음 오류](cli-chap-troubleshooting.md#tshoot-install-not-found), ['`aws --version`' 명령이 설치한 버전과 다른 버전을 반환함](cli-chap-troubleshooting.md#tshoot-install-wrong-version) 및 [AWS CLI를 제거한 후 '`aws --version`' 명령이 버전을 반환함](cli-chap-troubleshooting.md#tshoot-uninstall-1) 섹션을 참조하세요.
# macOS에서 AWS CLI 버전 2 설치, 업데이트 및 제거
번들 설치 관리자 또는 AWS Command Line Interface를 사용하여 macOS에 AWS CLI(`pip`) 버전 1 및 해당 종속성을 설치할 수 있습니다.
**Topics**
+ [사전 조건](#install-macosos-prereq)
+ [번들 설치 관리자를 사용하여 macOS에서 AWS CLI 버전 1 설치, 업데이트 및 제거](#install-macosos-bundled)
+ [pip를 사용하여 AWS CLI 버전 1 설치, 업데이트 및 제거](#awscli-install-osx-pip)
+ [AWS CLI 설치 및 제거 오류 문제 해결](#awscli-install-osx-tshoot)
## 사전 조건
macOS에 AWS CLI 버전 1을 설치하려면 먼저 Python 3.8 이상이 설치되어 있어야 합니다. 설치 지침은 Python *초급 가이드*의 [Python 다운로드](https://wiki.python.org/moin/BeginnersGuide/Download) 페이지를 참조하세요.
**Python 버전 지원 매트릭스**
| AWS CLI version | 지원되는 Python 버전 |
| --- | --- |
| 1.39.0\$1현재 | Python 3.9 이상 |
| 1.32.0\$11.38.38 | Python 3.8 이상 |
| 1.27.0\$11.31.x | Python 3.7 이상 |
| 1.20.0\$11.26.x | Python 3.6 이상 |
| 1.19.0\$11.19.x | Python 2.7 이상, Python 3.6 이상 |
| 1.17 \$1 1.18.x | Python 2.7 이상, Python 3.4 이상 |
| 1.0 \$1 1.16.x | Python 2.6 이상, Python 3.3 이상 |
## 번들 설치 관리자를 사용하여 macOS에서 AWS CLI 버전 1 설치, 업데이트 및 제거
Linux 또는 macOS에서는 번들 설치 관리자를 사용하여 AWS Command Line Interface(AWS CLI)의 버전 1을 설치할 수 있습니다. 번들 설치 관리자에는 모든 종속 항목이 포함되고 오프라인으로 사용할 수 있습니다.
번들 설치 관리자는 공백을 포함하는 경로에 설치하는 것을 지원하지 않습니다.
**Topics**
+ [`sudo`와 함께 제공되는 번들 설치 관리자를 사용하여 AWS CLI 버전 1 설치](#install-macosos-bundled-sudo)
+ [`sudo`가 없는 번들 설치 관리자를 사용하여 AWS CLI 버전 1 설치](#install-macosos-bundled-no-sudo)
+ [AWS CLI 버전 1 번들 설치 관리자 제거](#install-macosos-bundled-uninstall)
### `sudo`와 함께 제공되는 번들 설치 관리자를 사용하여 AWS CLI 버전 1 설치
다음 단계를 수행하여 macOS 빌드의 명령줄에서 AWS CLI 버전 1을 설치할 수 있습니다.
다음에 단일 명령 집합으로 실행하기 위해 잘라내어 붙여 넣을 수 있는 설치 명령이 요약되어 있습니다.
**최신 버전의 AWS CLI의 경우** 다음 명령 블록을 사용하세요.
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
unzip awscli-bundle.zip
sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
```
**특정 버전의 AWS CLI의 경우** 파일 이름에 하이픈과 버전 번호를 추가하세요. 이 예제의 경우 버전 *1.16.312*의 파일 이름은 `awscli-bundle-1.16.312.zip`이므로 명령은 다음과 같습니다.
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
unzip awscli-bundle.zip
sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
```
**번들 설치 관리자를 사용하여 AWS CLI 버전 1을 설치하려면**
1. 다음 방법 중 하나로 AWS CLI 버전 1 번들 설치 관리자를 다운로드합니다.
+ `curl` 명령을 사용하여 다운로드합니다.
**최신 버전의 AWS CLI의 경우** 다음 명령 블록을 사용하세요.
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
```
**특정 버전의 AWS CLI의 경우** 파일 이름에 하이픈과 버전 번호를 추가하세요. 이 예제의 경우 버전 *1.16.312*의 파일 이름은 `awscli-bundle-1.16.312.zip`이므로 명령은 다음과 같습니다.
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
```
+ 직접 링크를 사용하여 다운로드합니다.
**의 최신 버전인 경우:AWS CLI **[https://s3.amazonaws.com/aws-cli/awscli-bundle.zip](https://s3.amazonaws.com/aws-cli/awscli-bundle.zip)
**특정 버전의 AWS CLI의 경우** 파일 이름에 하이픈과 버전 번호를 추가하세요. 이 예제의 경우 버전 *1.16.312*의 파일 이름은 `awscli-bundle-1.16.312.zip`이므로 URL은 다음과 같습니다. [https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip](https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip)
1. 패키지에서 파일을 추출(압축 해제)합니다. `unzip`이 없는 경우 macOs 배포의 기본 제공된 패키지 관리자를 사용하여 설치하세요.
```
$ unzip awscli-bundle.zip
```
1. 설치 프로그램을 실행합니다. 설치 관리자는 AWS CLI에서 `/usr/local/aws`를 설치하고 `aws` 폴더에 `/usr/local/bin` symlink를 생성합니다. `-b` 옵션을 사용하여 symlink를 생성하면 사용자의 `$PATH` 변수에 설치 폴더를 지정할 필요가 없습니다. 이렇게 하면 모든 사용자가 임의 디렉터리에서 AWS CLI를 입력하여 `aws`를 호출할 수 있습니다.
```
$ sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
```
기본적으로 설치 스크립트는 시스템 기본 버전의 Python에서 실행됩니다. 대체 버전의 Python을 설치하고 이를 사용하여 AWS CLI를 설치하려는 경우, 다음과 같이 Python 실행 파일에 대한 절대 경로로 해당 버전의 설치 스크립트를 실행합니다.
```
$ sudo /usr/local/bin/python3.7 awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
```
1. AWS CLI가 올바르게 설치되었는지 확인하세요.
```
$ aws --version
aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
```
오류가 발생한 경우 [AWS CLI에 대한 오류 문제 해결](cli-chap-troubleshooting.md) 단원을 참조하세요.
### `sudo`가 없는 번들 설치 관리자를 사용하여 AWS CLI 버전 1 설치
`sudo` 권한이 없거나 현재 사용자에 대해서만 AWS CLI를 설치할 경우, 위 명령의 수정된 버전을 사용할 수 있습니다. 처음 두 명령은 동일합니다.
**최신 버전의 AWS CLI의 경우** 다음 명령 블록을 사용하세요.
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
unzip awscli-bundle.zip
./awscli-bundle/install -b ~/bin/aws
```
**특정 버전의 AWS CLI의 경우** 파일 이름에 하이픈과 버전 번호를 추가하세요. 이 예제의 경우 버전 *1.16.312*의 파일 이름은 `awscli-bundle-1.16.312.zip`이므로 명령은 다음과 같습니다.
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
unzip awscli-bundle.zip
./awscli-bundle/install -b ~/bin/aws
```
**현재 사용자에 대해 AWS CLI 버전 1을 설치하는 방법**
1. 다음 방법 중 하나를 사용하여 AWS CLI 버전 1 번들 설치 관리자를 다운로드합니다.
+ `curl` 명령을 사용하여 다운로드합니다.
**최신 버전의 AWS CLI의 경우** 다음 명령 블록을 사용하세요.
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
```
**특정 버전의 AWS CLI의 경우** 파일 이름에 하이픈과 버전 번호를 추가하세요. 이 예제의 경우 버전 *1.16.312*의 파일 이름은 `awscli-bundle-1.16.312.zip`이므로 명령은 다음과 같습니다.
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
```
+ 직접 링크를 사용하여 다운로드합니다.
**의 최신 버전인 경우:AWS CLI **[https://s3.amazonaws.com/aws-cli/awscli-bundle.zip](https://s3.amazonaws.com/aws-cli/awscli-bundle.zip)
**특정 버전의 AWS CLI의 경우** 파일 이름에 하이픈과 버전 번호를 추가하세요. 이 예제의 경우 버전 *1.16.312*의 파일 이름은 `awscli-bundle-1.16.312.zip`이므로 URL은 다음과 같습니다. [https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip](https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip)
1. 패키지에서 파일을 추출합니다. `unzip`이 없는 경우 Linux 배포의 기본 제공된 패키지 관리자를 사용하여 설치하세요.
```
$ unzip awscli-bundle.zip
```
1. 설치 프로그램을 실행합니다. 설치 관리자는 AWS CLI에서 `/usr/local/aws`를 설치하고 `aws` 디렉터리에 `/usr/local/bin`를 생성합니다. 이 명령은 `-b` 파라미터를 사용하여 설치 관리자가 `aws` symlink 파일을 저장할 디렉터리를 지정합니다. 지정된 디렉터리에 대한 쓰기 권한이 있어야 합니다.
```
$ ./awscli-bundle/install -b ~/bin/aws
```
이렇게 하여 AWS CLI를 기본값 위치(`~/.local/lib/aws`)에 설치하고 `~/bin/aws`에 심볼 링크(symlink)를 생성합니다. symlink가 작동하려면 `~/bin`이 `$PATH` 환경 변수에 있어야 합니다.
```
$ echo $PATH | grep ~/bin // See if $PATH contains ~/bin (output will be empty if it doesn't)
$ export PATH=~/bin:$PATH // Add ~/bin to $PATH if necessary
```
1. AWS CLI 버전 1이 설치된 폴더가 `$PATH` 변수의 일부인지 확인합니다.
1. 사용자 폴더에서 셸의 프로파일 스크립트를 찾습니다. 어떤 셸을 가지고 있는지 잘 모르는 경우 `echo $SHELL`을 실행합니다.
```
$ ls -a ~
. .. .bash_logout .bash_profile .bashrc Desktop Documents Downloads
```
+ **Bash** – `.bash_profile`, `.profile` 또는 `.bash_login`
+ **Zsh** – `.zshrc`
+ **Tcsh** – `.tcshrc`, `.cshrc` 또는 `.login`
1. 다음 예제와 유사한 프로필 스크립트 끝에 내보내기 명령을 추가합니다.
```
export PATH=~/.local/bin:$PATH
```
이 명령은 경로(이 예제에서 `~/.local/bin`)를 기존 `PATH` 변수 앞에 삽입합니다.
1. 현재 세션에 프로필을 다시 로드하여 해당 변경 사항을 적용합니다.
```
$ source ~/.bash_profile
```
1. AWS CLI가 올바르게 설치되었는지 확인하세요.
```
$ aws --version
aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
```
오류가 발생한 경우 [AWS CLI에 대한 오류 문제 해결](cli-chap-troubleshooting.md) 단원을 참조하세요.
### AWS CLI 버전 1 번들 설치 관리자 제거
1. 번들 설치 관리자는 선택적 symlink를 제외한 모든 것을 설치 디렉터리 안에 넣으므로 제거하려면 두 항목을 삭제하면 됩니다.
```
$ sudo rm -rf /usr/local/aws
$ sudo rm /usr/local/bin/aws
```
1. **(선택 사항)** `.aws` 폴더에서 공유 AWS SDK 및 AWS CLI 설정 정보를 제거합니다.
**주의**
이러한 구성 및 자격 증명 설정은 모든 AWS SDK 및 AWS CLI에서 공유됩니다. 이 폴더를 제거하면 아직 시스템에 있는 AWS SDK에서 액세스할 수 없습니다.
`.aws` 폴더의 기본 위치는 플랫폼마다 다르며 기본적으로 폴더는 *\$1/.aws/*에 있습니다. 사용자에게 이 디렉터리에 대한 쓰기 권한이 있으면 `sudo`를 사용할 필요가 없습니다.
```
$ sudo rm ~/.aws/
```
## pip를 사용하여 AWS CLI 버전 1 설치, 업데이트 및 제거
`pip`를 직접 사용하여 AWS CLI를 설치할 수 있습니다.
**Topics**
+ [PIP 설치](#awscli-install-osx-pip-pip)
+ [pip를 사용하여 AWS CLI 설치 및 업데이트](#awscli-install-osx-pip-install)
+ [AWS CLI 버전 1 실행 파일을 macOS 명령줄 경로에 추가](#awscli-install-osx-path)
+ [pip를 사용하여 AWS CLI 제거](#awscli-install-osx-pip-uninstall)
### PIP 설치
`pip`가 아직 설치되지 않은 경우 *Python Packaging Authority*에서 제공하는 스크립트를 사용하여 설치할 수 있습니다. `pip --version`을 실행하여 해당 버전의 Linux에 Python과 `pip`가 이미 포함되어 있는지 확인합니다. Python 버전 3 이상이 설치되어 있으면 `pip3` 명령을 사용하는 것이 좋습니다.
1. `curl` 명령을 사용하여 설치 스크립트를 다운로드합니다. 다음 명령은 `-O`(대문자 “O”) 파라미터를 사용하여 다운로드된 파일을 원격 호스트에서와 동일한 이름을 사용하여 현재 폴더에 저장하도록 지정합니다.
```
$ curl -O https://bootstrap.pypa.io/get-pip.py
```
1. `python` 또는 `python3` 명령으로 스크립트를 실행하여 `pip` 및 기타 필요한 지원 패키지의 최신 버전을 다운로드하여 설치합니다. `--user` 스위치를 포함하면 스크립트는 `pip`를 `~/.local/bin` 경로에 설치합니다.
```
$ python3 get-pip.py --user
```
### pip를 사용하여 AWS CLI 설치 및 업데이트
1. `pip` 또는 `pip3` 명령을 사용하여 AWS CLI를 설치합니다. Python 버전 3 이상을 사용하는 경우에는 `pip3` 명령을 사용하는 것이 좋습니다.
**최신 버전의 AWS CLI의 경우** 다음 명령 블록을 사용하세요.
```
$ pip3 install awscli --upgrade --user
```
**특정 버전의 AWS CLI의 경우** 파일 이름에 두 개의 등호(`=`)와 버전 번호를 추가합니다. 이 예제의 경우 버전 *1.16.312*의 파일 이름은 *==1.16.312*이므로 명령은 다음과 같습니다.
```
$ pip3 install awscli==1.16.312 --upgrade --user
```
**참고**
터미널에 해당하는 인용 규칙을 사용합니다. `=` 문자를 사용하려는 경우 제대로 이스케이프 처리하기 위해 작은따옴표 또는 큰따옴표를 사용해야 할 수 있습니다. 다음 예제에서는 작은따옴표를 사용하여 이스케이프 처리합니다.
```
$ pip3 install 'awscli==1.16.312' --upgrade --user
```
1. AWS CLI이 올바르게 설치되었는지 확인합니다.
```
$ aws --version
aws-cli/1.40.41 Python/3.11.6 Darwin/23.3.0 botocore/1.18.6
```
프로그램을 찾을 수 없는 경우 [프로그램을 명령줄 경로에 추가](#awscli-install-osx-path)합니다.
### AWS CLI 버전 1 실행 파일을 macOS 명령줄 경로에 추가
`pip`를 사용하여 설치한 후 `aws` 프로그램을 운영 체제의 `PATH` 환경 변수에 추가해야 할 수 있습니다. 프로그램의 위치는 Python 설치 위치에 따라 달라집니다.
**Example AWS CLI 설치 위치 - Python 3.6 및 `pip`가 포함된 macOS(사용자 모드)**
```
~/Library/Python/3.7/bin
```
앞의 예제에 나온 버전을 현재 가지고 있는 Python 버전으로 대체합니다.
Python 설치 위치를 모르는 경우, `which python`을 실행하세요.
```
$ which python
/usr/local/bin/python
```
실제 프로그램이 아니라 symlink 경로가 출력될 수 있습니다. `ls -al`을 실행하여 어디를 가리키는지 확인합니다.
```
$ ls -al /usr/local/bin/python
~/Library/Python/3.7/bin/python3.7
```
`pip`는 Python 애플리케이션이 있는 것과 동일한 폴더에 프로그램을 설치합니다. 이 폴더를 `PATH` 변수에 추가합니다.
**`PATH` 변수를 수정하려면**
1. 사용자 디렉터리에서 셸의 프로파일 스크립트를 찾습니다. 어떤 셸을 가지고 있는지 잘 모르는 경우 `echo $SHELL`을 실행합니다.
```
$ ls -a ~
. .. .bash_logout .bash_profile .bashrc Desktop Documents Downloads
```
+ **Bash** – `.bash_profile`, `.profile` 또는 `.bash_login`
+ **Zsh** – `.zshrc`
+ **Tcsh** – `.tcshrc`, `.cshrc` 또는 `.login`
1. 내보내기 명령을 프로필 스크립트에 추가하세요.
```
export PATH=~/.local/bin:$PATH
```
이 명령은 이 예제의 `~/.local/bin` 경로를 현재 `PATH` 변수에 추가합니다.
1. 현재 세션에 업데이트된 프로필을 로드합니다.
```
$ source ~/.bash_profile
```
### pip를 사용하여 AWS CLI 제거
1. `pip`를 사용하여 AWS CLI 버전 1을 설치한 경우 제거할 때도 `pip`를 사용해야 합니다.
```
$ pip uninstall awscli
```
Python 2 또는 3 버전을 사용하는 경우 `pip2` 또는 `pip3` 명령을 사용해야 할 수 있습니다. `aws --version` 명령을 사용하여 설치된 AWS CLI 버전 1과 관련된 Python 버전을 확인합니다.
```
$ pip3 uninstall awscli
```
모든 파일을 제거하려면 명령 프롬프트 창이나 컴퓨터를 다시 시작해야 할 수 있습니다.
1. **(선택 사항)** `.aws` 폴더에서 공유 AWS SDK 및 AWS CLI 설정 정보를 제거합니다.
**주의**
이러한 구성 및 자격 증명 설정은 모든 AWS SDK 및 AWS CLI에서 공유됩니다. 이 폴더를 제거하면 아직 시스템에 있는 AWS SDK에서 액세스할 수 없습니다.
`.aws` 폴더의 기본 위치는 플랫폼마다 다르며 기본적으로 폴더는 *\$1/.aws/*에 있습니다. 사용자에게 이 디렉터리에 대한 쓰기 권한이 있으면 `sudo`를 사용할 필요가 없습니다.
```
$ sudo rm -rf ~/.aws/
```
## AWS CLI 설치 및 제거 오류 문제 해결
AWS CLI를 설치하거나 제거한 후 문제가 발생할 경우 [AWS CLI에 대한 오류 문제 해결](cli-chap-troubleshooting.md)에 나온 문제 해결 단계를 참조하세요. 가장 관련성이 높은 문제 해결 단계는 [명령을 찾을 수 없음 오류](cli-chap-troubleshooting.md#tshoot-install-not-found), ['`aws --version`' 명령이 설치한 버전과 다른 버전을 반환함](cli-chap-troubleshooting.md#tshoot-install-wrong-version) 및 [AWS CLI를 제거한 후 '`aws --version`' 명령이 버전을 반환함](cli-chap-troubleshooting.md#tshoot-uninstall-1) 섹션을 참조하세요.
# Windows에서 AWS CLI 버전 1 설치, 업데이트 및 제거
독립 실행형 설치 관리자(권장) 또는 Python용 패키지 관리자인 AWS Command Line Interface를 사용하여 Windows에 AWS CLI(`pip`) 버전 1을 설치할 수 있습니다.
명령을 입력할 때 프롬프트 기호(`C:\>`)를 포함시키지 마세요. 이 기호는 입력하는 명령을 AWS CLI에서 반환되는 출력과 구별하기 위해 프로그램 목록에 포함되어 있습니다. 이 설명서의 나머지 부분에서는 명령이 Windows에 특정한 경우를 제외하고 일반 프롬프트 기호(`$`)를 사용합니다.
**Topics**
+ [MSI 설치 관리자를 사용하여 AWS CLI 버전 1 설치, 업데이트 및 제거](#msi-on-windows)
+ [Windows에서 Python 및 pip를 사용하여 AWS CLI 버전 1 설치, 업데이트 및 제거](#awscli-install-windows-pip)
+ [AWS CLI 버전 1 실행 파일을 명령줄 경로에 추가](#awscli-install-windows-path)
+ [AWS CLI 설치 및 제거 오류 문제 해결](#awscli-install-windows-tshoot)
## MSI 설치 관리자를 사용하여 AWS CLI 버전 1 설치, 업데이트 및 제거
AWS CLI 버전 1은 Windows XP 이상에서 지원됩니다. Windows 사용자의 경우 MSI 설치 패키지는 다른 사전 요구 사항을 설치하지 않고 AWS CLI 버전 1을 설치할 수 있는 친숙하고 편리한 방법을 제공합니다.
### MSI 설치 관리자를 사용하여 AWS CLI 버전 1 설치 및 업데이트
최신 버전이 언제 릴리스되었는지를 알아보려면 GitHub의 [릴리스](https://github.com/aws/aws-cli/releases) 페이지를 확인하세요. 업데이트가 릴리스되면 설치 프로세스를 반복하여 최신 버전의 AWS CLI 버전 1을 가져와야 합니다.
1. 적절한 MSI 설치 관리자를 다운로드합니다.
+ Windows용 AWS CLI MSI 설치 관리자(64비트): [https://s3.amazonaws.com/aws-cli/AWSCLI64PY3.msi](https://s3.amazonaws.com/aws-cli/AWSCLI64PY3.msi)
+ Windows용 AWS CLI MSI 설치 관리자(32비트): [https://s3.amazonaws.com/aws-cli/AWSCLI32PY3.msi](https://s3.amazonaws.com/aws-cli/AWSCLI32PY3.msi)
+ Windows용 AWS CLI 통합 설정 파일: [ https://s3.amazonaws.com/aws-cli/AWSCLISetup.exe](https://s3.amazonaws.com/aws-cli/AWSCLISetup.exe)(32비트 및 64비트 MSI 설치 관리자가 모두 포함되어 있으며 자동으로 올바른 버전 설치)
1. 다운로드한 MSI 설치 관리자 또는 설정 파일을 실행하세요.
1. 화면에 표시되는 지시 사항을 따릅니다. 기본적으로 AWS CLI 버전 1은 `C:\Program Files\Amazon\AWSCLI`(64비트 버전) 또는 `C:\Program Files (x86)\Amazon\AWSCLI`(32비트 버전)에 설치됩니다.
1. 설치를 확인하려면 명령 프롬프트에서 `aws --version` 명령을 사용합니다. **시작** 메뉴를 열고 `cmd`를 검색하여 명령 프롬프트를 시작할 수 있습니다.
```
C:\> aws --version
aws-cli/1.40.41 Python/3.11.6 Windows/10 botocore/1.18.6
```
Windows에서 프로그램을 찾을 수 없는 경우 명령 프롬프트를 닫고 다시 열어 경로를 새로 고치거나 [설치 디렉터리를 PATH](#awscli-install-windows-path) 환경 변수에 수동으로 추가해야 할 수 있습니다.
### AWS CLI 버전 1 제거
다음 제거 지침을 사용하려면 MSI 설치 관리자 또는 설정 파일과 함께 AWS CLI 버전 1을 설치해야 합니다.
1. 다음 중 하나를 수행하여 **Programs and Features(프로그램 및 기능)**를 엽니다.
+ **Control Panel(제어판)**을 연 후 **Programs and Features(프로그램 및 기능)**를 선택합니다.
+ 명령 프롬프트를 열고 다음 명령을 입력합니다.
```
C:\> appwiz.cpl
```
1. **AWS Command Line Interface**라는 항목을 선택한 다음, **Uninstall(제거)**을 선택하여 제거 프로그램을 시작합니다.
1. AWS CLI를 제거할 것인지 확인합니다.
1. **(선택 사항)** `.aws` 폴더에서 공유 AWS SDK 및 AWS CLI 설정 정보를 제거합니다.
**주의**
이러한 구성 및 자격 증명 설정은 모든 AWS SDK 및 AWS CLI에서 공유됩니다. 이 폴더를 제거하면 아직 시스템에 있는 AWS SDK에서 액세스할 수 없습니다.
`.aws` 폴더의 기본 위치는 플랫폼마다 다르며 기본적으로 폴더는 *%UserProfile%\$1.aws*에 있습니다.
```
$ rmdir %UserProfile%\.aws
```
## Windows에서 Python 및 pip를 사용하여 AWS CLI 버전 1 설치, 업데이트 및 제거
Python Software Foundation은 `pip`가 포함된 Windows용 설치 관리자를 제공합니다.
### 사전 조건
Python 3.8 이상이 설치되어 있어야 합니다. 설치 지침은 Python *초급 가이드*의 [Python 다운로드](https://wiki.python.org/moin/BeginnersGuide/Download) 페이지를 참조하세요.
### pip를 사용하여 AWS CLI 버전 1 설치 및 업데이트
1. AWS CLI 버전 1을 설치하려면 `pip3` 명령(Python 버전 3 이상을 사용하는 경우) 또는 `pip` 명령을 사용합니다.
**최신 버전의 AWS CLI의 경우** 다음 명령 블록을 사용하세요.
```
C:\> pip3 install awscli --upgrade --user
```
**특정 버전의 AWS CLI의 경우** 파일 이름에 `<` 기호와 버전 번호를 추가합니다. 이 예제의 경우 버전 *1.16.312*의 파일 이름은 *<1.16.312*이므로 명령은 다음과 같습니다.
```
C:\> pip3 install awscli<1.16.312 --upgrade --user
```
1. AWS CLI 버전 1이 올바르게 설치되었는지 확인합니다. 응답이 없으면 [AWS CLI 버전 1 실행 파일을 명령줄 경로에 추가](#awscli-install-windows-path) 섹션을 참조하세요.
```
C:\> aws --version
aws-cli/1.40.41 Python/3.11.6 Windows/10 botocore/1.18.6
```
### pip를 사용하여 AWS CLI 버전 1 제거
1. `pip`를 사용하여 AWS CLI 버전 1을 설치한 경우 제거할 때도 `pip`를 사용해야 합니다.
```
C:\> pip uninstall awscli
```
Python 2 또는 3 버전을 사용하는 경우 `pip2` 또는 `pip3` 명령을 사용해야 할 수 있습니다. `aws --version` 명령을 사용하여 설치된 AWS CLI 버전 1과 관련된 Python 버전을 확인합니다.
```
C:\> pip3 uninstall awscli
```
모든 파일을 제거하려면 명령 프롬프트 창이나 컴퓨터를 다시 시작해야 할 수 있습니다.
1. **(선택 사항)** `.aws` 폴더에서 공유 AWS SDK 및 AWS CLI 설정 정보를 제거합니다.
**주의**
이러한 구성 및 자격 증명 설정은 모든 AWS SDK 및 AWS CLI에서 공유됩니다. 이 폴더를 제거하면 아직 시스템에 있는 AWS SDK에서 액세스할 수 없습니다.
`.aws` 폴더의 기본 위치는 플랫폼마다 다르며 기본적으로 폴더는 *%UserProfile%\$1.aws*에 있습니다.
```
$ rmdir %UserProfile%\.aws
```
## AWS CLI 버전 1 실행 파일을 명령줄 경로에 추가
`pip`를 사용하여 AWS CLI 버전 1을 설치한 후 `aws` 프로그램을 운영 체제의 `PATH` 환경 변수에 추가합니다. 이는 MSI 설치를 통해 자동으로 수행됩니다. 그러나 설치 후 `aws` 명령이 실행되지 않으면 수동으로 설정해야 할 수 있습니다.
1. `where` 명령을 사용하여 `aws` 파일 위치를 찾습니다. 기본적으로 `where` 명령은 시스템의 `PATH`에서 지정된 프로그램이 있는 위치를 표시합니다.
```
C:\> where aws
```
표시되는 경로는 플랫폼과 AWS CLI를 설치하는 데 사용한 방법에 따라 달라집니다. 버전 번호를 포함한 폴더 이름은 달라질 수 있습니다. 이러한 예제는 Python 버전 3.7 사용을 반영합니다. 필요에 따라 버전을 사용 중인 버전 번호로 바꿉니다. 일반적인 경로는 다음과 같습니다.
+ **Python 3 및 `pip3`** – `C:\Program Files\Python37\Scripts\`
+ **Python 3 및 `pip3` --이전 버전의 Windows에서 사용자 옵션** - `%USERPROFILE%\AppData\Local\Programs\Python\Python37\Scripts`
+ **Python 3 및 `pip3` -- Windows 10에서의 사용자 옵션** - `%USERPROFILE%\AppData\Roaming\Python\Python37\Scripts`
+ **MSI 설치 관리자(64비트)** - `C:\Program Files\Amazon\AWSCLI\bin`
+ **MSI 설치 관리자(32비트)** - `C:\Program Files (x86)\Amazon\AWSCLI\bin`
파일 경로가 반환되는지 여부에 따라 다음 단계를 사용합니다.
------
#### [ A file path is returned ]
```
C:\> where aws
C:\Program Files\Amazon\AWSCLI\bin\aws.exe
```
다음 명령을 실행하여 `aws` 프로그램이 어디에 설치되어 있는지 확인할 수 있습니다.
```
C:\> where c:\ aws
C:\Program Files\Python37\Scripts\aws
```
------
#### [ A file path is NOT returned ]
`where` 명령이 다음 오류를 반환하면 프로그램이 시스템 `PATH`에 없으며 이름을 입력하여 실행할 수 없습니다.
```
C:\> where c:\ aws
INFO: Could not find files for the given pattern(s).
```
이 경우 `where` 파라미터와 함께 `/R path` 명령을 실행하여 모든 폴더를 검색하도록 한 후 경로를 수동으로 추가합니다. 명령줄 또는 파일 탐색기를 사용하여 프로그램이 컴퓨터에서 어디에 설치되어 있는지 검색합니다.
```
C:\> where /R c:\ aws
c:\Program Files\Amazon\AWSCLI\bin\aws.exe
c:\Program Files\Amazon\AWSCLI\bincompat\aws.cmd
c:\Program Files\Amazon\AWSCLI\runtime\Scripts\aws
c:\Program Files\Amazon\AWSCLI\runtime\Scripts\aws.cmd
...
```
------
1. Windows 키를 누르고 **environment variables**를 입력하세요.
1. **Edit environment variables for your account(계정에 대한 환경 변수 편집)**를 선택합니다.
1. **경로**를 선택한 다음 **편집**을 선택합니다.
1. 찾은 경로를 **변수 값** 필드에 추가합니다(예: ***C:\$1Program Files\$1Amazon\$1AWSCLI\$1bin\$1aws.exe***).
1. **확인**을 두 번 선택하여 새로운 설정을 적용합니다.
1. 실행 중인 명령 프롬프트를 모두 닫았다가 명령 프롬프트 창을 다시 엽니다.
## AWS CLI 설치 및 제거 오류 문제 해결
AWS CLI를 설치하거나 제거한 후 문제가 발생할 경우 [AWS CLI에 대한 오류 문제 해결](cli-chap-troubleshooting.md)에 나온 문제 해결 단계를 참조하세요. 가장 관련성이 높은 문제 해결 단계는 [명령을 찾을 수 없음 오류](cli-chap-troubleshooting.md#tshoot-install-not-found), ['`aws --version`' 명령이 설치한 버전과 다른 버전을 반환함](cli-chap-troubleshooting.md#tshoot-install-wrong-version) 및 [AWS CLI를 제거한 후 '`aws --version`' 명령이 버전을 반환함](cli-chap-troubleshooting.md#tshoot-uninstall-1) 섹션을 참조하세요.
# 가상 환경에서 AWS CLI 버전 1 설치 및 업데이트
가상 환경에 `pip`(AWS Command Line Interface) 버전 1을 설치하면 요구 사항 버전이 다른 AWS CLI 패키지와 충돌하는 것을 방지할 수 있습니다.
**Topics**
+ [사전 조건](#install-virtualenv-prereqs)
+ [가상 환경에서 AWS CLI 버전 1 설치 및 업데이트](#install-virtualenv-install)
+ [AWS CLI 설치 및 제거 오류 문제 해결](#install-virtualenv-tshoot)
## 사전 조건
+ Python 3.8 이상 설치 지침은 Python *초급 가이드*의 [Python 다운로드](https://wiki.python.org/moin/BeginnersGuide/Download) 페이지를 참조하세요.
**Python 버전 지원 매트릭스**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/cli/v1/userguide/install-virtualenv.html)
+ `pip` 또는 `pip3`이 설치되어 있습니다.
## 가상 환경에서 AWS CLI 버전 1 설치 및 업데이트
1. `virtualenv`를 사용하여 `pip`를 설치합니다.
```
$ pip install --user virtualenv
```
1. 가상 환경을 생성하고 이름을 지정합니다.
```
$ virtualenv ~/cli-ve
```
또는 `-p` 옵션을 사용하여 기본 버전 이외의 Python 버전을 지정할 수 있습니다.
```
$ virtualenv -p /usr/bin/python37 ~/cli-ve
```
1. 새 가상 환경을 활성화합니다.
**Linux 또는 macOS**
```
$ source ~/cli-ve/bin/activate
```
**Windows**
```
$ %USERPROFILE%\cli-ve\Scripts\activate
```
프롬프트가 변경되어 가상 환경이 활성임을 보여줍니다.
```
(cli-ve)~$
```
1. 가상 환경에서 AWS CLI 버전 1을 설치하거나 업데이트합니다.
```
(cli-ve)~$ pip install --upgrade awscli
```
1. AWS CLI 버전 1이 올바르게 설치되었는지 확인합니다.
```
$ aws --version
aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
```
1. `deactivate` 명령을 사용하여 가상 환경을 종료할 수 있습니다. 새 세션을 시작할 때마다 환경을 다시 활성화해야 합니다.
## AWS CLI 설치 및 제거 오류 문제 해결
AWS CLI를 설치하거나 제거한 후 문제가 발생할 경우 [AWS CLI에 대한 오류 문제 해결](cli-chap-troubleshooting.md)에 나온 문제 해결 단계를 참조하세요. 가장 관련성이 높은 문제 해결 단계는 [명령을 찾을 수 없음 오류](cli-chap-troubleshooting.md#tshoot-install-not-found), ['`aws --version`' 명령이 설치한 버전과 다른 버전을 반환함](cli-chap-troubleshooting.md#tshoot-install-wrong-version) 및 [AWS CLI를 제거한 후 '`aws --version`' 명령이 버전을 반환함](cli-chap-troubleshooting.md#tshoot-uninstall-1) 섹션을 참조하세요.