Linux에서 AWS CLI 버전 1 설치, 업데이트 및 제거 - AWS Command Line Interface
사전 조건번들 설치 관리자를 사용하여 설치 및 제거pip를 사용하여 설치 및 제거pip를 사용하여 설치 및 제거AWS CLI 버전 1 실행 파일을 명령줄 경로에 추가AWS CLI 설치 및 제거 오류 문제 해결

이 문서는 AWS CLI의 버전 1에만 해당합니다. AWS CLI의 버전 2와 관련된 문서는 버전 2 사용 설명서를 참조하세요.

Linux에서 AWS CLI 버전 1 설치, 업데이트 및 제거

AWS Command Line Interface 패키지 관리자 또는 번들 설치 관리자를 사용하여 대부분의 Linux 배포에 AWS CLI(pip) 버전 1 및 해당 종속성을 설치할 수 있습니다.

awscli 패키지는 apt 및 yum과 같은 다른 패키지 관리자를 위한 리포지토리에서 사용할 수 있지만 AWS에서 생성, 관리 또는 지원하지 않습니다. 이 가이드에 설명된 대로 공식 AWS CLI 배포 지점을 통해서 만 AWS를 설치하는 것이 좋습니다.

사전 조건

Python 3.8 이상이 설치되어 있어야 합니다. 설치 지침은 Python 초급 가이드의 Python 다운로드 페이지를 참조하세요.

Python 버전 지원 매트릭스

AWS CLI version 지원되는 Python 버전
1.32.0~현재 Python 3.8 이상
1.27.0~1.31.x Python 3.7 이상
1.20.0~1.26.x Python 3.6 이상
1.19.0~1.19.x Python 2.7 이상, Python 3.6 이상
1.17 ~ 1.18.x Python 2.7 이상, Python 3.4 이상
1.0 ~ 1.16.x Python 2.6 이상, Python 3.3 이상

번들 설치 관리자를 사용하여 Linux에서 AWS CLI 버전 1 설치 및 제거

Linux 또는 macOS에서는 번들 설치 관리자를 사용하여 AWS CLI의 버전 1을 설치할 수 있습니다. 번들 설치 관리자에는 모든 종속 항목이 포함되고 오프라인으로 사용할 수 있습니다.

참고

번들 설치 관리자는 공백을 포함하는 경로에 설치하는 것을 지원하지 않습니다.

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

      특정 버전의 AWS CLI의 경우 파일 이름에 하이픈과 버전 번호를 추가하세요. 이 예제의 경우 버전 1.16.312의 파일 이름은 awscli-bundle-1.16.312.zip이므로 URL은 다음과 같습니다. https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip

  2. 패키지에서 파일을 추출합니다. 파일을 추출하기 위한 unzip이 없는 경우 Linux 배포의 기본 제공된 패키지 관리자를 사용하여 설치하세요.

    $ unzip awscli-bundle.zip

  3. 설치 프로그램을 실행합니다. 설치 관리자는 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

  4. AWS CLI가 올바르게 설치되었는지 확인하세요.

    $ aws --version
aws-cli/1.33.33 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6

    오류가 발생한 경우 AWS CLI에 대한 오류 문제 해결 섹션을 참조하세요.

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

      특정 버전의 AWS CLI의 경우 파일 이름에 하이픈과 버전 번호를 추가하세요. 이 예제의 경우 버전 1.16.312의 파일 이름은 awscli-bundle-1.16.312.zip이므로 URL은 다음과 같습니다. https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip

  2. unzip을 사용하여 패키지에서 파일을 추출합니다. unzip이 없는 경우 Linux 배포의 기본 제공된 패키지 관리자를 사용하여 설치하세요.

    $ unzip awscli-bundle.zip

  3. 설치 프로그램을 실행합니다. 설치 관리자는 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

  4. 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

    2. 다음 예제와 유사한 프로필 스크립트 끝에 내보내기 명령을 추가합니다.

      export PATH=~/.local/bin:$PATH

      이 명령은 경로(이 예제에서 ~/.local/bin)를 기존 PATH 변수 앞에 삽입합니다.

    3. 현재 세션에 프로필을 다시 로드하여 해당 변경 사항을 적용합니다.

      $ source ~/.bash_profile

  5. AWS CLI가 올바르게 설치되었는지 확인하세요.

    $ aws --version
aws-cli/1.33.33 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6

    오류가 발생한 경우 AWS CLI에 대한 오류 문제 해결 섹션을 참조하세요.

AWS CLI 버전 1 번들 설치 관리자 제거

  1. 번들 설치 관리자를 사용하여 AWS CLI을(를) 설치한 경우 다음 지침을 따릅니다. 번들 설치 관리자는 선택적 symlink를 제외하고 설치 디렉터리 외부에 아무 것도 넣지 않으므로, 설치 제거는 이 두 항목을 삭제하는 것만큼 간단합니다.

    $ sudo rm -rf /usr/local/aws
$ sudo rm -rf /usr/local/bin/aws

  2. (선택 사항) .aws 폴더에서 공유 AWS SDK 및 AWS CLI 설정 정보를 제거합니다.

    주의

    이러한 구성 및 자격 증명 설정은 모든 AWS SDK 및 AWS CLI에서 공유됩니다. 이 폴더를 제거하면 아직 시스템에 있는 AWS SDK에서 액세스할 수 없습니다.

    .aws 폴더의 기본 위치는 플랫폼마다 다르며 기본적으로 폴더는 ~/.aws/에 있습니다. 사용자에게 이 디렉터리에 대한 쓰기 권한이 있으면 sudo를 사용할 필요가 없습니다.

    $ sudo rm -r ~/.aws/

pip를 사용하여 AWS CLI 버전 1 설치 및 제거

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

  2. python 또는 python3 명령으로 스크립트를 실행하여 pip 및 기타 필요한 지원 패키지의 최신 버전을 다운로드하여 설치합니다. --user 스위치를 포함하면 스크립트는 pip를 ~/.local/bin 경로에 설치합니다.

    $ python3 get-pip.py --user

  3. 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

    2. 다음 예제와 유사한 프로필 스크립트 끝에 내보내기 명령을 추가합니다.

      export PATH=~/.local/bin:$PATH

      이 명령은 경로(이 예제에서 ~/.local/bin)를 기존 PATH 변수 앞에 삽입합니다.

    3. 현재 세션에 프로필을 다시 로드하여 해당 변경 사항을 적용합니다.

      $ source ~/.bash_profile

  4. 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

  2. AWS CLI가 올바르게 설치되었는지 확인하세요.

    $ aws --version
aws-cli/1.33.33 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6

    오류가 발생한 경우 AWS CLI에 대한 오류 문제 해결 섹션을 참조하세요.

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

    모든 파일을 제거하려면 명령 프롬프트 창이나 컴퓨터를 다시 시작해야 할 수 있습니다.

  2. (선택 사항) .aws 폴더에서 공유 AWS SDK 및 AWS CLI 설정 정보를 제거합니다.

    주의

    이러한 구성 및 자격 증명 설정은 모든 AWS SDK 및 AWS CLI에서 공유됩니다. 이 폴더를 제거하면 아직 시스템에 있는 AWS SDK에서 액세스할 수 없습니다.

    .aws 폴더의 기본 위치는 플랫폼마다 다르며 기본적으로 폴더는 ~/.aws/에 있습니다. 사용자에게 이 디렉터리에 대한 쓰기 권한이 있으면 sudo를 사용할 필요가 없습니다.

    $ sudo rm -r ~/.aws/

Snapcraft를 사용하여 AWS CLI 버전 1 설치 및 제거

스냅 설치

아직 snap이 설치되어 있지 않은 경우 Canonical Snapcraft에서 제공하는 지침을 사용하여 설치할 수 있습니다. snap version을 실행하여 해당 버전의 Linux에 snap이 이미 포함되어 있는지 확인합니다.

  1. 플랫폼에 Snapcraft를 설치합니다. Snapcraft 설치에 대한 자세한 내용은 Snap 설명서의 데몬 설치를 참조하세요.

  2. PATH 변수가 올바르게 업데이트되도록 시스템을 다시 시작합니다. 설치에 문제가 있는 경우 Snap 설명서의 일반적인 문제 해결에 나와 있는 단계를 따르세요.

  3. 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

  2. AWS CLI가 올바르게 설치되었는지 확인하세요.

    $ aws --version
aws-cli/1.33.33 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6

    오류가 발생한 경우 AWS CLI에 대한 오류 문제 해결 섹션을 참조하세요.

스냅을 사용하여 AWS CLI 제거

  1. snap를 사용하여 AWS CLI 버전 1을 설치한 경우 제거할 때도 snap를 사용해야 합니다.

    $ snap remove aws-cli

    모든 파일을 제거하려면 명령 프롬프트 창이나 컴퓨터를 다시 시작해야 할 수 있습니다.

  2. (선택 사항) .aws 폴더에서 공유 AWS SDK 및 AWS CLI 설정 정보를 제거합니다.

    주의

    이러한 구성 및 자격 증명 설정은 모든 AWS SDK 및 AWS CLI에서 공유됩니다. 이 폴더를 제거하면 아직 시스템에 있는 AWS SDK에서 액세스할 수 없습니다.

    .aws 폴더의 기본 위치는 플랫폼마다 다르며 기본적으로 폴더는 ~/.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

  2. 내보내기 명령을 프로필 스크립트에 추가하세요.

    export PATH=~/.local/bin:$PATH

    이 명령은 이 예제의 ~/.local/bin 경로를 현재 PATH 변수에 추가합니다.

  3. 현재 세션에 업데이트된 프로필을 로드합니다.

    $ source ~/.bash_profile

AWS CLI 설치 및 제거 오류 문제 해결

AWS CLI를 설치하거나 제거한 후 문제가 발생할 경우 AWS CLI에 대한 오류 문제 해결에 나온 문제 해결 단계를 참조하세요. 가장 관련성이 높은 문제 해결 단계는 명령을 찾을 수 없음 오류, 'aws --version' 명령이 설치한 버전과 다른 버전을 반환함 및 AWS CLI를 제거한 후 'aws --version' 명령이 버전을 반환함 섹션을 참조하세요.