AWS SAM CLI 버전 관리 - AWS Serverless Application Model
AWS SAMCLI업그레이드 AWS SAM CLI 제거Homebrew에서 전환 AWS SAMCLI의 nightly build 관리AWS SAM을 이용하여 가상 환경에 CLIpip 설치AWS SAM로 CLIHomebrew 관리문제 해결

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

AWS SAM CLI 버전 관리

업그레이드, 다운그레이드, 제거를 통해 AWS Serverless Application Model 명령줄 인터페이스(AWS SAM CLI) 버전을 관리합니다. 선택에 따라, AWS SAM CLI nightly build로 다운로드하고 설치할 수 있습니다.

AWS SAMCLI업그레이드

Linux에서 AWS SAM CLI를 업그레이드하려면 AWS SAMCLI의 설치의 설치 지침을 따르되, 다음과 같이 설치 명령에 --update 옵션을 추가합니다.

sudo ./sam-installation/install --update

설치 시 사용한 것과 동일한 방법을 통해 AWS SAM CLI를 업그레이드해야 합니다. 패키지 설치 프로그램을 사용하여 AWS SAM CLI를 설치하고 업그레이드하는 것이 좋습니다.

패키지 설치 프로그램을 사용하여 AWS SAM CLI를 업그레이드하려면 최신 패키지 버전을 설치하십시오. 지침은 AWS SAMCLI의 설치 섹션을 잠조하세요.

AWS SAM CLI를 업그레이드하려면 AWS SAM CLI 설치의 Windows 설치 단계를 다시 반복합니다.

AWS SAM CLI 제거

Linux에서 AWS SAM CLI를 제거하려면 다음 명령을 실행하여 symlink 및 설치 디렉터리를 삭제해야 합니다.

  1. symlink 및 설치 경로를 찾습니다.

    • which 명령을 사용하여 symlink를 찾습니다.

      which sam

      출력에는 AWS SAM 바이너리가 있는 경로가 표시됩니다. 예를 들면 다음과 같습니다.

       /usr/local/bin/sam

    • ls 명령을 사용하여 symlink가 가리키는 디렉터리를 찾습니다.

      ls -l /usr/local/bin/sam

      다음 예제에서 설치 디렉터리는 /usr/local/aws-sam-cli입니다.

       lrwxrwxrwx 1 ec2-user ec2-user 49 Oct 22 09:49 /usr/local/bin/sam -> /usr/local/aws-sam-cli/current/bin/sam

  2. symlink를 삭제합니다.

    sudo rm /usr/local/bin/sam

  3. 설치 디렉터리를 삭제합니다.

    sudo rm -rf /usr/local/aws-sam-cli

설치에 사용한 것과 동일한 방법을 사용하여 AWS SAM CLI를 제거합니다. 패키지 설치 프로그램을 사용하여 AWS SAM CLI를 설치하는 것이 좋습니다.

패키지 설치 프로그램을 사용하여 AWS SAM CLI를 설치한 경우 다음 단계에 따라 제거하십시오.

AWS SAMCLI 제거하기

  1. 다음을 수정하고 실행하여 AWS SAM CLI 프로그램을 제거합니다.

    $ sudo rm -rf /path-to/aws-sam-cli

    1. sudo – 사용자에게 AWS SAM CLI 프로그램이 설치된 위치에 대한 쓰기 권한이 있는 경우 sudo는 필요하지 않습니다. 그렇지 않으면 sudo이 필요합니다.

    2. path-to - AWS SAM CLI 프로그램을 설치한 위치의 경로. 기본 위치는 /usr/local입니다.

  2. 다음을 수정하고 실행하여 AWS SAM CLI $PATH을 제거합니다.

    $ sudo rm -rf /path-to-symlink-directory/sam

    1. sudo – 사용자에게 $PATH에 대한 쓰기 권한이 있는 경우에는 sudo은 필요하지 않습니다. 그렇지 않으면 sudo이 필요합니다.

    2. path-to-symlink-directory – 귀하의 $PATH 환경 변수입니다. 기본 위치는 /usr/local/bin입니다.

  3. 다음을 실행하여 AWS SAM CLI가 제거되었는지 확인합니다.

    $ sam --version
command not found: sam

Windows 설정을 사용하여 AWS SAM CLI를 제거하려면 다음 단계를 따르십시오.

  1. 시작 메뉴에서 “프로그램 추가 또는 제거”를 검색합니다.

  2. AWS SAM 명령줄 인터페이스라는 결과 항목을 선택한 다음 제거를 선택하여 제거 프로그램을 작동시킵니다.

  3. AWS SAM CLI를 제거하고자 하는지 의사를 확인합니다.

Homebrew 사용에서 AWS SAMCLI 관리로 전환

Homebrew을 사용해 AWS SAM CLI을 설치 및 업그레이드하는 경우, AWS 지원 방법을 권장합니다. 지원되는 방법으로 전환하려면 다음 지침을 따르십시오.

Homebrew 사용에서 전환하기

  1. Homebrew CLI가 설치된 AWS SAM 제거의 지침에 따라 Homebrew 관리형 버전을 제거합니다.

  2. AWS SAM CLI 설치의 지침에 따라 지원되는 방법을 사용하여 AWS SAM CLI를 설치합니다.

AWS SAMCLI의 nightly build 관리

AWS SAM CLI nightly build를 다운로드 및 설치할 수 있습니다. 여기에는 생산용 버전보다 안정성이 떨어질 수 있는 시험판 버전의 AWS SAM CLI 코드가 포함되어 있습니다. 설치되면 sam-nightly 명령과 함께 자동 빌드를 사용할 수 있습니다. AWS SAM CLI의 생산용 버전과 nightly build 버전을 동시에 설치하여 사용할 수 있습니다.

참고

nightly build에는 시험판 버전의 빌드 이미지가 포함되어 있지 않습니다. 따라서 --use-container 옵션을 사용하여 서버리스 애플리케이션을 빌드할 때는 빌드 이미지의 최신 프로덕션 버전을 사용합니다.

AWS SAMCLI nightly build 설치

AWS SAM CLI nightly build를 설치하려면 다음 지침을 따르십시오.

패키지 설치 프로그램을 사용하여 AWS SAMx86_64 플랫폼에 CLI Linux의 nightly build 버전을 설치할 수 있습니다.

AWS SAMCLI nightly build 설치하기

  1. aws-sam-cli 리포지토리의 sam-cli-nightlyGitHub에서 패키지 설치 프로그램을 다운로드하십시오.

  2. 설치 AWS SAMCLI단계를 따라 자동 빌드 패키지를 설치합니다.

자동 빌드 패키지 설치 프로그램을 사용하여 AWS SAM CLI의 nightly build 버전을 macOS상에 설치할 수 있습니다.

AWS SAMCLI nightly build 설치하기

  1. aws-sam-cli 리포지토리의 sam-cli-nightlyGitHub에서 플랫폼을 위한 패키지 설치 프로그램을 다운로드하십시오.

  2. 설치 AWS SAMCLI단계를 따라 자동 빌드 패키지를 설치합니다.

AWS SAM CLI의 nightly build 버전은 AWS SAM CLI 자동 빌드 다운로드 링크에서 이용할 수 있습니다. Windows에 자동 빌드를 설치하려면 AWS SAM CLI 설치에서와 동일한 단계를 수행하되, nightly build 다운로드 링크를 대신 사용하십시오.

자동 빌드 버전을 설치했는지 확인하려면 sam-nightly --version 명령을 실행합니다. 이 명령의 출력 결과는 1.X.Y.dev<YYYYMMDDHHmm>의 형식으로 표시됩니다. 예를 들면 다음과 같습니다.

SAM CLI, version 1.20.0.dev202103151200

Homebrew에서 패키지 설치 프로그램으로 전환

Homebrew을 사용하여 AWS SAM CLI 자동 빌드를 설치 및 업그레이드하다가 패키지 설치 프로그램 사용으로 전환하려면 다음 단계를 따르십시오.

Homebrew에서 패키지 설치 프로그램으로 전환하기

  1. Homebrew AWS SAM nightly build가 설치된 CLI을 제거합니다.

    $ brew uninstall aws-sam-cli-nightly

  2. 다음을 실행하여 AWS SAM CLI nightly build가 제거되었는지 확인하십시오.

    $ sam-nightly --version
zsh: command not found: sam-nightly

  3. 이전 섹션의 단계에 따라 AWS SAM CLI 자동 빌드를 설치하십시오.

AWS SAM을 이용하여 가상 환경에 CLIpip 설치

네이티브 패키지 설치 프로그램을 사용하여 AWS SAM CLI를 설치하는 것이 좋습니다. pip을 사용해야 한다면, AWS SAM CLI을 가상 환경으로 설치할 것을 권장합니다. 이렇게 하면 설치 환경이 깔끔해지고 오류 발생 시 격리된 환경이 보장됩니다.

참고

2023년 10월 24일자로 AWS SAM CLI가 Python 3.7에 대한 지원을 중단합니다. 자세한 내용은 AWS SAMCLI가 Python 3.7에 대한 지원 중단 을 잠조하세요.

가상 환경에 AWS SAMCLI 설치하기

  1. 선택한 시작 디렉터리를 사용하여 가상 환경을 생성하고 이름을 지정합니다.

    Linux / macOS
    $ mkdir project
$ cd project
$ python3 -m venv venv
    Windows
    > mkdir project
> cd project
> py -3 -m venv venv

  2. 가상 환경 활성화

    Linux / macOS
    $ . venv/bin/activate

    프롬프트가 변경되어 가상 환경이 활성임을 보여줍니다.

    (venv) $
    Windows
    > venv\Scripts\activate

    프롬프트가 변경되어 가상 환경이 활성임을 보여줍니다.

    (venv) >

  3. 가상 환경에 AWS SAM CLI을 설치합니다.

    (venv) $ pip install --upgrade aws-sam-cli

  4. AWS SAM CLI이 올바르게 설치되었는지 확인합니다.

    (venv) $ sam --version
SAM CLI, version 1.94.0

  5. deactivate 명령을 사용하여 가상 환경을 종료할 수 있습니다. 새 세션을 시작할 때마다 환경을 다시 활성화해야 합니다.

AWS SAM로 CLIHomebrew 관리

참고

2023년 9월부터 AWS은 AWS SAM CLI aws/tap/aws-sam-cli을 위한 AWS 관리형 Homebrew 설치관리자 프로그램을 더 이상 유지 관리하지 않습니다. Homebrew을 계속 사용하려면, 커뮤니티 관리형 설치 프로그램(aws-sam-cli)을 사용하실 수 있습니다. 2023년 9월부터 Homebrew를 참조하는 모든 aws/tap/aws-sam-cli 명령이 aws-sam-cli으로 리디렉션됩니다.

지원되는 설치 및 업그레이드 방법을 사용하는 것이 좋습니다.

AWS SAM을 사용하여 CLIHomebrew 설치

참고

이 지침은 커뮤니티 관리형 AWS SAM CLI Homebrew 설치 프로그램을 사용합니다. 추가 지원이 필요하면 homebrew-core 리포지토리를 잠조하세요.

AWS SAMCLI 설치하기

  1. 다음을 실행합니다.

    $ brew install aws-sam-cli

  2. 설치를 확인합니다.

    $ sam --version

    AWS SAM CLI를 성공적으로 설치하면 다음과 같은 출력 결과가 표시됩니다.

    SAM CLI, version 1.94.0

AWS SAM을 사용하여 CLIHomebrew 업그레이드

AWS SAM을 사용하여 CLI Homebrew을 업그레이드하려면, 다음 명령을 실행합니다.

$ brew upgrade aws-sam-cli

Homebrew CLI가 설치된 AWS SAM 제거

AWS SAM을 사용하여 CLI Homebrew가 설치된 경우, 다음 단계에 따라 제거하십시오.

AWS SAM CLI 제거하기

  1. 다음을 실행합니다.

    $ brew uninstall aws-sam-cli

  2. 다음을 실행하여 AWS SAM CLI가 제거되었는지 확인합니다.

    $ sam --version
command not found: sam

커뮤니티 관리형 Homebrew 설치 프로그램으로 전환

AWS 관리형 Homebrew 설치 프로그램(aws/tap/aws-sam-cli)을 사용 중이고 Homebrew를 계속 사용하고 싶다면, 커뮤니티 관리형 Homebrew 설치 프로그램(aws-sam-cli)으로 전환하는 것이 좋습니다.

단일 명령으로 전환하려면 다음을 실행하십시오.

$ brew uninstall aws-sam-cli && brew untap aws/tap && brew cleanup aws/tap && brew update && brew install aws-sam-cli

다음 지침에 따라 각 명령을 개별적으로 실행하십시오.

커뮤니티 관리형 Homebrew 설치 프로그램으로 전환하기

  1. AWS의 Homebrew 관리형 AWS SAM CLI 버전을 제거합니다. 

    $ brew uninstall aws-sam-cli

  2. AWS SAM CLI가 제거되었는지 확인합니다.

    $ which sam
sam not found

  3. AWS 관리형 AWS SAM CLI 탭 제거합니다.

    $ brew untap aws/tap

    다음과 같은 오류가 발생하는 경우 --force 옵션을 추가하고 다시 시도하십시오.

    Error: Refusing to untap aws/tap because it contains the following installed formulae or casks:
aws-sam-cli-nightly

  4. AWS 관리형 설치 프로그램의 캐시된 파일을 제거합니다.

    $ brew cleanup aws/tap

  5. Homebrew 및 모든 공식 업데이트:

    $ brew update

  6. AWS SAM CLI의 커뮤니티 관리형 버전을 설치하십시오. 

    $ brew install aws-sam-cli

  7. AWS SAM CLI의 설치가 성공적인지 확인합니다.

    $ sam --version
SAM CLI, version 1.94.0

문제 해결

AWS SAM CLI의 설치 또는 사용 중에 오류가 발생하는 경우 AWS SAMCLI 문제 해결을 잠조하세요.