sam build

선택 사항. AWS SAM 템플릿에 선언된 단일 리소스를 빌드 AWS SAM 하도록 지시합니다. 지정된 리소스의 빌드 아티팩트는 워크플로의 후속 명령(예: sam package 및 sam deploy)에 사용할 수 있는 유일한 아티팩트입니다.

이 디렉터리에 대해 함수 또는 계층의 소스 코드에 대한 상대 경로를 확인합니다. 소스 코드 폴더의 상대 경로를 확인하는 방법을 변경하려면 이 옵션을 사용하십시오. 기본적으로 상대 경로는 AWS SAM 템플릿 위치를 기준으로 확인됩니다.

이 옵션은 구축 중인 루트 애플리케이션이나 스택의 리소스 외에도 중첩된 애플리케이션 또는 스택에도 적용됩니다.

이 옵션은 다음 리소스 유형 및 속성에 적용됩니다.

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

구축된 아티팩트가 저장되는 디렉터리의 경로입니다. 이 옵션을 사용하면 이 디렉터리와 모든 내용이 제거됩니다.

구축을 위해 가져오려는 컨테이너 이미지의 URI입니다. 기본 사항으로 AWS SAM 은 Amazon ECR Public로부터 컨테이너 이미지를 가져옵니다. 다른 위치에서 이미지를 가져오려면 이 옵션을 사용합니다.

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

이 옵션은 --use-container 옵션이 지정된 경우에만 적용되며, 그렇지 않으면 오류가 발생합니다.

소스 폴더에서 프로젝트를 직접 빌드하기 위한 --build-in-source를 제공합니다.

--build-in-source 옵션은 다음과 같은 런타임과 빌드 메서드를 지원합니다.

--build-in-source 옵션은 다음 옵션과 호환되지 않습니다.

기본값: --no-build-in-source

캐시된 빌드를 활성화 또는 비활성화합니다. 이전 builds. AWS SAM evaluates에서 변경되지 않은 빌드 아티팩트를 재사용하려면이 옵션을 사용합니다. 기본적으로 빌드는 캐시되지 않습니다. 이 --no-cached 옵션을 간접 호출하면 samconfig.toml의 cached = true 설정을 재정의합니다.

--cached이 지정된 경우 캐시 아티팩트가 저장되는 디렉터리입니다. 기본 캐시 디렉터리는 .aws-sam/cache입니다.

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

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

빌드 컨테이너에 전달할 환경 변수입니다. 이 옵션은 여러 번 지정할 수 있습니다. 이 옵션의 각 인스턴스는 키-값 쌍을 사용합니다. 여기서 키는 리소스 및 환경 변수이고 값은 환경 변수의 값입니다. 예를 들어 --container-env-var Function1.GITHUB_TOKEN=TOKEN1 --container-env-var Function2.GITHUB_TOKEN=TOKEN2입니다.

이 옵션은 --use-container 옵션이 지정된 경우에만 적용되며, 그렇지 않으면 오류가 발생합니다.

컨테이너 환경 변수 값이 포함된 JSON 파일의 경로 및 파일 이름입니다. 컨테이너 환경 변수 구성에 대한 자세한 내용은 컨테이너 환경 변수 파일 섹션을 참조하세요.

이 옵션은 --use-container 옵션이 지정된 경우에만 적용되며, 그렇지 않으면 오류가 발생합니다.

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

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

sam build에서 제외할 리소스의 이름입니다. 예를 들어 템플릿에 Function1, Function2, Function3이 포함되어 있고 sam build --exclude Function2를 실행하면, Function1 및 Function3만 구축됩니다.

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

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

허용되는 값: terraform.

기본값 대신 사용할 사용자 지정 종속성 매니페스트 파일(예: package.json) 의 경로입니다.

AWS SAM CLI이(가) 빌드하거나 간접 호출할 파일에 존재하는 심볼릭 링크를 항상 마운트하도록 보장합니다. 이는 최상위 디렉터리(즉, 함수의 루트에 직접 있는 심볼릭 링크)에만 적용됩니다. 기본적으로, NodeJS에서 node_modules을(를) 위해 build-in-source을(를) 사용하는 데 필요한 경우를 제외하고 심볼릭 링크는 마운트되지 않습니다.

IDE 툴킷이 기본 동작을 설정하는 데 사용할 수 있는 옵션입니다. sam build --no-use-container을(를) 사용하여 Docker 컨테이너 대신 로컬 시스템에서 빌드를 실행할 수도 있습니다.

명령 출력의 형식:

--output json를 AWS SAM CLI 지정하면 명령이 완료된 후가 단일 JSON 객체를 인쇄합니다. 성공 시이 객체에는 빌드 상태, 빌드 디렉터리, 템플릿 파일 및 빌드된 리소스 목록과 같은 필드가 포함됩니다. 실패 시 무엇이 잘못되었는지 설명하는 error 객체가 포함됩니다.

병렬 빌드를 활성화합니다. AWS SAM 템플릿의 함수와 계층을 병렬로 빌드하려면이 옵션을 사용합니다. 기본적으로 함수와 계층은 순서대로 작성됩니다.

(선택 사항) 키-값 페어로 인코딩된 CloudFormation 파라미터 재정의가 포함된 문자열입니다. AWS Command Line Interface ()와 동일한 형식을 사용합니다AWS CLI. 예를 들어 ‘ParameterKey=KeyPairName, ParameterValue=MyKey ParameterKey=InstanceType, ParameterValue=t1.micro‘입니다. 이 옵션은 --hook-name과 호환되지 않습니다.

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

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

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

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

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

AWS SAM 템플릿 파일의 경로 및 파일 이름입니다[default: template.[yaml|yml]]. 이 옵션은 --hook-name과 호환되지 않습니다.

Terraform 구성 파일 또는 함수 소스 코드가 들어 있는 최상위 디렉터리의 상대적 또는 절대적 경로입니다. 이러한 파일이 Terraform 루트 모듈이 들어 있는 디렉터리 외부에 있는 경우, 이 옵션을 사용하여 절대적 또는 상대적 경로를 지정하십시오. 이 옵션을 사용하려면 --hook-name을 terraform로 설정해야 합니다.

컨테이너 이미지 빌드용 BuildKit 플러그인을 사용하여를 활성화하거나 비활성화합니다. 이렇게 하면 Finch 또는 Docker가 사용됩니다CLIs. 기본적으로 빌드는 SDK의 레거시 빌더를 사용합니다. 이 --no-use-buildkit 옵션을 간접 호출하면 samconfig.toml의 use-buildkit = true 설정을 재정의합니다.

함수가 네이티브 컴파일된 종속 항목을 포함하는 패키지를 사용하는 경우 이 옵션을 사용하여 Lambda와 유사한 Docker 컨테이너 내에 함수를 구축합니다.