자체 관리형 S3 코드 스토리지

기본적으로 .zip 파일 아카이브에서 Lambda 함수 또는 계층을 생성하거나 업데이트하면 Lambda는 코드 사본을 Lambda 관리형 스토리지에 저장합니다. 각 AWS 계정에는 리전별로 Lambda 관리형 스토리지에 대해 300GB의 할당량이 있습니다.

자체 관리형 S3 코드 스토리지를 사용하면 계정의 S3 버킷에서 직접 코드를 참조하도록 Lambda를 구성할 수 있습니다. Lambda는 코드 사본을 저장하지 않으므로 코드는 Lambda 관리형 스토리지 할당량에 포함되지 않습니다. Lambda는 S3 버킷에서 직접 코드에 액세스합니다.

.zip 파일 아카이브를 사용하여 생성되고 업데이트되는 모든 함수와 계층에 자체 관리형 S3 코드 스토리지를 사용할 수 있습니다. 자체 관리형 S3 코드 스토리지는 Glacier 스토리지 클래스를 제외한 모든 S3 스토리지 클래스와 호환됩니다.

자체 관리형 S3 코드 스토리지 설정

자체 관리형 S3 코드 스토리지를 사용하려면 다음 단계를 완료하세요.

권한 구성

자체 관리형 S3 코드 스토리지를 사용하려면 Lambda 서비스 위탁자(lambda.amazonaws.com)에게 소스 객체에 액세스할 수 있는 권한을 부여합니다. 다음 S3 버킷 정책을 추가합니다.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "LambdaSelfManagedCodeAccess",
      "Effect": "Allow",
      "Action": [
        "s3:GetObject",
        "s3:GetObjectVersion"
      ],
      "Resource": [
        "arn:aws:s3:::my-bucket/my-function.zip"
      ],
      "Principal": {
        "Service": "lambda.amazonaws.com"
      },
      "Condition": {
        "ArnLike": {
          "aws:SourceArn": "arn:aws:lambda:us-east-1:111122223333:function:my-function"
        }
      }
    }
  ]
}

자체 관리형 S3 스토리지를 사용하는 함수 생성

AWS CLI 또는 AWS CloudFormation으로 자체 관리형 S3 코드 스토리지를 사용하는 함수를 생성할 수 있습니다.

AWS CLI 사용

S3ObjectStorageMode=REFERENCE 파라미터와 함께 create-function 명령을 사용하세요.

aws lambda create-function \
  --function-name my-function \
  --runtime python3.12 \
  --role arn:aws:iam::111122223333:role/lambda-execution-role \
  --handler lambda_function.lambda_handler \
  --code S3Bucket=my-bucket,\
S3Key=my-function.zip,\
S3ObjectVersion=abc123def456,\
S3ObjectStorageMode=REFERENCE

자체 관리형 S3 스토리지를 사용하도록 기존 함수를 업데이트하려면

aws lambda update-function-code \
  --function-name my-function \
  --s3-bucket my-bucket \
  --s3-key my-function.zip \
  --s3-object-version abc123def456 \
  --s3-object-storage-mode REFERENCE

AWS CloudFormation 사용하기

CloudFormation 템플릿에서 AWS::Lambda::Function 리소스의 Code 속성에서 S3ObjectStorageMode를 REFERENCE로 설정합니다.

Resources:
  MyFunction:
    Type: AWS::Lambda::Function
    Properties:
      FunctionName: my-function
      Runtime: python3.12
      Handler: lambda_function.lambda_handler
      Role: !GetAtt LambdaExecutionRole.Arn
      Code:
        S3Bucket: my-bucket
        S3Key: my-function.zip
        S3ObjectVersion: abc123def456
        S3ObjectStorageMode: REFERENCE

계층과 함께 자체 관리형 S3 스토리지 사용

계층 버전에 자체 관리형 S3 코드 스토리지를 사용할 수도 있습니다. publish-layer-version 명령을 S3ObjectStorageMode=REFERENCE와 함께 사용합니다.

aws lambda publish-layer-version \
  --layer-name my-layer \
  --content S3Bucket=my-bucket,S3Key=my-layer.zip,S3ObjectStorageMode=REFERENCE \
  --compatible-runtimes python3.12

함수 코드와 계층 코드에 Lambda 관리형 스토리지와 자체 관리형 스토리지를 조합하여 사용할 수 있습니다.

스토리지 모드 간 전환

함수 코드를 업데이트하거나 새 계층 버전을 게시할 때 Lambda 관리형 스토리지와 자체 관리형 S3 코드 스토리지 간 전환이 가능합니다. S3ObjectStorageMode를 COPY 또는 REFERENCE로 설정합니다.

COPY에서 REFERENCE로 전환하면 Lambda는 소스 코드의 Lambda 관리형 사본을 삭제합니다. REFERENCE에서 COPY로 전환하면 Lambda는 Lambda 관리형 스토리지에 소스 코드의 사본을 만듭니다. Lambda 관리형 코드 스토리지 제한을 초과하면 COPY로 전환이 실패합니다.

자체 관리형 스토리지를 사용하는 함수 수명 주기

Lambda는 함수 코드를 다시 최적화하기 위해 S3 버킷의 소스 객체에 주기적으로 액세스합니다. 함수가 활성 상태를 유지하려면 소스 객체에 대한 액세스 권한을 유지해야 합니다.

교차 계정 및 교차 리전 사용량

서로 다른 계정과 리전의 S3 버킷에 있는 소스 코드에서 함수와 계층을 생성할 수 있습니다. 교차 리전 객체 검색 시 S3 데이터 전송 비용이 추가로 발생합니다. 자세한 내용은 S3 요금을 참조하세요.

고려 사항