sam local start-api - AWS Serverless Application Model
사용량옵션

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

sam local start-api

이 페이지는 AWS Serverless Application Model 명령줄 인터페이스 (AWS SAMCLI) sam local start-api 하위 명령에 대한 참조 정보를 제공합니다.

sam local start-api하위 명령은 AWS Lambda 함수를 로컬에서 실행하여 로컬 HTTP 서버 호스트를 통해 테스트합니다.

사용량

$ sam local start-api <options>

옵션

--add-host LIST

호스트 이름을 IP 주소 매핑을 Docker 컨테이너의 호스트 파일에 전달합니다. 이 매개변수는 여러 번 전달될 수 있습니다.

예제: --add-host example.com:127.0.0.1

--beta-features | --no-beta-features

베타 기능을 허용 또는 거부합니다.

--config-env TEXT

사용할 구성 파일의 기본 매개변수 값을 지정하는 환경 이름입니다. 기본값은 “기본값”입니다. 구성 파일에 대한 자세한 내용은 AWS SAMCLI구성 파일 섹션을 참조하세요.

--config-file PATH

사용할 기본 매개변수 값이 들어 있는 구성 파일의 경로 및 파일 이름입니다. 기본값은 프로젝트 디렉터리의 루트에 있는 “samconfig.toml”입니다. 구성 파일에 대한 자세한 내용은 AWS SAMCLI구성 파일 섹션을 참조하세요.

--container-env-vars

선택 사항입니다. 로컬 디버깅 시 이미지 컨테이너에 환경 변수를 전달합니다.

--container-host TEXT

로컬로 에뮬레이션된 Lambda 컨테이너의 호스트입니다. 기본 값은 localhost입니다. macOS의 Docker 컨테이너에서 AWS SAMCLI를 실행하려는 경우 host.docker.internal을 지정할 수 있습니다. 와 다른 AWS SAMCLI 호스트에서 컨테이너를 실행하려는 경우 원격 호스트의 IP 주소를 지정할 수 있습니다.

--container-host-interface TEXT

컨테이너 포트가 바인딩해야 하는 호스트 네트워크 인터페이스의 IP 주소입니다. 기본 값은 127.0.0.1입니다. 모든 인터페이스에 바인딩하는 데 0.0.0.0을 사용합니다.

--debug

디버그 로깅을 켜서 AWS SAMCLI 에 의해 생성된 디버그 메시지를 인쇄하고 타임스탬프를 표시합니다.

--debug-args TEXT

디버거에 전달할 추가 인수입니다.

--debug-function

선택 사항입니다. --warm-containers이 지정된 시점에 디버그 옵션을 적용할 Lambda 함수를 지정합니다. 이 매개변수는--debug-port, --debugger-path 및 --debug-args에 적용됩니다.

--debug-port, -d TEXT

지정되면 Lambda 함수 컨테이너를 디버그 모드에서 시작하고 이 포트를 로컬 호스트에 노출합니다.

--debugger-path TEXT

Lambda 컨테이너에 마운트할 디버거의 호스트 경로입니다.

--docker-network TEXT

Lambda Docker 컨테이너가 연결해야 하는 기존 Docker 네트워크의 이름 또는 ID와 기본 브리지 네트워크입니다. 이것을 지정하지 않으면 Lambda 컨테이너는 기본 브리지 Docker 네트워크에만 연결됩니다.

--docker-volume-basedir, -v TEXT

AWS SAM 파일이 있는 기본 디렉터리의 위치. Docker가 원격 시스템에서 실행 중인 경우 AWS SAM 파일이 있는 경로를 Docker 시스템에 마운트하고 이 값을 원격 시스템에 맞게 수정해야 합니다.

--env-vars, -n PATH

Lambda 함수의 환경 변수의 값을 포함하는 JSON 파일입니다.

--force-image-build

레이어를 사용하여 함수를 호출하는 데 사용되는 이미지를 다시 AWS SAM CLI 빌드해야 하는지 여부를 지정합니다.

--help

이 메시지를 표시한 후 종료합니다.

--hook-name TEXT

AWS SAMCLI 기능을 확장하는 데 사용되는 후크의 이름입니다.

허용되는 값: terraform입니다.

--host TEXT

바인딩할 로컬 호스트 이름 또는 IP 주소(기본값: ‘127.0.0.1’)입니다.

--invoke-image TEXT

Lambda 함수에 사용하려는 컨테이너 이미지의 URI입니다. 기본적으로 Amazon ECR Public에서 컨테이너 이미지를 AWS SAM 가져옵니다. 다른 위치에서 이미지를 가져오려면 이 옵션을 사용합니다.

이 옵션은 여러 번 지정할 수 있습니다. 이 옵션의 각 인스턴스는 문자열 또는 키-값 쌍을 사용할 수 있습니다. 문자열을 지정하는 경우 이는 애플리케이션의 모든 함수에 사용할 컨테이너 이미지의 URI입니다. 예를 들어 sam local start-api --invoke-image public.ecr.aws/sam/emu-python3.8입니다. 키-값 쌍을 지정하는 경우 키는 리소스 이름이고 값은 해당 리소스에 사용할 컨테이너 이미지의 URI입니다. 예를 들어 sam local start-api --invoke-image public.ecr.aws/sam/emu-python3.8 --invoke-image Function1=amazon/aws-sam-cli-emulation-image-python3.8 입니다. 키-값 쌍을 사용하면 리소스마다 다른 컨테이너 이미지를 지정할 수 있습니다.

--layer-cache-basedir DIRECTORY

템플릿에서 사용하는 레이어가 다운로드되는 위치를 기준으로 지정합니다.

--log-file, -l TEXT

런타임 로그를 전송할 로그 파일입니다.

--parameter-overrides

선택 사항입니다. 키-값 쌍으로 인코딩된 AWS CloudFormation 파라미터 오버라이드가 포함된 문자열입니다. AWS CLI—와 같은 형식을 사용합니다 (예: '=, ParameterKey =KeyPairName, =t1.micro'). ParameterValue MyKey ParameterKey InstanceType ParameterValue

--port, -p INTEGER

수신할 로컬 포트 번호(기본값: ‘3000’)입니다.

--profile TEXT

자격 증명을 가져오는 자격 증명 파일의 특정 프로필 AWS

--region TEXT

배포할 AWS 지역. 예를 들어 us-east-1입니다.

--save-params

명령줄에서 제공하는 파라미터를 AWS SAM 구성 파일에 저장합니다.

--shutdown

종료 동작의 확장 처리를 테스트하기 위하여 간접 호출 완료 이후라도 종료 이벤트를 에뮬레이션합니다.

--skip-prepare-infra

인프라를 변경하지 않은 경우 준비 단계를 건너뜁니다. --hook-name 옵션과 함께 사용합니다.

--skip-pull-image

CLI가 Lambda 런타임에 대한 최신 도커 이미지를 가져오는 단계를 건너뛸지를 지정합니다.

--ssl-cert-file PATH

SSL 인증서 파일 경로 (기본값: 없음) 이 옵션을 사용하는 경우 --ssl-key-file 옵션도 사용해야 합니다.

--ssl-key-file PATH

SSL 키 파일 경로 (기본값: 없음) 이 옵션을 사용하는 경우 --ssl-cert-file 옵션도 사용해야 합니다.

--static-dir, -s TEXT

이 디렉터리에 있는 모든 정적 자산 (예: CSS/ JavaScript /HTML) 파일은 에 표시됩니다. /

--template, -t PATH

템플릿 AWS SAM 파일.

참고

이 옵션을 지정하는 경우 템플릿과 템플릿이 가리키는 로컬 리소스만 AWS SAM 로드합니다.

--terraform-plan-file

Terraform AWS SAM를 CLI와 사용할 때 로컬 Terraform Cloud 계획 파일의 상대적 또는 절대적 경로입니다. 이 옵션을 사용하려면 --hook-name을 terraform로 설정해야 합니다.

--warm-containers [EAGER | LAZY]

선택 사항입니다. AWS SAMCLI가 각 함수의 컨테이너를 관리하는 방법을 지정합니다.

사용 가능한 옵션은 다음 두 가지입니다.

   EAGER: 모든 함수의 컨테이너는 시작 시 로드되며 호출과 호출 사이에도 유지됩니다.

   LAZY: 컨테이너는 각 함수를 처음 호출할 때만 로드됩니다. 이러한 컨테이너들은 추가 호출 시에도 계속 유지됩니다.