# AWS CLI 버전 2의 이전 릴리스 설치
이 주제에서는 지원되는 운영 체제에서 AWS Command Line Interface 버전 2(AWS CLI)의 이전 릴리스를 설치하는 방법을 설명합니다. AWS CLI 버전 2 릴리스에 대한 자세한 내용은 GitHub에서 [AWS CLI 버전 2 변경 로그](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst)를 참조하세요.
AWS CLI 버전 2 설치 지침:
## Linux
### 설치 요구 사항
+ AWS CLI 버전 2의 어느 릴리스를 설치할지 알아야 합니다. 버전 목록은 *GitHub*에서 [AWS CLI 버전 2 변경 로그](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst)를 참조하세요.
+ 다운로드한 패키지를 추출 또는 "압축 해제"할 수 있어야 합니다. 운영 체제에 기본 제공 `unzip` 명령이 없는 경우 이와 동등한 명령을 사용하세요.
+ AWS CLI 버전 2에서는 `glibc`, `groff` 및 `less`를 사용합니다. 이들은 Linux의 대부분의 주요 배포판에 기본적으로 포함되어 있습니다.
+ AWS CLI 버전 2는 CentOS, Fedora, Ubuntu, Amazon Linux 1, Amazon Linux 2 및 Linux ARM 최신 배포판의 64비트 버전에서 지원됩니다.
+ AWS에서는 타사 리포지토리를 유지 관리하지 않으므로 최신 버전의 AWS CLI가 포함되었다고 보장할 수 없습니다.
### 설치 지침
명령줄에서 다음 단계에 따라 Linux에 AWS CLI를 설치합니다.
64비트 Linux를 사용하는지 Linux ARM을 사용하는지에 따라 복사 및 붙여넣기가 쉬운 한 그룹에서 단계를 제공합니다. 다음 단계에서 각 라인에 대한 설명을 참조하세요.
------
#### [ Linux x86 (64-bit) ]
**참고**
**(선택 사항)** 다음 명령 블록은 다운로드의 무결성을 먼저 확인하지 않고 AWS CLI를 다운로드하고 설치합니다. 다운로드 무결성을 확인하려면 아래의 단계별 지침을 사용하세요.
버전 목록은 *GitHub*에서 [AWS CLI 버전 2 변경 로그](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst)를 참조하세요.
AWS CLI를 **설치하려면** 다음 명령을 실행합니다.
버전을 지정하려면 파일 이름에 하이픈과 버전 번호를 추가합니다. 이 예제의 경우 버전 *2.0.30*의 파일 이름은 `awscli-exe-linux-x86_64-2.0.30.zip`이므로 명령은 다음과 같습니다.
```
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64-2.0.30.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install
```
AWS CLI의 **현재 설치를 업데이트하려면** 기존 심볼 링크 및 설치 관리자 정보를 추가하여 `--bin-dir`, `--install-dir`, `--update` 파라미터를 포함한 `install` 명령을 구성합니다. 다음 명령 블록은 */usr/local/bin*의 예제 심볼 링크와 */usr/local/aws-cli*의 설치 관리자 위치 예제를 사용합니다.
```
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64-2.0.30.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install --bin-dir /usr/local/bin --install-dir /usr/local/aws-cli --update
```
------
#### [ Linux ARM ]
**참고**
**(선택 사항)** 다음 명령 블록은 다운로드의 무결성을 먼저 확인하지 않고 AWS CLI를 다운로드하고 설치합니다. 다운로드 무결성을 확인하려면 아래의 단계별 지침을 사용하세요.
버전 목록은 *GitHub*에서 [AWS CLI 버전 2 변경 로그](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst)를 참조하세요.
AWS CLI를 **설치하려면** 다음 명령을 실행합니다.
버전을 지정하려면 파일 이름에 하이픈과 버전 번호를 추가합니다. 이 예제의 경우 버전 *2.0.30*의 파일 이름은 `awscli-exe-linux-aarch64-2.0.30.zip`이므로 명령은 다음과 같습니다.
```
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64-2.0.30.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install
```
AWS CLI의 **현재 설치를 업데이트하려면** 기존 심볼 링크 및 설치 관리자 정보를 추가하여 `--bin-dir`, `--install-dir`, `--update` 파라미터를 포함한 `install` 명령을 구성합니다. 다음 명령 블록은 */usr/local/bin*의 예제 심볼 링크와 */usr/local/aws-cli*의 설치 관리자 위치 예제를 사용합니다.
```
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64-2.0.30.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install --bin-dir /usr/local/bin --install-dir /usr/local/aws-cli --update
```
------
1. 다음 방법 중 하나로 설치 파일을 다운로드합니다.
------
#### [ Linux x86 (64-bit) ]
+ **`curl` 명령 사용** - `-o` 옵션은 다운로드한 패키지가 기록되는 파일 이름을 지정합니다. 다음 예제 명령의 옵션을 사용하면 다운로드한 파일이 로컬 이름 `awscliv2.zip`으로 현재 디렉터리에 기록됩니다.
버전을 지정하려면 파일 이름에 하이픈과 버전 번호를 추가합니다. 이 예제의 경우 버전 *2.0.30*의 파일 이름은 `awscli-exe-linux-x86_64-2.0.30.zip`이므로 명령은 다음과 같습니다.
```
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64-2.0.30.zip" -o "awscliv2.zip"
```
버전 목록은 *GitHub*에서 [AWS CLI 버전 2 변경 로그](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst)를 참조하세요.
+ **URL에서 다운로드** –
브라우저에서 파일 이름에 하이픈과 버전 번호를 추가하여 AWS CLI의 특정 버전을 다운로드합니다.
```
https://awscli.amazonaws.com/awscli-exe-linux-x86_64-version.number.zip
```
이 예제에서 버전 *2.0.30*의 파일 이름은 awscli-exe-linux-x86\$164-2.0.30. zip이며, 다음 링크가 생성됩니다. [https://awscli.amazonaws.com/awscli-exe-linux-x86_64-2.0.30.zip](https://awscli.amazonaws.com/awscli-exe-linux-x86_64-2.0.30.zip)
------
#### [ Linux ARM ]
+ **`curl` 명령 사용** - `-o` 옵션은 다운로드한 패키지가 기록되는 파일 이름을 지정합니다. 다음 예제 명령의 옵션을 사용하면 다운로드한 파일이 로컬 이름 `awscliv2.zip`으로 현재 디렉터리에 기록됩니다.
버전을 지정하려면 파일 이름에 하이픈과 버전 번호를 추가합니다. 이 예제의 경우 버전 *2.0.30*의 파일 이름은 `awscli-exe-linux-aarch64-2.0.30.zip`이므로 명령은 다음과 같습니다.
```
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64-2.0.30.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install
```
+ **URL에서 다운로드** –
브라우저에서 파일 이름에 하이픈과 버전 번호를 추가하여 AWS CLI의 특정 버전을 다운로드합니다.
```
https://awscli.amazonaws.com/awscli-exe-linux-aarch64-version.number.zip
```
이 예제의 경우 버전 *2.0.30*의 파일 이름은 `awscli-exe-linux-aarch64-2.0.30.zip`이므로 링크는 다음과 같습니다. [https://awscli.amazonaws.com/awscli-exe-linux-aarch64-2.0.30.zip](https://awscli.amazonaws.com/awscli-exe-linux-aarch64-2.0.30.zip)
------
1. **(선택 사항) 다운로드한 zip 파일의 무결성 확인**
위의 단계에서 AWS CLI 설치 관리자 패키지 `.zip`를 수동으로 다운로드하도록 선택한 경우 다음 단계에 따라 `GnuPG` 도구를 사용하여 서명을 확인할 수 있습니다.
AWS CLI 설치 관리자 패키지 `.zip` 파일은 PGP 서명을 사용하여 암호로 서명됩니다. 파일이 손상되거나 변경되면 이 확인이 실패하며 설치를 진행해서는 안 됩니다.
1. 패키지 관리자를 사용하여 `gpg` 명령을 다운로드하고 설치합니다. `GnuPG`에 대한 자세한 내용은 [GnuPG 웹 사이트](https://www.gnupg.org/)를 참조하세요.
1. 퍼블릭 키 파일을 만들려면 텍스트 파일을 만들고 다음 텍스트를 붙여 넣습니다.
```
-----BEGIN PGP PUBLIC KEY BLOCK-----
mQINBF2Cr7UBEADJZHcgusOJl7ENSyumXh85z0TRV0xJorM2B/JL0kHOyigQluUG
ZMLhENaG0bYatdrKP+3H91lvK050pXwnO/R7fB/FSTouki4ciIx5OuLlnJZIxSzx
PqGl0mkxImLNbGWoi6Lto0LYxqHN2iQtzlwTVmq9733zd3XfcXrZ3+LblHAgEt5G
TfNxEKJ8soPLyWmwDH6HWCnjZ/aIQRBTIQ05uVeEoYxSh6wOai7ss/KveoSNBbYz
gbdzoqI2Y8cgH2nbfgp3DSasaLZEdCSsIsK1u05CinE7k2qZ7KgKAUIcT/cR/grk
C6VwsnDU0OUCideXcQ8WeHutqvgZH1JgKDbznoIzeQHJD238GEu+eKhRHcz8/jeG
94zkcgJOz3KbZGYMiTh277Fvj9zzvZsbMBCedV1BTg3TqgvdX4bdkhf5cH+7NtWO
lrFj6UwAsGukBTAOxC0l/dnSmZhJ7Z1KmEWilro/gOrjtOxqRQutlIqG22TaqoPG
fYVN+en3Zwbt97kcgZDwqbuykNt64oZWc4XKCa3mprEGC3IbJTBFqglXmZ7l9ywG
EEUJYOlb2XrSuPWml39beWdKM8kzr1OjnlOm6+lpTRCBfo0wa9F8YZRhHPAkwKkX
XDeOGpWRj4ohOx0d2GWkyV5xyN14p2tQOCdOODmz80yUTgRpPVQUtOEhXQARAQAB
tCFBV1MgQ0xJIFRlYW0gPGF3cy1jbGlAYW1hem9uLmNvbT6JAlQEEwEIAD4CGwMF
CwkIBwIGFQoJCAsCBBYCAwECHgECF4AWIQT7Xbd/1cEYuAURraimMQrMRnJHXAUC
aGveYQUJDMpiLAAKCRCmMQrMRnJHXKBYD/9Ab0qQdGiO5hObchG8xh8Rpb4Mjyf6
0JrVo6m8GNjNj6BHkSc8fuTQJ/FaEhaQxj3pjZ3GXPrXjIIVChmICLlFuRXYzrXc
Pw0lniybypsZEVai5kO0tCNBCCFuMN9RsmmRG8mf7lC4FSTbUDmxG/QlYK+0IV/l
uJkzxWa+rySkdpm0JdqumjegNRgObdXHAQDWlubWQHWyZyIQ2B4U7AxqSpcdJp6I
S4Zds4wVLd1WE5pquYQ8vS2cNlDm4QNg8wTj58e3lKN47hXHMIb6CHxRnb947oJa
pg189LLPR5koh+EorNkA1wu5mAJtJvy5YMsppy2y/kIjp3lyY6AmPT1posgGk70Z
CmToEZ5rbd7ARExtlh76A0cabMDFlEHDIK8RNUOSRr7L64+KxOUegKBfQHb9dADY
qqiKqpCbKgvtWlds909Ms74JBgr2KwZCSY1HaOxnIr4CY43QRqAq5YHOay/mU+6w
hhmdF18vpyK0vfkvvGresWtSXbag7Hkt3XjaEw76BzxQH21EBDqU8WJVjHgU6ru+
DJTs+SxgJbaT3hb/vyjlw0lK+hFfhWKRwgOXH8vqducF95NRSUxtS4fpqxWVaw3Q
V2OWSjbne99A5EPEySzryFTKbMGwaTlAwMCwYevt4YT6eb7NmFhTx0Fis4TalUs+
j+c7Kg92pDx2uQ==
=OBAt
-----END PGP PUBLIC KEY BLOCK-----
```
참고로 다음은 퍼블릭 키의 세부 정보입니다.
```
Key ID: A6310ACC4672
Type: RSA
Size: 4096/4096
Created: 2019-09-18
Expires: 2026-07-07
User ID: AWS CLI Team
Key fingerprint: FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C
```
1. 다음 명령을 사용하여 AWS CLI 퍼블릭 키를 가져옵니다. *public-key-file-name*을 생성한 퍼블릭 키의 파일 이름으로 대체합니다.
```
$ gpg --import public-key-file-name
gpg: /home/username/.gnupg/trustdb.gpg: trustdb created
gpg: key A6310ACC4672475C: public key "AWS CLI Team " imported
gpg: Total number processed: 1
gpg: imported: 1
```
1. 다운로드한 패키지의 AWS CLI 서명 파일을 다운로드합니다. 해당 `.zip` 파일과 경로 및 이름은 같지만 확장명은 `.sig`입니다. 다음 예제에서는 이 파일을 현재 디렉터리에 이름이 `awscliv2.sig`인 파일로 저장합니다.
------
#### [ Linux x86 (64-bit) ]
**최신 버전의 AWS CLI의 경우** 다음 명령 블록을 사용하세요.
```
$ curl -o awscliv2.sig https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip.sig
```
**특정 버전의 AWS CLI의 경우** 파일 이름에 하이픈과 버전 번호를 추가하세요. 이 예제의 경우 버전 *2.0.30*의 파일 이름은 `awscli-exe-linux-x86_64-2.0.30.zip.sig`이므로 명령은 다음과 같습니다.
```
$ curl -o awscliv2.sig https://awscli.amazonaws.com/awscli-exe-linux-x86_64-2.0.30.zip.sig
```
버전 목록은 *GitHub*에서 [AWS CLI 버전 2 변경 로그](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst)를 참조하세요.
------
#### [ Linux ARM ]
**최신 버전의 AWS CLI의 경우** 다음 명령 블록을 사용하세요.
```
$ curl -o awscliv2.sig https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip.sig
```
**특정 버전의 AWS CLI의 경우** 파일 이름에 하이픈과 버전 번호를 추가하세요. 이 예제의 경우 버전 *2.0.30*의 파일 이름은 `awscli-exe-linux-aarch64-2.0.30.zip.sig`이므로 명령은 다음과 같습니다.
```
$ curl -o awscliv2.sig https://awscli.amazonaws.com/awscli-exe-linux-aarch64-2.0.30.zip.sig
```
버전 목록은 *GitHub*에서 [AWS CLI 버전 2 변경 로그](https://github.com/aws/aws-cli/blob/v2/CHANGELOG.rst?plain=1)를 참조하세요.
------
1. `.sig` 및 `.zip` 파일 이름을 모두 `gpg` 명령의 파라미터로 전달하여 서명을 확인합니다.
```
$ gpg --verify awscliv2.sig awscliv2.zip
```
다음과 같이 출력됩니다.
```
gpg: Signature made Mon Nov 4 19:00:01 2019 PST
gpg: using RSA key FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C
gpg: Good signature from "AWS CLI Team " [unknown]
gpg: WARNING: This key is not certified with a trusted signature!
gpg: There is no indication that the signature belongs to the owner.
Primary key fingerprint: FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C
```
**중요**
결과에서 경고가 예상되지만 문제가 되지는 않습니다. 이 경고는 개인 PGP 키(보유한 경우)와 AWS CLI PGP 키 사이에 신뢰 체인이 없기 때문에 발생한 것입니다. 자세한 내용은 [Web of trust](https://en.wikipedia.org/wiki/Web_of_trust)를 참조하세요.
1. 설치 관리자의 압축을 풉니다. Linux 배포에 기본 제공 `unzip` 명령이 없는 경우 이와 동등한 명령을 사용하여 압축을 풉니다. 다음 명령 예제는 패키지의 압축을 풀고 현재 디렉터리 아래에 `aws`라는 디렉터리를 만듭니다.
```
$ unzip awscliv2.zip
```
1. 설치 프로그램을 실행합니다. 설치 명령은 새로 압축을 푼 `install` 디렉터리의 `aws`이라는 이름의 파일을 사용합니다. 기본적으로 파일은 모두 `/usr/local/aws-cli`에 설치되고 `/usr/local/bin`에 심볼 링크가 생성됩니다. 이 명령은 해당 디렉터리에 대한 쓰기 권한을 부여하는 `sudo`를 포함합니다.
```
$ sudo ./aws/install
```
이미 쓰기 권한이 있는 디렉터리를 지정하는 경우 `sudo` 없이도 설치할 수 있습니다. `install` 명령에 대해 다음 지침에 따라 설치 위치를 지정합니다.
+ `-i` 및 `-b` 파라미터에 입력하는 경로의 볼륨 이름이나 디렉터리 이름에 공백이나 기타 공백 문자가 없어야 합니다. 공백이 있으면 설치가 실패합니다.
+ `--install-dir` 또는 `-i` - 이 옵션은 모든 파일을 복사할 디렉터리를 지정합니다.
기본 값은 `/usr/local/aws-cli`입니다.
+ `--bin-dir` 또는 `-b` - 이 옵션은 설치 디렉터리의 기본 `aws` 프로그램에 대한 심볼 링크를 지정된 경로의 `aws` 파일에 연결하도록 지정합니다. 지정된 디렉터리에 대한 쓰기 권한이 있어야 합니다. 이미 경로에 있는 디렉터리에 대한 symlink를 만들면 설치 디렉터리를 사용자의 `$PATH` 변수에 추가할 필요가 없습니다.
기본 값은 `/usr/local/bin`입니다.
```
$ ./aws/install -i /usr/local/aws-cli -b /usr/local/bin
```
**참고**
AWS CLI 버전 2의 현재 설치를 최신 버전으로 업데이트하려면 기존 심볼 링크 및 설치 관리자 정보를 추가하여 `--update` 파라미터를 포함한 `install` 명령을 구성합니다.
```
$ sudo ./aws/install --bin-dir /usr/local/bin --install-dir /usr/local/aws-cli --update
```
기존 심볼 링크 및 설치 디렉터리를 찾으려면 다음 단계를 따릅니다.
`which` 명령을 사용하여 symlink를 찾습니다. 그러면 `--bin-dir` 파라미터와 함께 사용할 경로가 제공됩니다.
```
$ which aws
/usr/local/bin/aws
```
`ls` 명령을 사용하여 symlink가 가리키는 디렉터리를 찾습니다. 그러면 `--install-dir` 파라미터와 함께 사용할 경로가 제공됩니다.
```
$ ls -l /usr/local/bin/aws
lrwxrwxrwx 1 ec2-user ec2-user 49 Oct 22 09:49 /usr/local/bin/aws -> /usr/local/aws-cli/v2/current/bin/aws
```
1. 다음 명령을 사용하여 설치를 확인합니다.
```
$ aws --version
aws-cli/2.27.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64
```
`aws` 명령을 찾을 수 없는 경우 터미널을 재시작하거나 [AWS CLI에 대한 오류 문제 해결](cli-chap-troubleshooting.md)에 나온 문제 해결 지침을 따라야 할 수도 있습니다.
## macOS
### 설치 요구 사항
+ AWS CLI 버전 2의 어느 릴리스를 설치할지 알아야 합니다. 버전 목록은 *GitHub*에서 [AWS CLI 버전 2 변경 로그](https://github.com/aws/aws-cli/blob/v2/CHANGELOG.rst?plain=1)를 참조하세요.
+ Apple이 지원하는 64비트 macOS 버전에서 AWS CLI 버전 2가 지원됩니다.
+ AWS에서는 타사 리포지토리를 유지 관리하지 않으므로 최신 버전의 AWS CLI가 포함되었다고 보장할 수 없습니다.
### 설치 지침
다음과 같은 방법으로 macOS에서 AWS CLI 버전 2를 설치할 수 있습니다.
------
#### [ GUI installer ]
다음 단계는 표준 macOS 사용자 인터페이스와 브라우저를 사용하여 AWS CLI 버전 2의 최신 버전을 설치하거나 업데이트하는 방법을 보여줍니다. 최신 버전으로 업데이트하는 경우 현재 버전에 사용한 것과 동일한 설치 방법을 사용하세요.
1. 브라우저에서 파일 이름에 하이픈과 버전 번호를 추가하여 AWS CLI의 특정 버전을 다운로드합니다.
```
https://awscli.amazonaws.com/AWSCLIV2-version.number.pkg
```
이 예제의 경우 버전 *2.0.30*의 파일 이름은 `AWSCLIV2-2.0.30.pkg`이므로 링크는 다음과 같습니다. [https://awscli.amazonaws.com/AWSCLIV2-2.0.30.pkg](https://awscli.amazonaws.com/AWSCLIV2-2.0.30.pkg).
1. 다운로드한 파일을 실행하고 화면의 지침을 따릅니다. 다음과 같은 방법으로 AWS CLI 버전 2를 설치하도록 선택할 수 있습니다.
+ **컴퓨터의 모든 사용자 허용( 필요)`sudo`**
+ 임의의 폴더에 설치하거나 `/usr/local/aws-cli`의 권장 기본 폴더를 선택할 수 있습니다.
+ 설치 관리자는 사용자가 선택한 설치 폴더에 있는 기본 프로그램에 연결된 `/usr/local/bin/aws`에서 symlink를 자동으로 만듭니다.
+ **현재 사용자만 허용(가 필요하지 않음)`sudo`**
+ 쓰기 권한이 있는 폴더에 설치할 수 있습니다.
+ 표준 사용자 권한으로 인해 설치 관리자가 완료된 후 명령 프롬프트에서 다음 명령을 사용하여 `$PATH` 및 `aws` 프로그램을 가리키는 symlink 파일을 `aws_completer`에 수동으로 만들어야 합니다. 쓸 수 있는 폴더가 `$PATH`에 포함된 경우, 해당 폴더를 대상 경로로 지정하면 `sudo` 없이 다음 명령을 실행할 수 있습니다. 쓰기 가능한 폴더가 `$PATH`에 없는 경우 명령에서 `sudo`를 사용하여 지정된 대상 폴더에 쓸 수 있는 권한을 얻어야 합니다. symlink의 기본 위치는 `/usr/local/bin/`입니다.
```
$ sudo ln -s /folder/installed/aws-cli/aws /usr/local/bin/aws
$ sudo ln -s /folder/installed/aws-cli/aws_completer /usr/local/bin/aws_completer
```
**참고**
설치 관리자의 아무 위치에서나 **Cmd\$1L**을 눌러 설치에 대한 디버그 로그를 볼 수 있습니다. 이렇게 하면 로그를 필터링하고 저장할 수 있는 로그 창이 열립니다. 로그 파일도 `/var/log/install.log`에 자동으로 저장됩니다.
1. 셸이 `aws`에서 `$PATH` 명령을 찾아서 실행할 수 있는지 확인하려면 다음 명령을 사용합니다.
```
$ which aws
/usr/local/bin/aws
$ aws --version
aws-cli/2.27.41 Python/3.11.6 Darwin/23.3.0
```
`aws` 명령을 찾을 수 없는 경우 터미널을 재시작하거나 [AWS CLI에 대한 오류 문제 해결](cli-chap-troubleshooting.md)에 나온 문제 해결 지침을 따라야 할 수도 있습니다.
------
#### [ Command line installer - All users ]
`sudo` 권한이 있는 경우 컴퓨터의 모든 사용자용으로 AWS CLI 버전 2를 설치할 수 있습니다. 손쉽게 그룹을 복사 및 붙여넣기할 수 있는 단계를 제공합니다. 다음 단계에서 각 라인에 대한 설명을 참조하세요.
특정 버전의 AWS CLI의 경우 파일 이름에 하이픈과 버전 번호를 추가하세요. 이 예제의 경우 버전 *2.0.30*의 파일 이름은 `AWSCLIV2-2.0.30.pkg`이므로 명령은 다음과 같습니다.
```
$ curl "https://awscli.amazonaws.com/AWSCLIV2-2.0.30.pkg" -o "AWSCLIV2.pkg"
$ sudo installer -pkg AWSCLIV2.pkg -target /
```
1. `curl` 명령을 사용하여 파일을 다운로드할 수 있습니다. `-o` 옵션은 다운로드한 패키지가 기록되는 파일 이름을 지정합니다. 이 예제에서 파일은 현재 폴더의 `AWSCLIV2.pkg`에 기록됩니다.
특정 버전의 AWS CLI의 경우 파일 이름에 하이픈과 버전 번호를 추가하세요. 이 예제의 경우 버전 *2.0.30*의 파일 이름은 `AWSCLIV2-2.0.30.pkg`이므로 명령은 다음과 같습니다.
```
$ curl "https://awscli.amazonaws.com/AWSCLIV2-2.0.30.pkg" -o "AWSCLIV2.pkg"
```
버전 목록은 *GitHub*에서 [AWS CLI 버전 2 변경 로그](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst)를 참조하세요.
1. 다운로드한 `installer` 파일을 소스로 지정하여 표준 macOS `.pkg` 프로그램을 실행합니다. `-pkg` 파라미터를 사용하여 설치할 패키지의 이름을 지정하고 `-target /` 파라미터를 사용하여 패키지를 설치할 드라이브를 지정합니다. 파일은 `/usr/local/aws-cli`에 설치되고 `/usr/local/bin`에 symlink가 자동으로 만들어집니다. 해당 폴더에 쓰기 권한을 부여하려면 명령에 `sudo`를 포함해야 합니다.
```
$ sudo installer -pkg ./AWSCLIV2.pkg -target /
```
설치가 완료되면 디버그 로그가 `/var/log/install.log`에 기록됩니다.
1. 셸이 `aws`에서 `$PATH` 명령을 찾아서 실행할 수 있는지 확인하려면 다음 명령을 사용합니다.
```
$ which aws
/usr/local/bin/aws
$ aws --version
aws-cli/2.27.41 Python/3.11.6 Darwin/23.3.0
```
`aws` 명령을 찾을 수 없는 경우 터미널을 재시작하거나 [AWS CLI에 대한 오류 문제 해결](cli-chap-troubleshooting.md)에 나온 문제 해결 지침을 따라야 할 수도 있습니다.
------
#### [ Command line - Current user ]
1. AWS CLI를 설치할 폴더를 지정하려면 XML 파일을 만들어야 합니다. 이 파일은 다음 예제와 비슷한 XML 형식 파일입니다. 다음과 같이 모든 값을 그대로 두고 9행의 */Users/myusername* 경로를 AWS CLI 버전 2를 설치할 폴더의 경로로 바꿔야 합니다. *폴더가 이미 있어야 합니다. 그렇지 않으면 명령이 실패합니다.* 이 XML 예제는 설치 관리자가 AWS CLI 폴더에 `/Users/myusername`를 설치하도록 지정합니다. 여기서는 `aws-cli`라는 폴더가 만들어집니다.
```
choiceAttribute
customLocation
attributeSetting
/Users/myusername
choiceIdentifier
default
```
1. `pkg` 명령을 사용하여 `curl` 설치 관리자를 다운로드합니다. `-o` 옵션은 다운로드한 패키지가 기록되는 파일 이름을 지정합니다. 이 예제에서 파일은 현재 폴더의 `AWSCLIV2.pkg`에 기록됩니다.
특정 버전의 AWS CLI의 경우 파일 이름에 하이픈과 버전 번호를 추가합니다. 이 예제의 경우 버전 *2.0.30*의 파일 이름은 `AWSCLIV2-2.0.30.pkg`이므로 명령은 다음과 같습니다.
```
$ curl "https://awscli.amazonaws.com/AWSCLIV2-2.0.30.pkg" -o "AWSCLIV2.pkg"
```
버전 목록은 *GitHub*에서 [AWS CLI 버전 2 변경 로그](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst)를 참조하세요.
1. 다음 옵션을 사용하여 표준 macOS `installer` 프로그램을 실행합니다.
+ `-pkg` 파라미터를 사용하여 설치할 패키지 이름을 지정합니다.
+ `-target` 파라미터를 `CurrentUserHomeDirectory`로 설정하여 *현재 사용자 전용* 설치를 지정합니다.
+ `-applyChoiceChangesXML` 파라미터에서 만든 XML 파일의 경로(현재 폴더 기준) 및 이름을 지정합니다.
다음 예제에서는 AWS CLI 폴더에 `/Users/myusername/aws-cli`를 설치합니다.
```
$ installer -pkg AWSCLIV2.pkg \
-target CurrentUserHomeDirectory \
-applyChoiceChangesXML choices.xml
```
1. 표준 사용자 권한은 일반적으로 `$PATH`의 폴더에 쓰기를 허용하지 않기 때문에 이 모드의 설치 관리자는 symlink를 `aws` 및 `aws_completer` 프로그램에 추가하지 않습니다. AWS CLI를 올바르게 실행하려면 설치 관리자가 완료된 후 symlink를 수동으로 만들어야 합니다. 쓸 수 있는 폴더가 `$PATH`에 포함되어 있고 해당 폴더를 대상 경로로 지정하면 `sudo` 없이 다음 명령을 실행할 수 있습니다. 쓰기 가능한 폴더가 `$PATH`에 없는 경우 `sudo`를 사용하여 지정된 대상 폴더에 쓸 수 있는 권한을 얻어야 합니다. symlink의 기본 위치는 `/usr/local/bin/`입니다.
```
$ sudo ln -s /folder/installed/aws-cli/aws /usr/local/bin/aws
$ sudo ln -s /folder/installed/aws-cli/aws_completer /usr/local/bin/aws_completer
```
설치가 완료되면 디버그 로그가 `/var/log/install.log`에 기록됩니다.
1. 셸이 `aws`에서 `$PATH` 명령을 찾아서 실행할 수 있는지 확인하려면 다음 명령을 사용합니다.
```
$ which aws
/usr/local/bin/aws
$ aws --version
aws-cli/2.27.41 Python/3.11.6 Darwin/23.3.0
```
`aws` 명령을 찾을 수 없는 경우 터미널을 재시작하거나 [AWS CLI에 대한 오류 문제 해결](cli-chap-troubleshooting.md)에 나온 문제 해결 지침을 따라야 할 수도 있습니다.
------
## Windows
### 설치 요구 사항
+ AWS CLI 버전 2의 어느 릴리스를 설치할지 알아야 합니다. 버전 목록은 *GitHub*에서 [AWS CLI 버전 2 변경 로그](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst)를 참조하세요.
+ Microsoft에서 지원하는 64비트 Windows 버전에서 AWS CLI를 지원합니다.
+ 소프트웨어 설치 관리자 권한
### 설치 지침
Windows에서 AWS CLI 버전 2의 현재 설치를 업데이트하려면 업데이트할 때마다 새 설치 관리자를 다운로드하여 이전 버전을 덮어씁니다. AWS CLI는 정기적으로 업데이트됩니다. 최신 버전이 출시된 시기를 확인하려면 *GitHub*에서 [AWS CLI 버전 2 변경 로그](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst)를 참조하세요.
1. 다음 중 한 가지 방법으로 Windows용 AWS CLI MSI 설치 관리자(64비트)를 다운로드하여 실행합니다.
+ **MSI 설치 관리자 다운로드 및 실행:** 특정 버전의 AWS CLI에 대한 다운로드 링크를 만들려면 파일 이름에 하이픈과 버전 번호를 추가합니다.
```
https://awscli.amazonaws.com/AWSCLIV2-version.number.msi
```
이 예제의 경우 버전 *2.0.30*의 파일 이름은 `AWSCLIV2-2.0.30.msi`이므로 링크는 다음과 같습니다. [https://awscli.amazonaws.com/AWSCLIV2-2.0.30.msi](https://awscli.amazonaws.com/AWSCLIV2-2.0.30.msi).
+ **msiexec 명령 사용:** 또는 `msiexec` 명령에 링크를 추가하여 MSI 설치 관리자를 사용할 수 있습니다. 특정 버전의 AWS CLI의 경우 파일 이름에 하이픈과 버전 번호를 추가하세요.
```
C:\> msiexec.exe /i https://awscli.amazonaws.com/AWSCLIV2-version.number.msi
```
이 예제의 경우 버전 *2.0.30*의 파일 이름은 `AWSCLIV2-2.0.30.msi`이므로 링크는 다음과 같습니다. [https://awscli.amazonaws.com/AWSCLIV2-2.0.30.msi](https://awscli.amazonaws.com/AWSCLIV2-2.0.30.msi)
```
C:\> msiexec.exe /i https://awscli.amazonaws.com/AWSCLIV2-2.0.30.msi
```
`msiexec`에서 사용할 수 있는 다양한 파라미터는 *Microsoft Docs* 웹 사이트에서 [msiexec](https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/msiexec)을 참조하세요.
버전 목록은 *GitHub*에서 [AWS CLI 버전 2 변경 로그](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst)를 참조하세요.
1. 설치를 확인하려면 **시작** 메뉴를 열고, `cmd`를 검색하여 명령 프롬프트 창을 열고, 명령 프롬프트에서 `aws --version` 명령을 사용합니다.
```
C:\> aws --version
aws-cli/2.27.41 Python/3.11.6 Windows/10 exe/AMD64 prompt/off
```
Windows에서 프로그램을 찾을 수 없는 경우 명령 프롬프트 창을 닫고 다시 열어 경로를 새로 고치거나 [AWS CLI에 대한 오류 문제 해결](cli-chap-troubleshooting.md)의 문제 해결 지침을 따라야 할 수 있습니다.
## 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 버전 2를 사용하기 위한 사전 조건](getting-started-prereqs.md)의 단계를 완료하고 AWS CLI를 설치한 후에는 [AWS CLI 설정](getting-started-quickstart.md)의 단계를 수행해야 합니다.