# AWS CLI 버전 1에서 AWS CLI 버전 2 설치
<a name="cliv2-migration-instructions"></a>

이 주제에서는 AWS CLI 버전 1에서 AWS CLI 버전 2로 마이그레이션하는 지침을 제공합니다.

AWS CLI 버전 1과 2는 동일한 `aws` 명령 이름을 사용합니다. 두 버전이 모두 설치되어 있는 경우 컴퓨터는 검색 경로에 있는 첫 번째 버전을 사용합니다. 이전에 AWS CLI 버전 1을 설치한 경우 다음 중 하나를 수행하여 AWS CLI 버전 2를 사용하는 것이 좋습니다.
+ ** 권장** – [AWS CLI 버전 1을 제거하고 AWS CLI 버전 2만 사용합니다](#cliv2-migration-instructions-migrate).
+ [두 버전을 모두 설치하려면](#cliv2-migration-instructions-side-by-side) 운영 체제의 기능을 사용하여 두 `aws` 명령 중 하나에 대해 다른 이름으로 심볼 링크(symlink) 또는 별칭을 만듭니다.

버전 1과 버전 2 간의 주요 변경 사항에 대한 자세한 내용은 [AWS CLI 버전 2의 새로운 기능 및 변경 사항](cliv2-migration-changes.md) 섹션을 참조하세요.

## 버전 1을 버전 2로 교체
<a name="cliv2-migration-instructions-migrate"></a>

AWS CLI 버전 1을 AWS CLI 버전 2로 교체하려면 다음 단계를 수행합니다.

**AWS CLI 버전 1을 AWS CLI 버전 2로 교체하려면**

1. [AWS CLI 버전 2의 새로운 기능 및 변경 사항](cliv2-migration-changes.md)에서 버전 1과 버전 2 간의 주요 변경 사항을 확인하여 마이그레이션을 위한 기존 스크립트를 준비합니다. 업그레이드 디버그 모드 기능을 사용하여 [업그레이드 디버그 모드를 사용하여 AWS CLI 버전 1을 AWS CLI 버전 2로 업그레이드](cli-upgrade-debug-mode.md)의 지침에 따라 준비 과정을 안내받을 수 있습니다.

1. [AWS CLI 버전 1 설치, 업데이트 및 제거](https://docs.aws.amazon.com/cli/v1/userguide/cli-chap-install.html)에서 사용 중인 운영 체제에 해당하는 제거 지침을 따라 AWS CLI 버전 1을 제거합니다.

1. 다음 명령을 사용하여 AWS CLI가 완전히 제거되었는지 확인합니다.

   ```
   $ aws --version
   ```

   출력에 따라 다음 작업 중 하나를 완료합니다.
   + **반환된 버전 없음:** AWS CLI 버전 1을 성공적으로 제거했으며 다음 단계를 진행할 수 있습니다.
   + **버전이 반환됨:** 여전히 AWS CLI 버전 1이 설치되어 있습니다. 문제 해결 단계는 [AWS CLI를 제거한 후 '`aws --version`' 명령이 버전을 반환함](cli-chap-troubleshooting.md#tshoot-uninstall-1) 섹션을 참조하세요. 버전 출력이 수신되지 않을 때까지 문제 해결 단계를 수행합니다.

1. [최신 버전의 AWS CLI 설치 또는 업데이트](getting-started-install.md)에서 사용 중인 운영 체제에 해당하는 제거 지침을 따라 AWS CLI 버전 2를 설치합니다.

## 나란히 설치
<a name="cliv2-migration-instructions-side-by-side"></a>

두 버전을 모두 설치하려면 운영 체제의 기능을 사용하여 두 `aws` 명령 중 하나에 대해 다른 이름으로 심볼 링크(symlink) 또는 별칭을 만듭니다.

1. [최신 버전의 AWS CLI 설치 또는 업데이트](getting-started-install.md)에서 사용 중인 운영 체제에 해당하는 제거 지침을 따라 AWS CLI 버전 2를 설치합니다.

1. 운영 체제의 기능을 사용하여 두 `aws` 명령 중 하나에 대해 다른 이름으로 심볼릭 링크 또는 별칭을 생성합니다(예: AWS CLI 버전 2에 *`aws2`* 사용). 다음은 AWS CLI 버전 2의 심볼 링크 예제입니다. *PATH*를 해당 설치 위치로 대체합니다.

------
#### [ Linux and macOS ]

   Linux 및 macOS에서 [심볼 링크](https://www.linux.com/topic/desktop/understanding-linux-links/) 또는 [별칭](https://www.linux.com/topic/desktop/aliases-diy-shell-commands/)을 사용할 수 있습니다.

   ```
   $ alias aws2='PATH'
   ```

------
#### [ Windows command prompt ]

   [https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/doskey](https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/doskey)Windows의 경우

   ```
   C:\> doskey aws2=PATH
   ```

------