Node.js Lambda 함수를 위한 계층 작업

Lambda 계층은 추가 코드 또는 데이터를 포함하는 .zip 파일 아카이브입니다. 계층에는 일반적으로 라이브러리 종속 항목, 사용자 지정 런타임 또는 구성 파일이 포함됩니다. 계층을 생성하려면 세 가지 일반적인 단계를 거칩니다.

이 주제에는 외부 라이브러리 종속성이 있는 Node.js Lambda 계층을 올바르게 패키징하고 생성하는 방법에 대한 단계와 지침이 포함되어 있습니다.

사전 조건

이 섹션의 단계를 수행하려면 다음이 필요합니다.

이 주제에서는 aws-lambda-developer-guide GitHub 리포지토리의 layer-nodejs 샘플 애플리케이션을 참조합니다. 이 애플리케이션은 종속성을 다운로드하고 계층으로 패키징하는 스크립트를 포함합니다. 애플리케이션은 계층의 종속성을 사용하는 해당 함수도 포함합니다. 계층을 생성한 후 해당 함수를 배포하고 간접 호출하여 모든 것이 작동하는지 확인할 수 있습니다. 이 샘플 애플리케이션은 Node.js 20 런타임을 사용합니다. 계층에 추가 종속성을 추가하는 경우 해당 종속성은 Node.js 20과 호환되어야 합니다.

layer-nodejs 샘플 애플리케이션은 lodash 라이브러리를 Lambda 계층으로 패키징합니다. layer 디렉터리는 계층을 생성하는 스크립트를 포함합니다. function 디렉터리에는 계층이 작동하는지 테스트하는 샘플 함수가 들어 있습니다. 이 문서는 이 계층을 생성, 패키징, 배포 및 테스트하는 방법을 안내합니다.

Lambda 런타임 환경과 Node.js 계층 호환성

Node.js 계층에서 코드를 패키징할 때 코드와 호환되는 Lambda 런타임 환경을 지정합니다. 런타임과의 코드 호환성을 평가하려면 코드가 설계된 Node.js 버전, 운영 체제, 명령 세트 아키텍처를 고려하세요.

Lambda Node.js 런타임은 Node.js 버전과 운영 체제를 지정합니다. 이 문서에서는 AL2023 기반의 Node.js 20 런타임을 사용합니다. 런타임 버전에 대한 자세한 내용은 지원되는 런타임 섹션을 참조하세요. Lambda 함수를 생성할 때 명령 세트 아키텍처를 지정합니다. 이 문서에서는 arm64 아키텍처를 사용합니다. Lambda의 아키텍처에 대한 자세한 내용은 Lambda 함수에 대한 명령 세트 아키텍처의 선택 및 구성 섹션을 참조하세요.

패키지에 제공된 코드를 사용하는 경우 각 패키지 관리자는 독립적으로 호환성을 정의합니다. 대부분의 Node.js 개발은 운영 체제 및 명령 세트 아키텍처와 독립적으로 작동하도록 설계되었습니다. 또한 새 Node.js 버전에서 호환성 문제가 발생하는 일은 흔하지 않습니다. Node.js 버전, 운영 체제 또는 명령 세트 아키텍처와의 패키지 호환성을 평가하는 것보다 패키지 간 호환성을 평가하는 데 더 많은 시간을 할애해야 합니다.

때로는 Node.js 패키지에 컴파일된 코드가 포함되어 있는데, 이를 위해서는 운영 체제와 명령 세트 아키텍처 호환성을 고려해야 합니다. 패키지의 코드 호환성을 평가해야 하는 경우 패키지와 해당 설명서를 검토해야 합니다. NPM의 패키지는 package.json 매니페스트 파일의 engines, os 및 cpu 필드를 통해 호환성을 지정할 수 있습니다. package.json 파일에 대한 자세한 내용은 NPM 설명서의 package.json을 참조하세요.

Node.js 런타임의 계층 경로

함수에 계층을 추가하면 Lambda는 계층 콘텐츠를 해당 실행 환경으로 추출합니다. 레이어가 특정 폴더 경로에 종속성을 패키징하는 경우 Node.js 실행 환경은 모듈을 인식하고 함수 코드에서 모듈을 참조할 수 있습니다.

모듈이 선택되도록 하려면 다음 폴더 경로 중 하나에 레이어 .zip 파일로 패키징합니다. 이러한 파일은 /opt에 저장되고 폴더 경로는 PATH 환경 변수에 로드됩니다.

예를 들어 이 자습서에서 생성하는 결과 레이어 .zip 파일의 디렉터리 구조는 다음과 같습니다.

layer_content.zip
└ nodejs
    └ node20
        └ node_modules
            └ lodash
            └ <other potential dependencies>
            └ ...

nodejs/node20/node_modules 디렉터리에 lodash 라이브러리를 넣습니다. 이렇게 하면 함수 호출 중에 Lambda가 라이브러리를 찾을 수 있습니다.

계층 콘텐츠의 패키징

이 예에서는 lodash 라이브러리를 계층 .zip 파일로 패키징합니다. 다음 단계를 완료하여 계층 콘텐츠를 설치하고 패키징합니다.

계층의 생성

이전 섹션에서 생성한 layer_content.zip 파일을 가져와 Lambda 계층으로 업로드합니다. AWS Command Line Interface(AWS CLI)를 통해 AWS Management Console 또는 Lambda API를 사용하여 계층을 업로드할 수 있습니다. 계층 .zip 파일을 업로드할 때 다음 PublishLayerVersion AWS CLI 명령에서 nodejs20.x을 호환 런타임으로, arm64를 호환 아키텍처로 지정합니다.

aws lambda publish-layer-version --layer-name nodejs-lodash-layer \
    --zip-file fileb://layer_content.zip \
    --compatible-runtimes nodejs20.x \
    --compatible-architectures "arm64"

응답에서 arn:aws:lambda:us-east-1:123456789012:layer:nodejs-lodash-layer:1처럼 보이는 LayerVersionArn에 유의하세요. 이 자습서의 다음 단계인 함수에 계층을 추가할 때 이 Amazon 리소스 이름(ARN)이 필요합니다.

함수에 계층 추가

함수 코드에 lodash 라이브러리를 사용하는 샘플 Lambda 함수를 배포한 다음 생성한 계층을 연결합니다. 함수를 배포하려면 실행 역할이 필요합니다. 자세한 내용은 실행 역할로 Lambda 함수 권한 정의 단원을 참조하십시오. 기존 실행 역할이 없으면 접을 수 있는 섹션의 단계를 따르세요. 그렇지 않은 경우 다음 섹션으로 건너뛰어 기능을 배포하세요.

샘플 함수 코드는 lodash _.findLastIndex 메서드를 사용하여 객체 배열을 읽습니다. 객체를 기준과 비교하여 일치하는 인덱스를 찾습니다. 그런 다음 Lambda 응답에서 객체의 인덱스와 값을 반환합니다.

import _ from "lodash"

export const handler = async (event) => {

  var users = [
  { 'user': 'Carlos',  'active': true },
  { 'user': 'Gil-dong',    'active': false },
  { 'user': 'Pat', 'active': false }
  ];

  let out = _.findLastIndex(users, function(o) { return o.user == 'Pat'; });
  const response = {
    statusCode: 200,
    body: JSON.stringify(out + ", " + users[out].user),
  };
  return response;
};