AWS SAM CLI의 설치 - AWS Serverless Application Model

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

AWS SAM CLI의 설치

지원되는 운영 체제에 최신 버전의 AWS Serverless Application Model 명령줄 인터페이스 (AWS SAMCLI) 를 설치합니다.

야간 빌드를 업그레이드 AWS SAMCLI, 제거 또는 관리하는 방법을 포함하여 현재 설치된 버전의 관리에 대한 자세한 내용은 을 참조하십시오. AWS SAM CLI 버전 관리

AWS SAM CLI을 처음 설치하시나요?

진행하기 전에 이전 섹션의 모든 사전 요구 사항을 완료하십시오. 여기에는 다음이 포함됩니다.

  1. 계정 등록. AWS

  2. 관리형 IAM 사용자의 생성

  3. 액세스 키 ID 및 보안 액세스 키 생성

  4. 설치 AWS CLI.

  5. AWS 자격 증명 구성.

AWS SAMCLI의 설치

참고

2023년 9월부터 AWS SAMCLI (aws/tap/aws-sam-cli) 의 AWS 관리형 Homebrew 설치 프로그램을 더 이상 유지 관리하지 않습니다. AWS 를 설치 및 관리하는 Homebrew 데 사용하는 경우 다음 옵션을 참조하십시오. AWS SAMCLI

  • Homebrew을 계속 사용하려면 커뮤니티 관리 설치관리자 프로그램을 사용할 수 있습니다. 자세한 내용은 AWS SAM로 CLIHomebrew 관리을 참조하십시오

  • 이 페이지에 설명된 자사 설치 방법 중 하나를 사용하는 것이 좋습니다. 이러한 방법 중 하나를 사용하기 전에 Homebrew에서 전환 을 잠조하세요.

를 AWS SAMCLI 설치하려면 운영 체제의 지침을 따르십시오.

arm64 - command line installer
  1. 선택한 디렉터리에 AWS SAM CLI .zip file을 복사합니다.

  2. (선택 사항) 설치 전에 설치관리자 프로그램의 무결성을 확인할 수 있습니다. 지침은 AWS SAM CLI 설치관리자 프로그램의 무결성 확인: 섹션을 잠조하세요.

  3. 선택한 디렉터리에 설치 파일의 압축을 풉니다. 다음은 sam-installation 하위 디렉토리의 사용을 보여주는 예입니다.

    참고

    운영 체제에 기본 제공 unzip 명령이 없는 경우 이와 동등한 명령을 사용하세요.

    $ unzip aws-sam-cli-linux-arm64.zip -d sam-installation
  4. AWS SAMCLI를 실행하여 실행 install 파일을 설치합니다. 이 실행 파일은 이전 단계에서 사용된 디렉터리에 위치합니다. 다음은 sam-installation 하위 디렉토리의 사용을 보여주는 예입니다.

    $ sudo ./sam-installation/install
  5. 설치를 확인합니다.

    $ sam --version

    성공적으로 설치되었는지 확인하려면 다음과 같은 출력이 표시되지만 괄호 안의 텍스트는 최신 SAM CLI 버전으로 대체됩니다.

     SAM CLI, <latest version>
x86_64 - command line installer
  1. 선택한 디렉터리에 AWS SAM CLI .zip file을 복사합니다.

  2. (선택 사항) 설치 전에 설치관리자 프로그램의 무결성을 확인할 수 있습니다. 지침은 AWS SAM CLI 설치관리자 프로그램의 무결성 확인: 섹션을 잠조하세요.

  3. 선택한 디렉터리에 설치 파일의 압축을 풉니다. 다음은 sam-installation 하위 디렉토리의 사용을 보여주는 예입니다.

    참고

    운영 체제에 기본 제공 unzip 명령이 없는 경우 이와 동등한 명령을 사용하세요.

    $ unzip aws-sam-cli-linux-x86_64.zip -d sam-installation
  4. AWS SAMCLI를 실행하여 실행 install 파일을 설치합니다. 이 실행 파일은 이전 단계에서 사용된 디렉터리에 위치합니다. 다음은 sam-installation 하위 디렉토리의 사용을 보여주는 예입니다.

    $ sudo ./sam-installation/install
  5. 설치를 확인합니다.

    $ sam --version

    성공적인 설치를 확인하려면 괄호로 묶은 다음 텍스트를 사용 가능한 최신 버전으로 대체하는 출력이 표시되어야 합니다.

     SAM CLI, <latest version>

해당 패키지 설치관리자 프로그램을 사용하여 AWS SAMCLI를 설치합니다.

참고

패키지 설치관리자 프로그램은 x86_64 및 arm64 옵션으로 제공됩니다. 사용 중인 Mac 하드웨어에 맞는 패키지를 선택하세요.

  • x86_64 – Intel 프로세서를 실행하는 Macs에 사용합니다.

  • arm64— Apple 실리콘을 실행하는 Macs에 사용합니다.

자세한 내용은 Apple 실리콘이 탑재된 Mac 컴퓨터를 참조하세요.

패키지 설치관리자 프로그램 사용

패키지 설치관리자 프로그램에는 다음 두 가지 설치 방법 중에서 선택할 수 있습니다.

  1. GUI

  2. 명령줄

모든 사용자를 위해 설치하거나 현재 사용자만을 위해 설치할 수 있습니다. 모든 사용자를 대상으로 설치하려면 수퍼유저 인증이 필요합니다.

설치 단계

다음 옵션 중 하나를 사용하여 AWS SAM CLI를 설치합니다.

GUI - All users
패키지 설치관리자 프로그램 다운로드하기
참고

이전에 Homebrew 혹은 pip를 통해 AWS SAMCLI를 설치한 경우, 이를 먼저 제거해야 합니다. 지침은 AWS SAM CLI 제거 섹션을 잠조하세요.

패키지 설치관리자 프로그램 확인하기(선택 사항)
AWS SAM CLI 설치하기
  1. 다운로드한 파일을 실행하고 화면에 나타난 지침에 따라 소개, Read Me라이선스 단계를 계속 진행합니다.

  2. 대상 선택에서 이 컴퓨터의 모든 사용자를 위한 설치를 선택합니다.

  3. 설치 유형에서 AWS SAMCLI을 설치할 위치를 선택하고 설치를 누릅니다. 권장되는 기본 위치는 /usr/local/aws-sam-cli입니다.

    참고

    sam 명령으로 AWS SAMCLI를 호출하기 위해 설치관리자 프로그램은 /usr/local/bin/sam/usr/local/aws-sam-cli/sam 또는 귀하가 선택한 설치 폴더 중 하나 간에 심링크를 자동으로 생성합니다.

  4. AWS SAMCLI가 설치하면 설치 성공 메시지가 표시됩니다. 닫기를 누릅니다.

성공적으로 설치되었는지 확인하려면
  • 다음을 실행하여 AWS SAMCLI가 제대로 설치되었고 심링크가 구성되어 있는지 확인합니다.

    $ which sam /usr/local/bin/sam $ sam --version SAM CLI, <latest version>
GUI - Current user
패키지 설치관리자 프로그램 다운로드하기
참고

이전에 Homebrew 혹은 pip를 통해 AWS SAMCLI를 설치한 경우, 이를 먼저 제거해야 합니다. 지침은 AWS SAM CLI 제거 섹션을 잠조하세요.

패키지 설치관리자 프로그램 확인하기(선택 사항)
AWS SAM CLI 설치하기
  1. 다운로드한 파일을 실행하고 화면에 나타난 지침에 따라 소개, Read Me라이선스 단계를 계속 진행합니다.

  2. 대상 선택에서 나만을 위한 설치를 선택합니다. 이 옵션이 표시되지 않으면 다음 단계를 진행합니다.

  3. 설치 유형에서 다음을 수행합니다.

    1. AWS SAMCLI를 설치할 위치를 선택합니다. 기본 위치는 /usr/local/aws-sam-cli입니다. 쓰기 권한이 있는 위치를 선택합니다. 설치 위치를 변경하려면 로컬을 선택하고 위치를 선택합니다. 완료되면 계속을 누르십시오.

    2. 이전 단계에서 나를 위한 설치를 선택하는 옵션이 표시되지 않은 경우 설치 위치 변경 > 내게만 설치를 선택하고 계속을 누르십시오.

    3. 설치를 누릅니다.

  4. AWS SAMCLI가 설치하면 설치 성공 메시지가 표시됩니다. 닫기를 누릅니다.

심링크 생성
  • sam 명령으로 AWS SAMCLI를 호출하려면 AWS SAMCLI프로그램과 귀하의 $PATH 사이에 심링크를 수동으로 만들어야 합니다. 다음 명령을 수정하고 실행하여 심링크를 생성합니다.

    $ sudo ln -s /path-to/aws-sam-cli/sam /path-to-symlink-directory/sam
    • sudo – 사용자에게 $PATH에 대한 쓰기 권한이 있는 경우에는 sudo은 필요하지 않습니다. 그렇지 않으면 sudo이 필요합니다.

    • path-to - AWS SAMCLI 프로그램을 설치한 위치의 경로. 예를 들어 /Users/myUser/Desktop입니다.

    • path-to-symlink-directory— 사용자 $PATH 환경 변수. 기본 위치는 /usr/local/bin입니다.

성공적으로 설치되었는지 확인하려면
  • 다음을 실행하여 AWS SAMCLI가 제대로 설치되었고 심링크가 구성되어 있는지 확인합니다.

    $ which sam /usr/local/bin/sam $ sam --version SAM CLI, <latest version>
Command line - All users
패키지 설치관리자 프로그램 다운로드하기
참고

이전에 Homebrew 혹은 pip를 통해 AWS SAMCLI를 설치한 경우, 이를 먼저 제거해야 합니다. 지침은 AWS SAM CLI 제거 섹션을 잠조하세요.

패키지 설치관리자 프로그램 확인하기(선택 사항)
AWS SAM CLI 설치하기
  • 설치 스크립트를 변경하고 실행합니다.

    $ sudo installer -pkg path-to-pkg-installer/name-of-pkg-installer -target / installer: Package name is AWS SAM CLI installer: Upgrading at base path / installer: The upgrade was successful.
    참고

    /usr/local/bin/sam /usr/local/aws-sam-cli/sam sam명령으로 AWS SAMCLI를 호출하려면, 설치관리자 프로그램은 와 간에 심링크를 자동으로 생성합니다.

성공적으로 설치되었는지 확인하려면
  • 다음을 실행하여 AWS SAMCLI가 제대로 설치되었고 심링크가 구성되어 있는지 확인합니다.

    $ which sam /usr/local/bin/sam $ sam --version SAM CLI, <latest version>
Command line - Current user
패키지 설치관리자 프로그램 다운로드하기
참고

이전에 Homebrew 혹은 pip를 통해 AWS SAMCLI를 설치한 경우, 이를 먼저 제거해야 합니다. 지침은 AWS SAM CLI 제거 섹션을 잠조하세요.

패키지 설치관리자 프로그램 확인하기(선택 사항)
AWS SAM CLI 설치하기
  1. 귀하에게 쓰기 권한이 있는 설치 디렉터리를 결정하십시오. 그런 다음 템플릿을 사용하여 xml 파일을 만들고 설치 디렉토리를 반영하도록 수정하십시오. 디렉토리는 이미 존재해야 합니다.

    예를 /Users/myUser/Desktop 들어 path-to-my-directory로 바꾸면 aws-sam-cli 프로그램 폴더가 거기에 설치됩니다.

    <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <array> <dict> <key>choiceAttribute</key> <string>customLocation</string> <key>attributeSetting</key> <string>path-to-my-directory</string> <key>choiceIdentifier</key> <string>default</string> </dict> </array> </plist>
  2. xml파일을 저장하고 다음을 실행하여 파일이 유효한지 확인합니다.

    $ installer -pkg path-to-pkg-installer \ -target CurrentUserHomeDirectory \ -showChoicesAfterApplyingChangesXML path-to-your-xml-file

    출력 결과는 AWS SAMCLI 프로그램에 적용할 기본 설정이 표시되어야 합니다.

  3. 다음을 실행하여 설치합니다 AWS SAMCLI.

    $ installer -pkg path-to-pkg-installer \ -target CurrentUserHomeDirectory \ -applyChoiceChangesXML path-to-your-xml-file # Example output installer: Package name is AWS SAM CLI installer: choices changes file 'path-to-your-xml-file' applied installer: Upgrading at base path base-path-of-xml-file installer: The upgrade was successful.
심링크 생성
  • sam 명령으로 AWS SAMCLI를 호출하려면 AWS SAMCLI프로그램과 귀하의 $PATH 사이에 심링크를 수동으로 만들어야 합니다. 다음 명령을 수정하고 실행하여 심링크를 생성합니다.

    $ sudo ln -s /path-to/aws-sam-cli/sam /path-to-symlink-directory/sam
    • sudo – 사용자에게 $PATH에 대한 쓰기 권한이 있는 경우에는 sudo은 필요하지 않습니다. 그렇지 않으면 sudo이 필요합니다.

    • path-to - AWS SAMCLI 프로그램을 설치한 위치의 경로. 예를 들어 /Users/myUser/Desktop입니다.

    • path-to-symlink-directory— 사용자 $PATH 환경 변수. 기본 위치는 /usr/local/bin입니다.

성공적으로 설치되었는지 확인하려면
  • 다음을 실행하여 AWS SAMCLI가 제대로 설치되었고 심링크가 구성되어 있는지 확인합니다.

    $ which sam /usr/local/bin/sam $ sam --version SAM CLI, <latest version>

Windows 설치관리자 프로그램 (MSI) 파일은 Windows 운영 체제의 패키지 설치 프로그램 파일입니다.

MSI 파일을 사용하여 AWS SAMCLI를 설치하려면 다음 단계를 따르십시오.

  1. AWS SAMCLI 64비트를 다운로드하십시오.

    참고

    32비트 버전의 Windows를 사용하는 경우 32비트 AWS SAM에 CLIWindows 설치을 잠조하세요.

  2. (선택 사항) 설치 전에 설치관리자 프로그램의 무결성을 확인할 수 있습니다. 지침은 AWS SAM CLI 설치관리자 프로그램의 무결성 확인: 섹션을 잠조하세요.

  3. 설치를 확인합니다.

    설치를 완료한 후 새 명령 프롬프트나 PowerShell 프롬프트를 열어 확인합니다. sam을 명령줄에서 호출할 수 있어야 합니다.

    sam --version

    설치가 완료되면 다음과 같은 출력이 표시됩니다. AWS SAMCLI

    SAM CLI, <latest version>
  4. 긴 경로를 활성화합니다(Windows 10 이상만 해당).

    중요

    Windows 최대 경로 제한을 초과하는 파일 경로와 상호 작용할 AWS SAMCLI 수 있습니다. Windows 10 sam init MAX_PATH 제한으로 인해 실행 시 오류가 발생할 수 있습니다. 이 문제를 해결하기 위해서는 새로운 긴 경로 동작을 구성해야 합니다.

    긴 경로를 활성화하려면 Microsoft Windows 앱 개발 설명서Windows 10, 버전 1607 이상에서 긴 경로 사용 활성화를 잠조하세요.

  5. Git을 설치합니다.

    sam init 명령을 사용하여 샘플 애플리케이션을 다운로드하려면 Git도 설치해야 합니다. 자세한 내용은 PIP 설치를 잠조하세요

문제 해결

설치 중에 문제가 발생하는 AWS SAMCLI 경우 을 참조하십시오설치 오류.

다음 단계

AWS SAMCLI에 대한 자세한 내용과 자체 서버리스 애플리케이션 구축을 시작하려면 다음을 잠조하세요.