Lambda 배포 문제 해결

Lambda 배포 문제 해결 (Troubleshooting Lambda deployment)

Lambda 함수를 배포할 때 다양한 오류가 발생할 수 있어요. 이 페이지에서는 Lambda 함수 배포 중 발생하는 일반적인 문제와 해결 방법을 설명해요.

출처: AWS Lambda 개발자 안내서

본문

Lambda 함수를 배포할 때 문제가 발생하면 다음 단계를 확인해요.

배포 패키지 확인 (Check your deployment package)

  • 파일 크기 – 배포 패키지(.zip)가 Lambda 할당량 제한을 초과하지 않는지 확인해요. 직접 업로드의 경우 최대 압축 해제 크기는 250 MB예요.
  • 권한 – 배포 패키지 파일의 권한이 올바른지 확인해요.
  • 구조 – 배포 패키지의 구조가 런타임에 필요한 형식과 일치하는지 확인해요.

함수 구성 확인 (Check function configuration)

  • 핸들러 – 함수 구성의 핸들러 값이 함수 코드의 실제 핸들러 메서드와 일치하는지 확인해요.
  • 런타임 – 선택한 런타임이 함수 코드와 호환되는지 확인해요.
  • 역할 – 실행 역할이 함수가 접근해야 하는 리소스에 대한 필요한 권한을 가지고 있는지 확인해요.

일반적인 오류 (Common errors)

다음과 같은 일반적인 배포 오류가 발생할 수 있어요.

  • InvalidParameterValueException – 배포 패키지가 너무 크거나, 핸들러 이름이 잘못되었거나, 다른 구성 문제가 있을 때 발생해요.
  • ResourceConflictException – 함수가 이미 업데이트 과정에 있을 때 발생해요.
  • ServiceException – Lambda 서비스가 요청을 처리하는 중 오류가 발생했을 때 발생해요.

추가 팁 (Additional tips)

  • 배포 후 함수를 테스트해 예상대로 동작하는지 확인해요.
  • CloudWatch Logs에서 함수의 로그를 확인해 오류를 진단해요.
  • 필요하면 함수 구성을 업데이트해 다시 배포해요.

더 알아보기 (Learn more)