Categories: 미분류

AWS Lambda로 서버 없이 API 만들기 (완전 초보용)

서버리스(Serverless)는 이제 더 이상 개발자들만의 기술이 아닙니다. 스타트업부터 대기업까지, 많은 조직이 서버리스 환경을 채택하고 있으며, 그 중심에 AWS Lambda가 있습니다. 특히, 백엔드 서버 없이도 간단하게 API를 만들 수 있다는 점은 많은 초보 개발자에게 큰 매력으로 다가오죠.

이 글에서는 AWS Lambda로 서버 없이 API 만들기 방법을 완전 초보의 시선으로 설명합니다. 처음 AWS에 접속하는 분들도 따라올 수 있도록 구성했으며, 주요 개념부터 실습까지 친절하게 다뤄드릴게요.

이 글의 목차

Toggle

서버리스란 무엇인가요? 초보도 쉽게 이해하는 서버리스 아키텍처

**서버리스(Serverless)**는 말 그대로 ‘서버가 없는’ 것이 아닙니다. 오히려 서버는 존재하지만, 개발자가 서버를 직접 관리하지 않아도 된다는 개념이 핵심입니다. AWS가 서버의 프로비저닝, 유지보수, 확장 등을 모두 대신 처리해 주기 때문에, 개발자는 오직 코드에만 집중하면 됩니다.

이런 서버리스 환경을 가능하게 해주는 서비스가 바로 AWS Lambda입니다. Lambda는 이벤트 기반으로 작동하며, 코드가 실행될 때만 비용이 발생합니다. 따라서 사용량이 적을 경우 비용 효율성도 매우 뛰어나죠.

서버리스 환경의 대표적인 장점은 다음과 같습니다:

서버 운영/유지보수 불필요
자동 확장
사용한 만큼만 비용 지불
빠른 배포 및 테스트 가능

즉, 간단한 API나 기능을 빠르게 만들고 싶은 초보자에게 더없이 좋은 구조입니다.

AWS Lambda로 서버 없이 API 만들기 개요

AWS Lambda로 API를 만들기 위해 필요한 기본 요소는 크게 세 가지입니다.

Lambda 함수: 실제 동작할 코드가 담긴 함수입니다.
API Gateway: HTTP 요청을 받아 Lambda 함수에 연결해주는 역할을 합니다.
IAM 권한 설정: 보안을 위한 사용자 권한 설정입니다.

이제, 이 세 가지 요소를 연결하여 완전한 API를 만들어보겠습니다. 이번 포스팅에서는 간단한 GET 요청 API를 만들 예정이며, 이를 통해 JSON 데이터를 응답하도록 하겠습니다.

AWS Lambda 함수 만들기 (기초부터 실습까지)

AWS 콘솔 접속 후, 검색창에 ‘Lambda’ 입력
‘함수 생성’ → ‘작성 방식: 처음부터 작성’ 선택
함수 이름: helloApiLambda
런타임: Node.js 또는 Python 선택 가능 (예제는 Node.js 사용)
역할: ‘기존 역할 사용’ 또는 ‘새 역할 생성’ 선택

예제 코드 (Node.js):

exports.handler = async (event) => {
    const response = {
        statusCode: 200,
        body: JSON.stringify({ message: "안녕하세요, Lambda에서 응답했습니다!" }),
    };
    return response;
};

함수 저장 후 테스트 이벤트 생성 (event 내용은 생략 가능)
테스트 실행 → 200 OK 응답 확인

이제 Lambda 함수는 준비 완료입니다. 다음은 이 Lambda를 HTTP API와 연결해보겠습니다.

API Gateway 연결하기 – HTTP API 만들기

AWS 콘솔에서 API Gateway로 이동
‘API 생성’ 클릭 → ‘HTTP API’ 선택
‘빠른 설정’ → 통합 유형에서 ‘Lambda 함수’ 선택
Lambda 함수 이름 입력 (helloApiLambda)
경로 설정: /hello
메서드: GET
배포 단계: default 선택 후 완료

이제 제공된 API 엔드포인트 URL로 접속하면, 실제 Lambda 함수의 응답을 볼 수 있습니다.

브라우저나 Postman에서 다음과 같이 테스트할 수 있습니다:

GET https://abcd1234.execute-api.region.amazonaws.com/hello

응답:

{ "message": "안녕하세요, Lambda에서 응답했습니다!" }

AWS Lambda와 API Gateway의 조합이 강력한 이유

초보자 입장에서 가장 좋은 점은, 복잡한 서버 설정 없이도 바로 웹 API를 만들 수 있다는 점입니다. 또한 다음과 같은 추가적인 기능도 쉽게 적용할 수 있습니다:

인증 (Cognito, JWT 등)
로깅 및 모니터링 (CloudWatch)
버전 관리 및 Canary 배포
다양한 이벤트 트리거 (S3, DynamoDB 등)

특히 서버 없이 API 만들기 구조는 확장이 매우 쉽고, 빠르게 MVP(최소 기능 제품)를 만들기에도 좋습니다.

Q&A

Q1. Lambda는 얼마나 무료로 쓸 수 있나요?

AWS Lambda는 무료 사용량이 굉장히 넉넉합니다. 매달 100만 건의 요청과 40만 GB-초의 컴퓨팅 시간을 무료로 제공합니다. 이 범위 내에서는 과금되지 않기 때문에, 작은 프로젝트나 테스트 용도로는 거의 무료라고 생각해도 무방합니다. 단, CloudWatch 로그나 API Gateway의 트래픽이 많아지면 이에 대한 소량 과금이 발생할 수 있습니다. 초보자가 실습하거나 간단한 API를 만들기에는 충분한 무료 혜택입니다.

Q2. Lambda로 만든 API는 실제 서비스에 써도 되나요?

네, 가능합니다. AWS Lambda + API Gateway 조합은 실제 프로덕션에서도 많이 사용됩니다. 다만, 고성능 트래픽이나 복잡한 인증이 필요한 경우에는 좀 더 깊은 설정과 최적화가 필요합니다. 예를 들어 응답 속도, Cold Start 문제, 보안 설정 등을 고려해야 합니다. 하지만 정적 콘텐츠 처리, 간단한 데이터 조회, 자동화 백엔드 등에서는 실제 서비스에서도 매우 안정적으로 작동합니다.

Q3. Lambda에서 다른 AWS 서비스와도 연결할 수 있나요?

당연히 가능합니다. Lambda 함수는 DynamoDB, S3, RDS, SNS, SQS 등 대부분의 AWS 서비스와 연동할 수 있도록 설계되어 있습니다. 예를 들어, Lambda에서 DynamoDB에 있는 사용자 정보를 조회하거나, S3에 저장된 이미지를 가져오는 등의 작업이 가능합니다. 이때 필요한 IAM 권한을 적절히 부여하면 쉽게 구현할 수 있습니다. 이를 통해 단일 API에서도 다양한 기능을 처리할 수 있는 유연한 구조를 만들 수 있습니다.

Q4. Lambda 함수는 언제 꺼지고, 어떻게 실행되나요?

Lambda 함수는 이벤트 기반으로 작동합니다. 즉, API Gateway나 S3 이벤트, DynamoDB 스트림 등에서 이벤트가 발생하면 Lambda 함수가 실행됩니다. 실행이 끝나면 자동으로 꺼지고, 자원은 반환됩니다. 이 덕분에 비용이 절약되고, 리소스 관리가 필요 없습니다. 다만, 첫 요청 시 약간의 지연(Cold Start)이 있을 수 있으므로, 이를 최소화하기 위한 사전 준비도 고려할 수 있습니다.

Q5. 초보자가 Lambda 배포를 자동화할 수 있을까요?

네, 가능합니다. AWS에는 SAM(Serverless Application Model) 또는 Serverless Framework와 같은 도구가 있어 Lambda 배포를 코드 기반으로 자동화할 수 있습니다. 이 도구들을 이용하면 하나의 yaml 또는 json 파일로 함수, API, 권한, 로그 설정까지 한 번에 구성할 수 있습니다. 특히 협업이나 CI/CD 파이프라인 구축 시 유용하며, 인프라를 코드로 관리할 수 있어 재현성과 유지보수 측면에서도 뛰어난 방식입니다.

huniverse4