AWS SAM CLI 설치 - AWS Serverless Application Model

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

AWS SAM CLI 설치

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

야간 빌드를 업그레이드, 제거 또는 관리하는 방법을 포함하여 현재 설치된 버전의AWS SAM CLI를 관리하는 방법을 알아보려면 을 참조하십시오AWS SAMCLI 버전 관리.

중요

계속하기 전에 이전 섹션의 모든 사전 요구 사항을 완료하십시오.

AWS SAM CLI 설치

AWS SAMCLI를 설치하려면 운영 체제에 대한 지침을 따르세요.

x86_64 - command line installer
  1. 선택한 디렉터리에 AWS SAMCLI .zip 파일을 다운로드합니다.

  2. 다음 명령을 사용하여 해시 값을 생성하여 다운로드한 설치 관리자 파일의 무결성 및 신뢰성 확인

    sha256sum aws-sam-cli-linux-x86_64.zip

    출력은 다음 예시와 같은 형식이어야 합니다.

     <64-character SHA256 hash value> aws-sam-cli-linux-x86_64.zip

    의 CLI 릴리스 노트에 있는 64자 SHA-256 해시 값을 원하는AWS SAM CLI 버전의 해시 값과 비교하십시오 GitHub.AWS SAM

  3. 설치 파일을sam-installation/ 하위 디렉토리에 압축 해제합니다.

    참고

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

    unzip aws-sam-cli-linux-x86_64.zip -d sam-installation
  4. AWS SAM CLI를 설치합니다.

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

    sam --version

    설치가 완료하면 다음과 같은 결과가 표시됩니다.

     SAM CLI, version 1.58.0
ARM - command line installer
  1. AWS SAMCLI를 설치하는pip 데 사용합니다.

    pip install aws-sam-cli
  2. 설치를 확인합니다.

    sam --version

    설치가 완료하면 다음과 같은 결과가 표시됩니다.

     SAM CLI, version 1.58.0
Homebrew
중요

LinuxHomebrew 시스템에 설치되어 있어야 합니다. 설치에 대해서는instructions 를 참조하십시오AWS SAMCLI와 함께Homebrew 사용하도록 설치.

을 사용하여AWS SAM CLI를Homebrew 설치하려면 다음 명령을 실행합니다.

brew tap aws/tap brew install aws-sam-cli

설치를 확인합니다.

sam --version

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

SAM CLI, version 1.58.0

해당 패키지 설치 프로그램을 사용하거나 를 통해AWS SAM CLI를 설치합니다Homebrew.

패키지 설치 관리자 사용

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

  1. GUI

  2. 명령줄

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

설치 단계

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

GUI - All users
패키지 설치 관리자
참고

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

  1. 설치를 시작하려면 원하는 디렉터리에pkg macOS를 다운로드하세요.

  2. 다음 명령을 사용하여 해시 값을 생성하여 다운로드한 설치 관리자의 무결성 및 신뢰성 확인

    $ shasum -a 256 path-to-pkg-installer/name-of-pkg-installer # Examples $ shasum -a 256 /Users/myUser/Downloads/aws-sam-cli-macos-arm64.pkg $ shasum -a 256 /Users/myUser/Downloads/aws-sam-cli-macos-x86_64.pkg

    64자 SHA-256 해시 값을 AWS SAMCLI 릴리스 노트GitHub 리포지토리의 해당 값과 비교하십시오.

AWS SAMCLI를 설치합니다.
  1. 다운로드한 파일을 실행하고 화면의 지침에 따라 소개, Read MeLicense 단계를 계속 진행하십시오.

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

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

    참고

    sam명령으로AWS SAM CLI를 호출하기 위해 설치 프로그램은 선택한 설치/usr/local/bin/sam 폴더와 둘 중 하나/usr/local/aws-sam-cli/sam 또는 선택한 설치 폴더 사이에 심볼릭 링크를 자동으로 생성합니다.

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

설치 확인
  • 다음을 실행하여AWS SAM CLI가 제대로 설치되었고 심볼릭 링크가 구성되었는지 확인합니다.

    $ which sam /usr/local/bin/sam $ sam --version SAM CLI, version 1.66.0
GUI - Current user
패키지 설치 관리자
참고

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

  1. 설치를 시작하려면 원하는 디렉터리에pkg macOS를 다운로드하세요.

  2. 다음 명령을 사용하여 해시 값을 생성하여 다운로드한 설치 관리자의 무결성 및 신뢰성 확인

    $ shasum -a 256 path-to-pkg-installer/name-of-pkg-installer # Examples $ shasum -a 256 /Users/myUser/Downloads/aws-sam-cli-macos-arm64.pkg $ shasum -a 256 /Users/myUser/Downloads/aws-sam-cli-macos-x86_64.pkg

    64자 SHA-256 해시 값을 AWS SAMCLI 릴리스 노트GitHub 리포지토리의 해당 값과 비교하십시오.

AWS SAMCLI를 설치합니다.
  1. 다운로드한 파일을 실행하고 화면의 지침에 따라 소개, Read MeLicense 단계를 계속 진행하십시오.

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

  3. 설치 유형에서 다음을 수행하십시오.

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

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

    3. 설치를 누릅니다.

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

심볼릭 링크 만들기
  • sam명령을 사용하여 CLI를 호출하려면AWS SAMAWS SAM CLI 프로그램과 사용자 간에 심볼릭 링크를 수동으로 만들어야$PATH 합니다. 다음 명령을 수정하고 실행하여 심볼릭 링크를 만듭니다.

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

    • path-to —AWS SAM CLI 프로그램을 설치한 경로입니다. 예: /Users/myUser/Desktop.

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

설치 확인
  • 다음을 실행하여AWS SAM CLI가 제대로 설치되었고 심볼릭 링크가 구성되었는지 확인합니다.

    $ which sam /usr/local/bin/sam $ sam --version SAM CLI, version 1.66.0
Command line - All users
패키지 설치 관리자
참고

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

  1. 설치를 시작하려면 원하는 디렉터리에pkg macOS를 다운로드하세요.

  2. 다음 명령을 사용하여 해시 값을 생성하여 다운로드한 설치 관리자의 무결성 및 신뢰성 확인

    $ shasum -a 256 path-to-pkg-installer/name-of-pkg-installer # Examples $ shasum -a 256 /Users/myUser/Downloads/aws-sam-cli-macos-arm64.pkg $ shasum -a 256 /Users/myUser/Downloads/aws-sam-cli-macos-x86_64.pkg

    64자 SHA-256 해시 값을 AWS SAMCLI 릴리스 노트GitHub 리포지토리의 해당 값과 비교하십시오.

AWS SAMCLI를 설치합니다.
  • 설치 스크립트 수정 및 실행:

    $ 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.
    참고

    sam명령으로AWS SAM CLI를 호출하기 위해 설치 프로그램은/usr/local/bin/sam 와 사이에 심볼릭 링크를 자동으로 생성합니다/usr/local/aws-sam-cli/sam.

설치 확인
  • 다음을 실행하여AWS SAM CLI가 제대로 설치되었고 심볼릭 링크가 구성되었는지 확인합니다.

    $ which sam /usr/local/bin/sam $ sam --version SAM CLI, version 1.66.0
Command line - Current user
패키지 설치 관리자
참고

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

  1. 설치를 시작하려면 원하는 디렉터리에pkg macOS를 다운로드하세요.

  2. 다음 명령을 사용하여 해시 값을 생성하여 다운로드한 설치 관리자의 무결성 및 신뢰성 확인

    $ shasum -a 256 path-to-pkg-installer/name-of-pkg-installer # Examples $ shasum -a 256 /Users/myUser/Downloads/aws-sam-cli-macos-arm64.pkg $ shasum -a 256 /Users/myUser/Downloads/aws-sam-cli-macos-x86_64.pkg

    64자 SHA-256 해시 값을 AWS SAMCLI 릴리스 노트GitHub 리포지토리의 해당 값과 비교하십시오.

AWS SAMCLI를 설치합니다.
  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 SAM CLI 프로그램에 적용할 기본 설정이 표시되어야 합니다.

  3. 다음을 실행하여AWS SAM CLI를 설치합니다.

    $ 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명령을 사용하여 CLI를 호출하려면AWS SAMAWS SAM CLI 프로그램과 사용자 간에 심볼릭 링크를 수동으로 만들어야$PATH 합니다. 다음 명령을 수정하고 실행하여 심볼릭 링크를 만듭니다.

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

    • path-to —AWS SAM CLI 프로그램을 설치한 경로입니다. 예: /Users/myUser/Desktop.

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

설치 확인
  • 다음을 실행하여AWS SAM CLI가 제대로 설치되었고 심볼릭 링크가 구성되었는지 확인합니다.

    $ which sam /usr/local/bin/sam $ sam --version SAM CLI, version 1.66.0
Homebrew
중요

Homebrew컴퓨터에 설치되어 있어야 합니다. 설치 지침은 을 참조하십시오AWS SAMCLI와 함께Homebrew 사용하도록 설치.

다음 단계에 따라Homebrew 다음을 사용하여AWS SAM CLI를 설치합니다.

brew tap aws/tap brew install aws-sam-cli

설치를 확인합니다.

sam --version

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

SAM CLI, version 1.58.0

윈도우 인스톨러 (MSI) 파일은 윈도우 운영 체제의 패키지 인스톨러 파일입니다.

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

  1. AWS SAMCLI 64비트를 설치합니다.

    참고

    32비트 버전의 Windows를 사용하는 경우 을 참조하십시오32비트 Windows 컴퓨터에AWS SAM CLI 설치.

  2. 설치를 확인합니다.

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

    sam --version

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

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

    중요

    AWS SAMCLI 앱 템플릿 리포지토리에는 Windows 10sam initMAX_PATH 제한으로 인해 실행 시 오류가 발생할 수 있는 긴 파일 경로가 포함되어 있습니다. 이 문제를 해결하려면 새 긴 경로 동작을 구성해야 합니다.

    긴 경로를 활성화하려면 Microsoft Windows 앱 개발 문서에서 Windows 10, 버전 1607 및 이후 버전에서 긴 경로 활성화를 참조하십시오.

  4. Git를 설치합니다.

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

문제 해결

AWS SAMCLI를 설치하는 동안 문제가 발생하는 경우 을 참조하십시오설치 오류 문제 해결.

다음 단계

AWS SAMCLI에 대해 자세히 알아보고 자체 서버리스 애플리케이션 구축을 시작하려면 다음을 참조하세요.