**이 문서는 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 버전 1 설치 및 업데이트
<a name="install-virtualenv"></a>

가상 환경에 `pip`(AWS Command Line Interface) 버전 1을 설치하면 요구 사항 버전이 다른 AWS CLI 패키지와 충돌하는 것을 방지할 수 있습니다.

**Topics**
+ [사전 조건](#install-virtualenv-prereqs)
+ [가상 환경에서 AWS CLI 버전 1 설치 및 업데이트](#install-virtualenv-install)
+ [AWS CLI 설치 및 제거 오류 문제 해결](#install-virtualenv-tshoot)

## 사전 조건
<a name="install-virtualenv-prereqs"></a>
+ 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 설치 및 업데이트
<a name="install-virtualenv-install"></a>

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 설치 및 제거 오류 문제 해결
<a name="install-virtualenv-tshoot"></a>

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) 섹션을 참조하세요.