기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
클라우드에서의 테스트 소개 sam remote invoke
AWS Serverless Application Model 명령줄 인터페이스 (AWS SAM CLI) sam remote invoke 명령을 사용하여 에서 지원되는 AWS 리소스와 상호 작용할 수 AWS 클라우드있습니다. 다음 리소스를 호출하기 위해 sam remote invoke를 사용할 수 있습니다.
-
Amazon Kinesis Data Streams - 데이터 레코드를 Kinesis Data Streams 애플리케이션으로 전송합니다.
-
AWS Lambda - 이벤트를 호출하고 Lambda 함수로 전달합니다.
-
Amazon Simple Queue Service (Amazon SQS) – 메시지를 Amazon Simple Queue Service(Amazon SQS) 대기열에 전송합니다.
-
AWS Step Functions – Step Functions 상태 머신을 호출하여 실행을 시작합니다.
에 대한 소개는 AWS SAMCLI 을 참조하십시오이게 뭐죠? AWS SAMCLI.
일반적인 개발 워크플로 중 sam remote invoke를 사용하는 예는 5단계: 에서 함수와 상호 작용하십시오. AWS 클라우드 섹션을 참조하세요.
sam remote invoke를 사용하려면 다음을 완료하여 AWS SAM CLI를 설치합니다.
또한 최신 버전으로 업그레이드하는 것이 좋습니다. AWS SAMCLI 자세한 내용은 AWS SAMCLI업그레이드 섹션을 참조하세요.
sam remote invoke를 사용하기 전에 다음 사항에 대한 기본적인 이해를 하는 것이 좋습니다.
sam remote invoke 명령 사용
이 명령을 사용하기 전에 리소스를 AWS 클라우드에 배포해야 합니다.
다음 명령 구조를 사용하고 프로젝트의 루트 디렉터리에서 실행합니다.
$sam remote invoke<arguments> <options>
참고
이 페이지에는 명령 프롬프트에서 제공되는 옵션이 표시됩니다. 명령 프롬프트에서 옵션을 전달하는 대신 프로젝트의 구성 파일에서 옵션을 구성할 수도 있습니다. 자세한 내용은 프로젝트 설정 구성 섹션을 참조하세요.
sam remote invoke 인수 및 옵션에 대한 설명은 sam remote
invoke 섹션을 참조하세요.
Kinesis Data Streams 사용
Kinesis Data Streams 애플리케이션에 데이터 레코드를 보낼 수 있습니다. AWS SAM CLI그러면 데이터 기록이 전송되고 샤드 ID와 시퀀스 번호가 반환됩니다. 다음은 그 예제입니다.
$sam remote invokePutting record to Kinesis data stream KinesisStream Auto converting value 'hello-world' into JSON '"hello-world"'. If you don't want auto-conversion, please provide a JSON string as event { "ShardId": "shardId-000000000000", "SequenceNumber": "49646251411914806775980850790050483811301135051202232322" }%KinesisStream--stack-namekinesis-example--eventhello-world
데이터 기록을 보내려면
-
리소스 ID 값을 Kinesis Data Streams 애플리케이션의 인수로 제공합니다. 자세한 내용은 리소스 ID를 참조하세요.
-
데이터 레코드를 이벤트로 제공하여 Kinesis Data Streams 애플리케이션에 전송합니다.
--event옵션을 사용하여 명령줄에서 이벤트를 제공하거나--event-file을 사용하는 파일에서 이벤트를 제공할 수 있습니다. 이벤트를 제공하지 않으면 는 빈 이벤트를 AWS SAM CLI 보냅니다.
Lambda 함수와 함께 사용
클라우드에서 Lambda 함수를 호출하고 빈 이벤트를 전달하거나 명령줄 또는 파일에서 이벤트를 제공할 수 있습니다. AWS SAM CLI는 Lambda 함수를 호출하고 해당 응답을 반환합니다. 다음은 그 예제입니다.
$sam remote invokeInvoking Lambda Function HelloWorldFunction START RequestId: d5ef494b-5f45-4086-86fd-d7322fa1a1f9 Version: $LATEST END RequestId: d5ef494b-5f45-4086-86fd-d7322fa1a1f9 REPORT RequestId: d5ef494b-5f45-4086-86fd-d7322fa1a1f9 Duration: 6.62 ms Billed Duration: 7 ms Memory Size: 128 MB Max Memory Used: 67 MB Init Duration: 164.06 ms {"statusCode":200,"body":"{\"message\":\"hello world\"}"}%HelloWorldFunction--stack-namesam-app
Lambda 함수를 호출하기 위해
-
리소스 ID 값을 Lambda 함수에 대한 인수로 제공합니다. 자세한 내용은 리소스 ID를 참조하세요.
-
Lambda 함수에 전송할 이벤트를 제공합니다.
--event옵션을 사용하여 명령줄에서 이벤트를 제공하거나--event-file을 사용하는 파일에서 이벤트를 제공할 수 있습니다. 이벤트를 제공하지 않으면 는 빈 이벤트를 AWS SAM CLI 보냅니다.
응답 스트리밍으로 구성된 Lambda 함수
이 sam remote invoke 명령은 응답을 스트리밍하도록 구성된 Lambda 함수를 지원합니다. 템플릿의 속성을 사용하여 FunctionUrlConfig 응답을 스트리밍하도록 Lambda 함수를 구성할 수 있습니다. AWS SAM sam remote invoke를 사용하면 AWS SAMCLI가 Lambda 구성을 자동으로 감지하고 응답 스트리밍을 통해 호출합니다.
예시는 응답을 스트리밍하도록 Lambda 함수 구성 섹션을 참조하세요.
공유 가능한 테스트 이벤트를 클라우드의 Lambda 함수에 전달
공유 가능한 테스트 이벤트는 동일한 AWS 계정계정의 다른 사용자와 공유할 수 있는 테스트 이벤트입니다. 자세히 알아보려면 AWS Lambda 개발자 안내서의 공유 가능한 테스트 이벤트 섹션을 참조하세요.
공유 가능한 테스트 이벤트 액세스 및 관리
AWS SAM CLIsam remote test-event명령을 사용하여 공유 가능한 테스트 이벤트에 액세스하고 관리할 수 있습니다. 예를 들면, 다음을 수행하기 위해 sam remote test-event를 사용할 수 있습니다.
-
Amazon EventBridge 스키마 레지스트리에서 공유 가능한 테스트 이벤트를 검색합니다.
-
공유 가능한 테스트 이벤트를 로컬에서 수정하고 EventBridge 스키마 레지스트리에 업로드하십시오.
-
EventBridge 스키마 레지스트리에서 공유 가능한 테스트 이벤트를 삭제합니다.
자세한 내용은 를 사용한 클라우드 테스트 소개 sam remote test-event 섹션을 참조하세요.
공유 가능한 테스트 이벤트를 클라우드의 Lambda 함수에 전달
EventBridge 스키마 레지스트리에서 클라우드의 Lambda 함수로 공유 가능한 테스트 이벤트를 전달하려면 옵션을 사용하고 --test-event-name 공유 가능한 테스트 이벤트의 이름을 제공하십시오. 다음은 그 예제입니다.
$sam remote invokeHelloWorldFunction--stack-namesam-app--test-event-namedemo-event
공유 가능한 테스트 이벤트를 로컬에 저장하는 경우 --event-file 옵션을 사용하여 로컬 테스트 이벤트의 파일 경로와 이름을 제공할 수 있습니다. 다음은 그 예제입니다.
$sam remote invokeHelloWorldFunction--stack-namesam-app--event-filedemo-event.json
Amazon SQS에서 사용
메시지를 Amazon SQS 대기열로 전송할 수 있습니다. 는 다음을 반환합니다. AWS SAM CLI
-
메시지 ID
-
메시지 본문의 MD5
-
응답 메타데이터
다음은 그 예제입니다.
$sam remote invokeSending message to SQS queue MySqsQueue { "MD5OfMessageBody": "5d41402abc4b2a76b9719d911017c592", "MessageId": "05c7af65-9ae8-4014-ae28-809d6d8ec652" }%MySqsQueue--stack-namesqs-example-eventhello
메시지를 전송하려면
-
Amazon SQS 대기열의 인수로 리소스 ID 값을 제공합니다. 자세한 내용은 리소스 ID를 참조하세요.
-
Amazon SQS 대기열로 전송할 이벤트를 제공합니다.
--event옵션을 사용하여 명령줄에서 이벤트를 제공하거나--event-file을 사용하는 파일에서 이벤트를 제공할 수 있습니다. 이벤트를 제공하지 않으면 는 빈 이벤트를 AWS SAM CLI 보냅니다.
Step Functions와 함께 사용
Step Functions 상태 시스템 실행을 시작합니다. 는 스테이트 머신 워크플로가 AWS SAM CLI 완료될 때까지 기다린 후 실행의 마지막 단계에 대한 출력을 반환합니다. 다음은 그 예제입니다.
$sam remote invokeInvoking Step Function HelloWorldStateMachine "Hello Developer World"%HelloWorldStateMachine--stack-namestate-machine-example--event'{"is_developer": true}'
상태 머신을 실행하려면
-
Step Functions 상태 시스템의 인수로 리소스 ID 값을 제공합니다. 자세한 내용은 리소스 ID를 참조하세요.
-
상태 시스템에 전송할 이벤트를 제공합니다.
--event옵션을 사용하여 명령줄에서 이벤트를 제공하거나--event-file을 사용하는 파일에서 이벤트를 제공할 수 있습니다. 이벤트를 제공하지 않으면 는 빈 이벤트를 AWS SAM CLI 보냅니다.
sam remote invoke 명령 옵션 사용
이 섹션에서는 sam remote invoke 명령과 함께 사용할 수 있는 몇 가지 주요 옵션을 다룹니다. 옵션의 전체 목록은 sam remote
invoke 섹션을 참조하세요.
리소스에 이벤트 전달
다음 옵션을 사용하여 클라우드의 리소스에 이벤트를 전달할 수 있습니다.
-
--event- 명령줄에서 이벤트를 전달합니다. -
--event-file- 파일에서 이벤트를 전달합니다.
Lambda 예제
--event를 사용하여 명령줄에서 이벤트를 문자열 값으로 전달합니다.
$sam remote invokeInvoking Lambda Function HelloWorldFunction START RequestId: b992292d-1fac-4aa2-922a-c9dc5c6fceab Version: $LATEST END RequestId: b992292d-1fac-4aa2-922a-c9dc5c6fceab REPORT RequestId: b992292d-1fac-4aa2-922a-c9dc5c6fceab Duration: 16.41 ms Billed Duration: 17 ms Memory Size: 128 MB Max Memory Used: 67 MB Init Duration: 185.96 ms {"statusCode":200,"body":"{\"message\":\"hello!\"}"}%HelloWorldFunction--stack-namesam-app--event'{"message": "hello!"}'
--event-file를 사용하여 파일에서 이벤트를 전달하고 파일 경로를 제공합니다.
$cat event.json{"message": "hello from file"}%$sam remote invokeInvoking Lambda Function HelloWorldFunction START RequestId: 3bc71f7d-153a-4b1e-8c9a-901d91b1bec9 Version: $LATEST END RequestId: 3bc71f7d-153a-4b1e-8c9a-901d91b1bec9 REPORT RequestId: 3bc71f7d-153a-4b1e-8c9a-901d91b1bec9 Duration: 21.15 ms Billed Duration: 22 ms Memory Size: 128 MB Max Memory Used: 67 MB {"statusCode":200,"body":"{\"message\":\"hello from file\"}"}%HelloWorldFunction--stack-namesam-app--event-fileevent.json
stdin를 사용하여 이벤트를 전달합니다.
$cat event.json{"message": "hello from file"}%$catReading event from stdin (you can also pass it from file with --event-file) Invoking Lambda Function HelloWorldFunction START RequestId: 85ecc902-8ad0-4a2b-a8c8-9bb4f65f5a7a Version: $LATEST END RequestId: 85ecc902-8ad0-4a2b-a8c8-9bb4f65f5a7a REPORT RequestId: 85ecc902-8ad0-4a2b-a8c8-9bb4f65f5a7a Duration: 1.36 ms Billed Duration: 2 ms Memory Size: 128 MB Max Memory Used: 67 MB {"statusCode":200,"body":"{\"message\":\"hello from file\"}"}%event.json| sam remote invokeHelloWorldFunction--stack-namesam-app--event-file -
AWS SAMCLI 응답 출력을 구성합니다.
sam remote invoke를 사용하여 지원되는 리소스를 호출하면 AWS SAMCLI는 다음을 포함하는 응답을 반환합니다.
-
요청 메타데이터 - 요청과 관련된 메타데이터입니다. 여기에는 요청 ID 및 요청 시작 시간이 포함됩니다.
-
리소스 응답 - 클라우드에서 호출된 후 리소스가 보내는 응답입니다.
--output옵션을 사용하여 AWS SAM CLI 출력 응답을 구성할 수 있습니다. 다음과 같은 값을 사용할 수 있습니다.
-
json- 메타데이터 및 리소스 응답이 JSON 구조로 반환됩니다. 응답에는 전체 SDK 출력이 포함됩니다. -
text- 메타데이터가 텍스트 구조로 반환됩니다. 리소스 응답은 리소스의 출력 형식으로 반환됩니다.
다음은 json 출력의 예제입니다.
$sam remote invoke --stack-nameInvoking Lambda Function HelloWorldFunction { "ResponseMetadata": { "RequestId": "3bdf9a30-776d-4a90-94a6-4cccc0fc7b41", "HTTPStatusCode": 200, "HTTPHeaders": { "date": "Mon, 19 Jun 2023 17:15:46 GMT", "content-type": "application/json", "content-length": "57", "connection": "keep-alive", "x-amzn-requestid": "3bdf9a30-776d-4a90-94a6-4cccc0fc7b41", "x-amzn-remapped-content-length": "0", "x-amz-executed-version": "$LATEST", "x-amz-log-result": "U1RBUlQgUmVxdWVzdElkOiAzYmRmOWEzMC03NzZkLTRhOTAtOTRhNi00Y2NjYzBmYzdiNDEgVmVyc2lvbjogJExBVEVTVApFTkQgUmVxdWVzdElkOiAzYmRmOWEzMC03NzZkLTRhOTAtOTRhNi00Y2NjYzBmYzdiNDEKUkVQT1JUIFJlcXVlc3RJZDogM2JkZjlhMzAtNzc2ZC00YTkwLTk0YTYtNGNjY2MwZmM3YjQxCUR1cmF0aW9uOiA4LjIzIG1zCUJpbGxlZCBEdXJhdGlvbjogOSBtcwlNZW1vcnkgU2l6ZTogMTI4IE1CCU1heCBNZW1vcnkgVXNlZDogNjggTUIJCg==", "x-amzn-trace-id": "root=1-64908d42-17dab270273fcc6b527dd6b8;sampled=0;lineage=2301f8dc:0" }, "RetryAttempts": 0 }, "StatusCode": 200, "LogResult": "U1RBUlQgUmVxdWVzdElkOiAzYmRmOWEzMC03NzZkLTRhOTAtOTRhNi00Y2NjYzBmYzdiNDEgVmVyc2lvbjogJExBVEVTVApFTkQgUmVxdWVzdElkOiAzYmRmOWEzMC03NzZkLTRhOTAtOTRhNi00Y2NjYzBmYzdiNDEKUkVQT1JUIFJlcXVlc3RJZDogM2JkZjlhMzAtNzc2ZC00YTkwLTk0YTYtNGNjY2MwZmM3YjQxCUR1cmF0aW9uOiA4LjIzIG1zCUJpbGxlZCBEdXJhdGlvbjogOSBtcwlNZW1vcnkgU2l6ZTogMTI4IE1CCU1heCBNZW1vcnkgVXNlZDogNjggTUIJCg==", "ExecutedVersion": "$LATEST", "Payload": "{\"statusCode\":200,\"body\":\"{\\\"message\\\":\\\"hello world\\\"}\"}" }%sam-app--outputjson
json 출력을 지정하면 전체 응답이 stdout에 반환됩니다. 다음은 그 예제입니다.
$sam remote invoke --stack-nameInvoking Lambda Function HelloWorldFunctionsam-app--outputjson1>stdout.log$cat{ "ResponseMetadata": { "RequestId": "d30d280f-8188-4372-bc94-ce0f1603b6bb", "HTTPStatusCode": 200, "HTTPHeaders": { "date": "Mon, 19 Jun 2023 17:35:56 GMT", "content-type": "application/json", "content-length": "57", "connection": "keep-alive", "x-amzn-requestid": "d30d280f-8188-4372-bc94-ce0f1603b6bb", "x-amzn-remapped-content-length": "0", "x-amz-executed-version": "$LATEST", "x-amz-log-result": "U1RBUlQgUmVxdWVzdElkOiBkMzBkMjgwZi04MTg4LTQzNzItYmM5NC1jZTBmMTYwM2I2YmIgVmVyc2lvbjogJExBVEVTVApFTkQgUmVxdWVzdElkOiBkMzBkMjgwZi04MTg4LTQzNzItYmM5NC1jZTBmMTYwM2I2YmIKUkVQT1JUIFJlcXVlc3RJZDogZDMwZDI4MGYtODE4OC00MzcyLWJjOTQtY2UwZjE2MDNiNmJiCUR1cmF0aW9uOiA0LjE2IG1zCUJpbGxlZCBEdXJhdGlvbjogNSBtcwlNZW1vcnkgU2l6ZTogMTI4IE1CCU1heCBNZW1vcnkgVXNlZDogNjcgTUIJSW5pdCBEdXJhdGlvbjogMTU4LjM5IG1zCQo=", "x-amzn-trace-id": "root=1-649091fc-771473c7778689627a6122b7;sampled=0;lineage=2301f8dc:0" }, "RetryAttempts": 0 }, "StatusCode": 200, "LogResult": "U1RBUlQgUmVxdWVzdElkOiBkMzBkMjgwZi04MTg4LTQzNzItYmM5NC1jZTBmMTYwM2I2YmIgVmVyc2lvbjogJExBVEVTVApFTkQgUmVxdWVzdElkOiBkMzBkMjgwZi04MTg4LTQzNzItYmM5NC1jZTBmMTYwM2I2YmIKUkVQT1JUIFJlcXVlc3RJZDogZDMwZDI4MGYtODE4OC00MzcyLWJjOTQtY2UwZjE2MDNiNmJiCUR1cmF0aW9uOiA0LjE2IG1zCUJpbGxlZCBEdXJhdGlvbjogNSBtcwlNZW1vcnkgU2l6ZTogMTI4IE1CCU1heCBNZW1vcnkgVXNlZDogNjcgTUIJSW5pdCBEdXJhdGlvbjogMTU4LjM5IG1zCQo=", "ExecutedVersion": "$LATEST", "Payload": "{\"statusCode\":200,\"body\":\"{\\\"message\\\":\\\"hello world\\\"}\"}" }%stdout.log
다음은 text 출력의 예제입니다.
$sam remote invoke --stack-nameInvoking Lambda Function HelloWorldFunction START RequestId: 4dbacc43-1ec6-47c2-982b-9dc4620144d6 Version: $LATEST END RequestId: 4dbacc43-1ec6-47c2-982b-9dc4620144d6 REPORT RequestId: 4dbacc43-1ec6-47c2-982b-9dc4620144d6 Duration: 9.13 ms Billed Duration: 10 ms Memory Size: 128 MB Max Memory Used: 67 MB Init Duration: 165.50 ms {"statusCode":200,"body":"{\"message\":\"hello world\"}"}%sam-app--outputtext
text 출력을 지정하면 Lambda 함수 런타임 출력(예: 로그)이 stderr로 반환됩니다. Lambda 함수 페이로드가 stdout로 반환됩니다. 다음은 그 예제입니다.
$sam remote invoke --stack-name{"statusCode":200,"body":"{\"message\":\"hello world\"}"}%sam-app--outputtext2>stderr.log$catInvoking Lambda Function HelloWorldFunction START RequestId: 82273c3b-aa3a-4d16-8f1c-1d2ad3ace891 Version: $LATEST END RequestId: 82273c3b-aa3a-4d16-8f1c-1d2ad3ace891 REPORT RequestId: 82273c3b-aa3a-4d16-8f1c-1d2ad3ace891 Duration: 40.62 ms Billed Duration: 41 ms Memory Size: 128 MB Max Memory Used: 68 MBstderr.log$sam remote invoke --stack-nameInvoking Lambda Function HelloWorldFunction START RequestId: 74acaa9f-5b80-4a5c-b3b8-ffaccb84cbbd Version: $LATEST END RequestId: 74acaa9f-5b80-4a5c-b3b8-ffaccb84cbbd REPORT RequestId: 74acaa9f-5b80-4a5c-b3b8-ffaccb84cbbd Duration: 2.31 ms Billed Duration: 3 ms Memory Size: 128 MB Max Memory Used: 67 MBsam-app--outputtext1>stdout.log$cat{"statusCode":200,"body":"{\"message\":\"hello world\"}"}%stdout.log
Boto3 파라미터를 사용자 지정합니다.
예를 들어sam remote invoke, 는 Python용 AWS SDK (Boto3) 를 AWS SAM CLI 활용하여 클라우드의 리소스와 상호 작용합니다. --parameter 옵션을 사용하여 Boto3 파라미터를 사용자 지정할 수 있습니다. 사용자 지정할 수 있는 지원되는 파라미터 목록은 --parameter 섹션을 참조하세요.
예
Lambda 함수를 호출하여 파라미터 값을 검증하고 권한을 확인합니다.
$sam remote invokeHelloWorldFunction--stack-namesam-app--parameterInvocationType="DryRun"
단일 명령으로 --parameter 옵션을 여러 번 사용하여 여러 파라미터를 제공합니다.
$sam remote invokeHelloWorldFunction--stack-namesam-app--parameterInvocationType="Event"--parameterLogType="None"
기타 옵션
sam remote invoke 옵션의 전체 목록은 sam remote
invoke 섹션을 참조하세요.
프로젝트 구성 파일을 구성합니다.
구성 파일에서 sam remote invoke를 구성하려면 테이블에서 remote_invoke를 사용합니다. 다음은 sam
remote invoke 명령의 기본값을 구성하는 samconfig.toml 파일의 예입니다.
...
version =0.1
[default]
...
[default.remote_invoke.parameters]
stack_name = "cloud-app"
event = '{"message": "Hello!"}'
예
사용에 대한 기본 예제는 AWS Compute 블로그에서 AWS SAM remote를 사용한 sam remote invokeAWS Lambda
함수 테스트를
Kinesis Data Streams 예제
기본 예제
파일에서 Kinesis Data Streams 애플리케이션으로 데이터 레코드를 전송합니다. 리소스 ID에 대한 ARN을 제공하여 Kinesis Data Streams 애플리케이션을 식별할 수 있습니다.
$sam remote invokearn:aws:kinesis:us-west-2:01234567890:stream/kinesis-example-KinesisStream-BgnLcAey4xUQ--event-fileevent.json
명령줄에 제공된 이벤트를 Kinesis Data Streams 애플리케이션으로 전송합니다.
$sam remote invokePutting record to Kinesis data stream KinesisStream Auto converting value 'hello-world' into JSON '"hello-world"'. If you don't want auto-conversion, please provide a JSON string as event { "ShardId": "shardId-000000000000", "SequenceNumber": "49646251411914806775980903986194508740483329854174920706" }%KinesisStream--stack-namekinesis-example--eventhello-world
Kinesis Data Streams 애플리케이션의 물리적 ID를 가져옵니다. 그런 다음 명령줄에서 이벤트를 제공합니다.
$sam list resources --stack-name[ { "LogicalResourceId": "KinesisStream", "PhysicalResourceId": "kinesis-example-KinesisStream-ZgnLcQey4xUQ" } ]kinesis-example--outputjson$sam remote invokePutting record to Kinesis data stream KinesisStream Auto converting value 'hello' into JSON '"hello"'. If you don't want auto-conversion, please provide a JSON string as event { "ShardId": "shardId-000000000000", "SequenceNumber": "49646251411914806775980904340716841045751814812900261890" }%kinesis-example-KinesisStream-ZgnLcQey4xUQ--eventhello
명령줄에 JSON 문자열을 이벤트로 제공합니다.
$sam remote invokePutting record to Kinesis data stream KinesisStream { "ShardId": "shardId-000000000000", "SequenceNumber": "49646251411914806775980904492868617924990209230536441858" }%KinesisStream--stack-namekinesis-example--event'{"method": "GET", "body": ""}'
Kinesis Data Streams 애플리케이션에 빈 이벤트를 전송합니다.
$sam remote invokePutting record to Kinesis data stream KinesisStream { "ShardId": "shardId-000000000000", "SequenceNumber": "49646251411914806775980904866469008589597168190416224258" }%KinesisStream--stack-namekinesis-example
AWS SAM CLI응답을 JSON 형식으로 반환합니다.
$sam remote invokePutting record to Kinesis data stream KinesisStream { "ShardId": "shardId-000000000000", "SequenceNumber": "49646251411914806775980905078409420803696667195489648642", "ResponseMetadata": { "RequestId": "ebbbd307-3e9f-4431-b67c-f0715e9e353e", "HTTPStatusCode": 200, "HTTPHeaders": { "x-amzn-requestid": "ebbbd307-3e9f-4431-b67c-f0715e9e353e", "x-amz-id-2": "Q3yBcgTwtPaQTV26IKclbECmZikUYOzKY+CzcxA84ZHgCkc5T2N/ITWg6RPOQcWw8Gn0tNPcEJBEHyVVqboJAPgCritqsvCu", "date": "Thu, 09 Nov 2023 18:13:10 GMT", "content-type": "application/x-amz-json-1.1", "content-length": "110" }, "RetryAttempts": 0 } }%KinesisStream--stack-namekinesis-example--event'{"hello": "world"}'--outputjson
JSON 출력을 stdout으로 반환합니다.
$sam remote invokePutting record to Kinesis data stream KinesisStreamKinesisStream--stack-namekinesis-example--event'{"hello": "world"}'--outputjson 1> stdout.log$cat{ "ShardId": "shardId-000000000000", "SequenceNumber": "49646251411914806775980906397777867595039988349006774274", "ResponseMetadata": { "RequestId": "f4290006-d84b-b1cd-a9ee-28306eeb2939", "HTTPStatusCode": 200, "HTTPHeaders": { "x-amzn-requestid": "f4290006-d84b-b1cd-a9ee-28306eeb2939", "x-amz-id-2": "npCqz+IBKpoL4sQ1ClbUmxuJlbeA24Fx1UgpIrS6mm2NoIeV2qdZSN5AhNurdssykXajBrXaC9anMhj2eG/h7Hnbf+bPuotU", "date": "Thu, 09 Nov 2023 18:33:26 GMT", "content-type": "application/x-amz-json-1.1", "content-length": "110" }, "RetryAttempts": 0 } }%stdout.log
Lambda 예제
기본 예제
ARN을 리소스 ID로 제공하여 Lambda 함수를 호출합니다.
$sam remote invokearn:aws:lambda:us-west-2:012345678910:function:sam-app-HelloWorldFunction-ohRFEn2RuAvp
논리적 ID를 리소스 ID로 제공하여 Lambda 함수를 호출합니다.
또한 옵션을 사용하여 AWS CloudFormation 스택 이름을 제공해야 합니다. --stack-name 다음은 그 예제입니다.
$sam remote invokeHelloWorldFunction--stack-namesam-app
애플리케이션에 단일 Lambda 함수가 포함된 경우 해당 함수의 논리적 ID를 지정하지 않아도 됩니다. --stack-name 옵션만 제공할 수 있습니다. 다음은 그 예제입니다.
$sam remote invoke --stack-namesam-app
물리적 ID를 리소스 ID로 제공하여 Lambda 함수를 호출합니다.
를 사용하여 배포할 때 물리적 ID가 생성됩니다 AWS CloudFormation.
$sam remote invokesam-app-HelloWorldFunction-TZvxQRFNv0k4
하위 스택의 Lambda 함수를 호출합니다.
이 예제에서 애플리케이션에는 다음과 같은 디렉터리 구조를 포함합니다.
lambda-example ├── childstack │ ├── function │ │ ├── __init__.py │ │ ├── app.py │ │ └── requirements.txt │ └── template.yaml ├── events │ └── event.json ├── samconfig.toml └── template.yaml
childstack에 대한 Lambda 함수를 호출하기 위해 다음을 실행합니다.
$sam remote invokeInvoking Lambda Function HelloWorldFunction START RequestId: 207a864b-e67c-4307-8478-365b004d4bcd Version: $LATEST END RequestId: 207a864b-e67c-4307-8478-365b004d4bcd REPORT RequestId: 207a864b-e67c-4307-8478-365b004d4bcd Duration: 1.27 ms Billed Duration: 2 ms Memory Size: 128 MB Max Memory Used: 36 MB Init Duration: 111.07 ms {"statusCode": 200, "body": "{\"message\": \"Hello\", \"received_event\": {}}"}%ChildStack/HelloWorldFunction--stack-namelambda-example
응답을 스트리밍하도록 Lambda 함수 구성
이 예제에서는 AWS SAMCLI를 사용하여 응답을 스트리밍하도록 구성된 Lambda 함수를 포함하는 새로운 서버리스 애플리케이션을 초기화합니다. 애플리케이션을 에 AWS 클라우드 배포하고 를 사용하여 클라우드의 함수와 상호 작용합니다. sam remote invoke
먼저 sam init 명령을 실행하여 새 서버리스 애플리케이션을 생성합니다. Lambda 응답 스트리밍 퀵 스타트 템플릿을 선택하고 애플리케이션 이름을 지정합니다. lambda-streaming-nodejs-app
$sam initYou can preselect a particular runtime or package type when using the `sam init` experience. Call `sam init --help` to learn more. Which template source would you like to use? 1 - AWS Quick Start Templates 2 - Custom Template Location Choice:1Choose an AWS Quick Start application template 1 - Hello World Example ... 9 - Lambda Response Streaming ... 15 - Machine Learning Template:9Which runtime would you like to use? 1 - go (provided.al2) 2 - nodejs18.x 3 - nodejs16.x Runtime:2Based on your selections, the only Package type available is Zip. We will proceed to selecting the Package type as Zip. Based on your selections, the only dependency manager available is npm. We will proceed copying the template using npm. Would you like to enable X-Ray tracing on the function(s) in your application? [y/N]:ENTERWould you like to enable monitoring using CloudWatch Application Insights? For more info, please view https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch-application-insights.html [y/N]:ENTERProject name [sam-app]:lambda-streaming-nodejs-app----------------------- Generating application: ----------------------- Name: lambda-streaming-nodejs-app Runtime: nodejs18.x Architectures: x86_64 Dependency Manager: npm Application Template: response-streaming Output Directory: . Configuration file: lambda-streaming-nodejs-app/samconfig.toml Next steps can be found in the README file at lambda-streaming-nodejs-app/README.md Commands you can use next ========================= [*] Create pipeline: cd lambda-streaming-nodejs-app && sam pipeline init --bootstrap [*] Validate SAM template: cd lambda-streaming-nodejs-app && sam validate [*] Test Function in the Cloud: cd lambda-streaming-nodejs-app && sam sync --stack-name {stack-name} --watch
는 다음과 같은 구조로 프로젝트를 AWS SAMCLI 생성합니다.
lambda-streaming-nodejs-app ├── README.md ├── __tests__ │ └── unit │ └── index.test.js ├── package.json ├── samconfig.toml ├── src │ └── index.js └── template.yaml
다음은 Lambda 함수 코드의 예제입니다.
exports.handler = awslambda.streamifyResponse( async (event, responseStream, context) => { const httpResponseMetadata = { statusCode: 200, headers: { "Content-Type": "text/html", "X-Custom-Header": "Example-Custom-Header" } }; responseStream = awslambda.HttpResponseStream.from(responseStream, httpResponseMetadata); // It's recommended to use a `pipeline` over the `write` method for more complex use cases. // Learn more: https://docs.aws.amazon.com/lambda/latest/dg/configuration-response-streaming.html responseStream.write("<html>"); responseStream.write("<p>First write!</p>"); responseStream.write("<h1>Streaming h1</h1>"); await new Promise(r => setTimeout(r, 1000)); responseStream.write("<h2>Streaming h2</h2>"); await new Promise(r => setTimeout(r, 1000)); responseStream.write("<h3>Streaming h3</h3>"); await new Promise(r => setTimeout(r, 1000)); // Long strings will be streamed const loremIpsum1 = "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Quisque vitae mi tincidunt tellus ultricies dignissim id et diam. Morbi pharetra eu nisi et finibus. Vivamus diam nulla, vulputate et nisl cursus, pellentesque vehicula libero. Cras imperdiet lorem ante, non posuere dolor sollicitudin a. Vestibulum ipsum lacus, blandit nec augue id, lobortis dictum urna. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices posuere cubilia curae; Morbi auctor orci eget tellus aliquam, non maximus massa porta. In diam ante, pulvinar aliquam nisl non, elementum hendrerit sapien. Vestibulum massa nunc, mattis non congue vitae, placerat in quam. Nam vulputate lectus metus, et dignissim erat varius a."; responseStream.write(`<p>${loremIpsum1}</p>`); await new Promise(r => setTimeout(r, 1000)); responseStream.write("<p>DONE!</p>"); responseStream.write("</html>"); responseStream.end(); } );
다음은 template.yaml 파일의 예제입니다. Lambda 함수의 응답 스트리밍은 FunctionUrlConfig 속성을 사용하여 구성됩니다.
AWSTemplateFormatVersion: '2010-09-09' Transform: AWS::Serverless-2016-10-31 Description: > Sample SAM Template for lambda-streaming-nodejs-app Resources: StreamingFunction: Type: AWS::Serverless::Function Properties: CodeUri: src/ Handler: index.handler Runtime: nodejs18.x Architectures: - x86_64 Timeout: 10 FunctionUrlConfig: AuthType: AWS_IAM InvokeMode: RESPONSE_STREAM Outputs: StreamingFunction: Description: "Streaming Lambda Function ARN" Value: !GetAtt StreamingFunction.Arn StreamingFunctionURL: Description: "Streaming Lambda Function URL" Value: !GetAtt StreamingFunctionUrl.FunctionUrl
일반적으로 sam build 및 sam deploy --guided를 사용하여 프로덕션 애플리케이션을 빌드하고 배포할 수 있습니다. 이 예제에서는 개발 환경을 가정하고 sam sync 명령을 사용하여 애플리케이션을 빌드하고 배포해 보겠습니다.
참고
이 sam sync 명령은 개발 환경에 권장됩니다. 자세한 내용은 동기화하는 sam sync 데 사용하는 방법 소개 AWS 클라우드 섹션을 참조하세요.
sam sync를 실행하기 전에 samconfig.toml 파일에 프로젝트가 올바르게 구성되어 있는지 확인합니다. 가장 중요한 것은 stack_name 및 watch의 값을 검증하는 것입니다. 구성 파일에 이러한 값을 지정하면 명령줄에서 값을 제공할 필요가 없습니다.
version = 0.1 [default] [default.global.parameters] stack_name = "lambda-streaming-nodejs-app" [default.build.parameters] cached = true parallel = true [default.validate.parameters] lint = true [default.deploy.parameters] capabilities = "CAPABILITY_IAM" confirm_changeset = true resolve_s3 = true s3_prefix = "lambda-streaming-nodejs-app" region = "us-west-2" image_repositories = [] [default.package.parameters] resolve_s3 = true [default.sync.parameters] watch = true [default.local_start_api.parameters] warm_containers = "EAGER" [default.local_start_lambda.parameters] warm_containers = "EAGER"
다음으로 sam sync를 실행하여 애플리케이션을 빌드하고 배포합니다. --watch 옵션이 구성 파일에 구성되어 있으므로 AWS SAMCLI는 애플리케이션을 빌드하고, 애플리케이션을 배포하고, 변경 사항을 확인합니다.
$sam syncThe SAM CLI will use the AWS Lambda, Amazon API Gateway, and AWS StepFunctions APIs to upload your code without performing a CloudFormation deployment. This will cause drift in your CloudFormation stack. **The sync command should only be used against a development stack**. Queued infra sync. Waiting for in progress code syncs to complete... Starting infra sync. Building codeuri: /Users/.../lambda-streaming-nodejs-app/src runtime: nodejs18.x metadata: {} architecture: x86_64 functions: StreamingFunction package.json file not found. Continuing the build without dependencies. Running NodejsNpmBuilder:CopySource Build Succeeded Successfully packaged artifacts and wrote output template to file /var/folders/45/5ct135bx3fn2551_ptl5g6_80000gr/T/tmpavrzdhgp. Execute the following command to deploy the packaged template sam deploy --template-file /var/folders/45/5ct135bx3fn2551_ptl5g6_80000gr/T/tmpavrzdhgp --stack-name <YOUR STACK NAME> Deploying with following values =============================== Stack name : lambda-streaming-nodejs-app Region : us-west-2 Disable rollback : False Deployment s3 bucket : aws-sam-cli-managed-default-samclisourcebucket-1a4x26zbcdkqr Capabilities : ["CAPABILITY_NAMED_IAM", "CAPABILITY_AUTO_EXPAND"] Parameter overrides : {} Signing Profiles : null Initiating deployment ===================== 2023-06-20 12:11:16 - Waiting for stack create/update to complete CloudFormation events from stack operations (refresh every 0.5 seconds) ----------------------------------------------------------------------------------------------------- ResourceStatus ResourceType LogicalResourceId ResourceStatusReason ----------------------------------------------------------------------------------------------------- CREATE_IN_PROGRESS AWS::CloudFormation::St lambda-streaming- Transformation ack nodejs-app succeeded CREATE_IN_PROGRESS AWS::IAM::Role StreamingFunctionRole - CREATE_IN_PROGRESS AWS::CloudFormation::St AwsSamAutoDependencyLay - ack erNestedStack CREATE_IN_PROGRESS AWS::IAM::Role StreamingFunctionRole Resource creation Initiated CREATE_IN_PROGRESS AWS::CloudFormation::St AwsSamAutoDependencyLay Resource creation ack erNestedStack Initiated CREATE_COMPLETE AWS::IAM::Role StreamingFunctionRole - CREATE_COMPLETE AWS::CloudFormation::St AwsSamAutoDependencyLay - ack erNestedStack CREATE_IN_PROGRESS AWS::Lambda::Function StreamingFunction - CREATE_IN_PROGRESS AWS::Lambda::Function StreamingFunction Resource creation Initiated CREATE_COMPLETE AWS::Lambda::Function StreamingFunction - CREATE_IN_PROGRESS AWS::Lambda::Url StreamingFunctionUrl - CREATE_IN_PROGRESS AWS::Lambda::Url StreamingFunctionUrl Resource creation Initiated CREATE_COMPLETE AWS::Lambda::Url StreamingFunctionUrl - CREATE_COMPLETE AWS::CloudFormation::St lambda-streaming- - ack nodejs-app ----------------------------------------------------------------------------------------------------- CloudFormation outputs from deployed stack ------------------------------------------------------------------------------------------------------- Outputs ------------------------------------------------------------------------------------------------------- Key StreamingFunction Description Streaming Lambda Function ARN Value arn:aws:lambda:us-west-2:012345678910:function:lambda-streaming-nodejs-app- StreamingFunction-gUmhO833A0vZ Key StreamingFunctionURL Description Streaming Lambda Function URL Value https://wxgkcc2dyntgtrwhf2dgdcvylu0rnnof.lambda-url.us-west-2.on.aws/ ------------------------------------------------------------------------------------------------------- Stack creation succeeded. Sync infra completed. Infra sync completed.
이제 함수가 클라우드에 배포되었으므로 sam remote
invoke를 사용하여 함수와 상호 작용할 수 있습니다. AWS SAMCLI는 함수가 응답 스트리밍을 위해 구성되었음을 자동으로 감지하고 즉시 함수의 스트리밍된 응답을 실시간으로 출력하기 시작합니다.
$sam remote invokeInvoking Lambda Function StreamingFunction {"statusCode":200,"headers":{"Content-Type":"text/html","X-Custom-Header":"Example-Custom-Header"}}<html><p>First write!</p><h1>Streaming h1</h1><h2>Streaming h2</h2><h3>Streaming h3</h3><p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Quisque vitae mi tincidunt tellus ultricies dignissim id et diam. Morbi pharetra eu nisi et finibus. Vivamus diam nulla, vulputate et nisl cursus, pellentesque vehicula libero. Cras imperdiet lorem ante, non posuere dolor sollicitudin a. Vestibulum ipsum lacus, blandit nec augue id, lobortis dictum urna. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices posuere cubilia curae; Morbi auctor orci eget tellus aliquam, non maximus massa porta. In diam ante, pulvinar aliquam nisl non, elementum hendrerit sapien. Vestibulum massa nunc, mattis non congue vitae, placerat in quam. Nam vulputate lectus metus, et dignissim erat varius a.</p><p>DONE!</p></html>START RequestId: 1e4cdf04-60de-4769-b3a2-c1481982deb4 Version: $LATEST END RequestId: 1e4cdf04-60de-4769-b3a2-c1481982deb4 REPORT RequestId: 1e4cdf04-60de-4769-b3a2-c1481982deb4 Duration: 4088.66 ms Billed Duration: 4089 ms Memory Size: 128 MB Max Memory Used: 68 MB Init Duration: 168.45 msStreamingFunction
함수 코드를 수정하면 AWS SAMCLI는 변경 사항을 즉시 감지하고 즉시 배포합니다. 다음은 함수 코드를 변경한 후의 AWS SAMCLI 출력의 예입니다.
Syncing Lambda Function StreamingFunction...
Building codeuri:
/Users/.../lambda-streaming-nodejs-app/src runtime: nodejs18.x metadata: {} architecture:
x86_64 functions: StreamingFunction
package.json file not found. Continuing the build without dependencies.
Running NodejsNpmBuilder:CopySource
Finished syncing Lambda Function StreamingFunction.
Syncing Layer StreamingFunctione9cfe924DepLayer...
SyncFlow [Layer StreamingFunctione9cfe924DepLayer]: Skipping resource update as the
content didn't change
Finished syncing Layer StreamingFunctione9cfe924DepLayer.
이제 다시 sam remote invoke를 사용하여 클라우드에서 함수와 상호 작용하고 변경 사항을 테스트할 수 있습니다.
SQS 예제
기본 예제
ARN을 리소스 ID로 제공하여 Amazon SQS 대기열을 호출합니다.
$sam remote invokeSending message to SQS queue MySqsQueue { "MD5OfMessageBody": "49dfdd54b01cbcd2d2ab5e9e5ee6b9b9", "MessageId": "4f464cdd-15ef-4b57-bd72-3ad225d80adc", "ResponseMetadata": { "RequestId": "95d39377-8323-5ef0-9223-ceb198bd09bd", "HTTPStatusCode": 200, "HTTPHeaders": { "x-amzn-requestid": "95d39377-8323-5ef0-9223-ceb198bd09bd", "date": "Wed, 08 Nov 2023 23:27:26 GMT", "content-type": "application/x-amz-json-1.0", "content-length": "106", "connection": "keep-alive" }, "RetryAttempts": 0 } }%arn:aws:sqs:us-west-2:01234567890:sqs-example-4DonhBsjsW1b--event'{"hello": "world"}'--outputjson
Step Functions 예제
기본 예제
물리적 ID를 리소스 ID로 제공하여 상태 시스템을 호출합니다.
먼저 sam list resources를 사용하여 물리적 ID를 가져옵니다.
$sam list resources --stack-name[ { "LogicalResourceId": "HelloWorldStateMachine", "PhysicalResourceId": "arn:aws:states:us-west-2:513423067560:stateMachine:HelloWorldStateMachine-z69tFEUx0F66" }, { "LogicalResourceId": "HelloWorldStateMachineRole", "PhysicalResourceId": "simple-state-machine-HelloWorldStateMachineRole-PduA0BDGuFXw" } ]state-machine-example--outputjson
다음으로 물리적 ID를 리소스 ID로 사용하여 상태 시스템을 호출합니다. 명령줄에서 --event 옵션을 사용하여 이벤트를 전달합니다.
$sam remote invokeInvoking Step Function arn:aws:states:us-west-2:01234567890:stateMachine:HelloWorldStateMachine-z69tFEUx0F66 "Hello Developer World"%arn:aws:states:us-west-2:01234567890:stateMachine:HelloWorldStateMachine-z69tFEUx0F66--event'{"is_developer": true}'
빈 이벤트를 전달하여 상태 시스템을 호출합니다.
$sam remote invokeInvoking Step Function HelloWorldStateMachine "Hello World"%HelloWorldStateMachine--stack-namestate-machine-example
관련 링크
sam remote invoke와 관련된 설명서와 사용법은 AWS SAMCLI 다음을 참조하십시오.
