자습서: 사용자 지정 런타임 빌드

실행 역할을 만들려면

1. IAM 콘솔에서 역할 페이지를 엽니다.

2. 역할 생성을 선택합니다.

3. 다음 속성을 사용하여 역할을 만듭니다.

   • 신뢰할 수 있는 엔터티 – Lambda.

   • 권한 – AWSLambdaBasicExecutionRole.

   • 역할 이름 – lambda-role.

   AWSLambdaBasicExecutionRole 정책은 함수가 CloudWatch Logs에 로그를 쓰는 데 필요한 권한을 가집니다.

1. 프로젝트에 대한 디렉터리를 생성하고 해당 디렉터리로 전환합니다.

   mkdir runtime-tutorial
   cd runtime-tutorial

2. bootstrap라는 파일을 새로 생성합니다. 사용자 지정 런타임입니다.

   예 부트스트랩

   #!/bin/sh
   
   set -euo pipefail
   
   # Initialization - load function handler
   source $LAMBDA_TASK_ROOT/"$(echo $_HANDLER | cut -d. -f1).sh"
   
   # Processing
   while true
   do
     HEADERS="$(mktemp)"
     # Get an event. The HTTP request will block until one is received
     EVENT_DATA=$(curl -sS -LD "$HEADERS" "http://${AWS_LAMBDA_RUNTIME_API}/2018-06-01/runtime/invocation/next")
   
     # Extract request ID by scraping response headers received above
     REQUEST_ID=$(grep -Fi Lambda-Runtime-Aws-Request-Id "$HEADERS" | tr -d '[:space:]' | cut -d: -f2)
   
     # Run the handler function from the script
     RESPONSE=$($(echo "$_HANDLER" | cut -d. -f2) "$EVENT_DATA")
   
     # Send the response
     curl "http://${AWS_LAMBDA_RUNTIME_API}/2018-06-01/runtime/invocation/$REQUEST_ID/response"  -d "$RESPONSE"
   done

   런타임은 배포 패키지에서 함수 스크립트를 로드합니다. 런타임은 두 변수를 사용하여 스크립트를 찾습니다. LAMBDA_TASK_ROOT는 패키지가 추출된 위치를 알려주며 _HANDLER에는 스크립트의 이름이 포함됩니다.

   런타임은 함수 스크립트를 로딩한 후 런타임 API를 사용하여 Lambda에서 간접 호출 이벤트를 검색하고 이벤트를 핸들러로 전달하며 응답을 Lambda에 다시 게시합니다. 요청 ID를 가져오기 위해 런타임은 API 응답의 헤더를 임시 파일에 저장하고 이 파일에서 Lambda-Runtime-Aws-Request-Id 헤더를 읽습니다.

   참고

   런타임은 오류 처리를 포함한 추가적인 책임이 있으며, 핸들러에 컨텍스트 정보를 제공합니다. 세부 정보는 요구 사항을 참조하세요.

3. 함수에 대해 스크립트를 생성합니다. 다음 스크립트 예는 이벤트 데이터를 취하여 이를 stderr에 기록한 후 반환하는 핸들러 함수를 정의합니다.

   예 function.sh

   function handler () {
     EVENT_DATA=$1
     echo "$EVENT_DATA" 1>&2;
     RESPONSE="Echoing request: '$EVENT_DATA'"
   
     echo $RESPONSE
   }

   runtime-tutorial 디렉터리는 이제 다음과 같아야 합니다.

   runtime-tutorial
   ├ bootstrap
   └ function.sh

4. 실행 파일들을 생성하여 이를 .zip 파일 아카이브에 추가합니다. 이것이 배포 패키지입니다.

   chmod 755 function.sh bootstrap
   zip function.zip function.sh bootstrap

5. bash-runtime이라는 이름의 함수를 생성합니다. --role에 Lambda 실행 역할의 ARN을 입력합니다.

   aws lambda create-function --function-name bash-runtime \
   --zip-file fileb://function.zip --handler function.handler --runtime provided.al2023 \
   --role arn:aws:iam::123456789012:role/lambda-role

6. 함수를 간접 호출합니다.

   aws lambda invoke --function-name bash-runtime --payload '{"text":"Hello"}' response.txt --cli-binary-format raw-in-base64-out

   cli-binary-format 옵션은 AWS CLI 버전 2를 사용할 때 필요합니다. 이 설정을 기본 설정으로 지정하려면 aws configure set cli-binary-format raw-in-base64-out을(를) 실행하세요. 자세한 내용은 AWS CLI 지원되는 글로벌 명령줄 옵션을 AWS Command Line Interface 사용 설명서 버전 2에서 참조하세요.

   다음과 같은 응답이 표시되어야 합니다.

   {
       "StatusCode": 200,
       "ExecutedVersion": "$LATEST"
   }

7. 응답을 확인합니다.

   cat response.txt

   다음과 같은 응답이 표시되어야 합니다.

   Echoing request: '{"text":"Hello"}'

1. bootstrap 파일을 포함하는 .zip 파일을 생성합니다.

   zip runtime.zip bootstrap

2. publish-layer-version 명령을 사용하여 계층을 생성합니다.

   aws lambda publish-layer-version --layer-name bash-runtime --zip-file fileb://runtime.zip

   그러면 해당 계층의 첫 번째 버전이 생성됩니다.

1. 계층을 가져 오도록 함수 구성을 업데이트하세요.

   aws lambda update-function-configuration --function-name bash-runtime \
   --layers arn:aws:lambda:us-east-1:123456789012:layer:bash-runtime:1

   이 작업으로 /opt 디렉터리의 함수에 런타임이 추가됩니다. Lambda가 계층의 런타임을 사용하도록 하려면 다음 두 단계에 표시된 것처럼 함수의 배포 패키지에서 boostrap을 제거해야 합니다.

2. 함수 코드를 포함하는 .zip 파일을 생성합니다.

   zip function-only.zip function.sh

3. 핸들러 스크립트만 포함하도록 함수 코드를 업데이트하세요.

   aws lambda update-function-code --function-name bash-runtime --zip-file fileb://function-only.zip

4. 함수를 간접 호출하여 런타임 계층에서 작동하는지 확인합니다.

   aws lambda invoke --function-name bash-runtime --payload '{"text":"Hello"}' response.txt --cli-binary-format raw-in-base64-out

   cli-binary-format 옵션은 AWS CLI 버전 2를 사용할 때 필요합니다. 이 설정을 기본 설정으로 지정하려면 aws configure set cli-binary-format raw-in-base64-out을(를) 실행하세요. 자세한 내용은 AWS CLI 지원되는 글로벌 명령줄 옵션을 AWS Command Line Interface 사용 설명서 버전 2에서 참조하세요.

   다음과 같은 응답이 표시되어야 합니다.

   {
       "StatusCode": 200,
       "ExecutedVersion": "$LATEST"
   }

5. 응답을 확인합니다.

   cat response.txt

   다음과 같은 응답이 표시되어야 합니다.

   Echoing request: '{"text":"Hello"}'

1. 실행 환경에 관한 정보를 기록하려면 환경 변수를 출력하도록 런타임 스크립트를 업데이트하세요.

   예 부트스트랩

   #!/bin/sh
   
   set -euo pipefail
   
   # Configure runtime to output environment variables
   echo "##  Environment variables:"
   env
   
   # Load function handler
   source $LAMBDA_TASK_ROOT/"$(echo $_HANDLER | cut -d. -f1).sh"
   
   # Processing
   while true
   do
     HEADERS="$(mktemp)"
     # Get an event. The HTTP request will block until one is received
     EVENT_DATA=$(curl -sS -LD "$HEADERS" "http://${AWS_LAMBDA_RUNTIME_API}/2018-06-01/runtime/invocation/next")
   
     # Extract request ID by scraping response headers received above
     REQUEST_ID=$(grep -Fi Lambda-Runtime-Aws-Request-Id "$HEADERS" | tr -d '[:space:]' | cut -d: -f2)
   
     # Run the handler function from the script
     RESPONSE=$($(echo "$_HANDLER" | cut -d. -f2) "$EVENT_DATA")
   
     # Send the response
     curl "http://${AWS_LAMBDA_RUNTIME_API}/2018-06-01/runtime/invocation/$REQUEST_ID/response"  -d "$RESPONSE"
   done

2. bootstrap 파일의 새 버전을 포함하는 .zip 파일을 생성합니다.

   zip runtime.zip bootstrap

3. bash-runtime 계층의 새로운 버전을 생성합니다.

   aws lambda publish-layer-version --layer-name bash-runtime --zip-file fileb://runtime.zip

4. 새 버전의 계층을 사용하도록 함수를 구성합니다.

   aws lambda update-function-configuration --function-name bash-runtime \
   --layers arn:aws:lambda:us-east-1:123456789012:layer:bash-runtime:2