AWS Lambda에서 AWS S3 파일 읽어오는 방법

📚 목차

✅ AWS 기본 세팅
1. S3 버킷 생성
2. IAM Role 생성
3. Lambda 함수 생성
4. Lambda 함수 작성

✅ AWS 기본 세팅

본격적으로 튜토리얼을 시작하기에 앞서, AWS 회원가입 및 리전 변경과 같은 기본적인 세팅이 필요합니다. 기본적인 세팅이 미비된 분들께서는 아래의 '더보기' 버튼을 클릭해 주세요.

1) 서비스 가입

먼저 AWS 홈페이지에 방문하셔서 회원가입을 하셔야 합니다. 아래와 같이 최초 가입한 이메일 계정으로 1년간 무료 체험판(a.k.a., 프리 티어)을 제공합니다. 물론 무료인 만큼 저사양 서비스 무료로 사용 가능합니다. 회원가입 시 해외 결제가 가능한 신용카드 등록이 필수입니다. 유효한 신용카드인지 100원을 결제했다가 곧바로 승인 취소되니 유효한 신용카드를 준비해 주세요.

2) 서비스 지역 변경

회원가입까지 완료하셨다면 현재 PC를 사용 중인 지역과 가장 가까운 거리에 있는 서비스 지역(Region)을 선택하셔야 합니다. 추후에 서비스 요금에 대해 살펴보겠지만, 서비스 지역마다 과금이 다르기 때문입니다. 아래와 같이, AWS 홈페이지 우측 상단에 지역 이름을 클릭하면 서비스 지역을 변경하실 수 있습니다. 대한민국에 거주하고 계시다면 Seoul을 선택해 주면 됩니다.

1. S3 버킷 생성

AWS S3 개념은 아래의 '더보기' 버튼을 클릭해 주세요.

AWS S3는 Simple Storage Service의 약어입니다. S가 3개여서 S3라고 부릅니다. S3는 이름에서부터 알 수 있듯이, 파일 서버의 역할을 하는 서비스입니다. S3는 트래픽이 급격하게 증가하더라도 장비를 추가 증설할 필요 없이도 파일 서버를 문제없이 동작시킵니다. S3는 저장할 수 있는 파일의 개수 제한이 없고, 최소 1바이트부터 최대 5 테라바이트의 데이터를 저장하고 서비스할 수 있습니다.

1) S3 콘솔 접근

AWS 검색창에 S3를 검색하고 S3 콘솔에 접근합니다(그림 1).

그림 1. S3 콘솔 접근

2) 버킷(Bucket) 생성

그림 2의 우측에 "버킷 만들기"를 클릭합니다.

그림 2. 버킷 만들기 클릭

3) 버킷 이름 설정

직관적으로 알아볼 수 있는 이름으로 네이밍합니다(그림 3).

그림 3. 버킷 이름 설정

4) 버전 관리 및 암호화 활성화

아래의 그림 4처럼, 버킷 버전 관리 및 서버 측 암호화를 활성화합니다. 이제 맨 우측 하단에 "버킷 만들기"를 클릭합니다.

그림 4. 버전 관리 및 암호화 활성화

4) 파일 업로드

업로드 버튼을 클릭하여 테스트용 텍스트 파일을 업로드합니다(그림 5).

그림 5. 파일 업로드

 

2. IAM Role 생성

IAM은 Identity and Access Management의 약자로, 특정 사용자나 그룹의 서비스 혹은 리소스에 대한 접근 권한을 관리하는 서비스입니다. IAM 서비스에 대한 자세한 개념 설명은 이곳을 참고해 주시길 바랍니다. 여기서 IAM Role(역할)은 특정 AWS 서비스의 액세스 권한을 부여하는 보안 증명서입니다. 쉽게 말해, AWS 내 어떤 서비스를 이용할 수 있는 자격을 의미합니다.

1) IAM 서비스 접근

AWS 검색창에 IAM을 입력하여 IAM 콘솔로 이동합니다(그림 6).

그림 6. IAM 콘솔 접근

2) 역할 생성

좌측에 "역할" 텍스트를 클릭하신 후, 우측에 "역할 만들기" 버튼을 눌러주세요(그림 7).

그림 7. IAM 역할 생성

3) Lamda 선택

아래의 그림 8처럼, 사용 사례는 Lambda를 사용할 예정이므로 Lambda를 선택한 후, 하단에 "다음" 버튼을 클릭합니다. AWS Lambda 개념에 대한 자세한 소개는 이곳을 참고해 주세요.

그림 8. 람다 선택

4) s3 액세스 권한 추가

권한 정책 검색창에 S3를 입력한 후 아래에 AmazonS3FullAccess를 체크합니다(그림 9). 업로드할 파일을 저장하는 서비스(S3)에 대한 모든 액세스 권한을 부여하는 것입니다.

그림 9. S3 액세스 권한 추가

5) 역할 이름 설정

아래의 그림 10처럼, 역할의 이름을 직관적으로 알아볼 수 있게 작성하신 후, 맨 하단에 "역할 생성" 버튼을 클릭합니다.

그림 10. 역할 이름 설정

3. Lambda 함수 생성

AWS Lambda에 대한 자세한 개념 설명은 아래의 포스팅을 참고해 주세요.
https://heytech.tistory.com/397

AWS Lambda 개념, 장단점, 사용목적

1) Lambda 콘솔 접근

AWS 홈페이지 검색창에서 Lambda를 검색하여 Lambda 콘솔로 이동합니다(그림 11).

그림 11. Lambda 콘솔 접근

2) Lambda 함수 생성

"함수 생성" 버튼을 클릭합니다(그림 12).

그림 12. 함수 생성

3) Lambda 함수 생성 옵션

아래의 그림 13처럼 아래의 옵션을 선택하신 후 맨 하단에 "함수 생성" 버튼을 클릭합니다.

• 함수 이름: 직관적으로 알아볼 수 있도록 작성
• 런타임: 언어 및 버전 선택(e.g., Python)
• 실행 역할: "기존 역할 사용" 선택 후 앞서 생성한 IAM Role 선택

그림 13. 람다 함수 생성 옵션

4. Lambda 함수 작성

lambda_function.py 코드입니다.

import json
import boto3
import botocore

BUCKET_NAME = 'file-upload-system-s3'
DIR_NAME = 'data/'
FILE_NAME = 'test.txt'
KEY = DIR_NAME + FILE_NAME

s3 = boto3.client('s3')

def lambda_handler(event, context):
    data = s3.get_object(Bucket = BUCKET_NAME, Key = KEY)
    res = data['Body'].read()
    print(res)
    return {
        'statusCode': 200,
        'body': json.dumps(res.decode('UTF-8'))
    }

• 1~3번째 줄: 필요 패키지 import
• 5~8번째 줄: S3 버킷 이름, 파일 디렉토리 경로, 파일명 선언
• 13번째 줄: get_object() 함수를 통해 객체 불러오기
• 14번째 줄: read() 함수는 Byte 형태로 데이터 읽어옴
• 18번째 줄: Byte 데이터를 UTF-8로 decode 하여 출력

아래의 그림 14와 같이, Deploy 버튼을 클릭합니다.

그림 14. 배포 버튼 클릭

5. 결과

아래의 그림 15와 같이, 테스트 탭으로 이동하여 테스트용 이벤트를 생성하고 우측에 테스트 버튼을 클릭합니다.

그림 15. 테스트 이벤트 생성

아래의 그림 16과 같이, 실행 결과를 보면 텍스트 파일 내 데이터가 정상적으로 출력된 것을 확인하실 수 있습니다.

그림 16. 파일 읽어오기 성공

📌 참고할 만한 포스팅

1.  파일 업로드 웹 페이지 구축: (1) React 기반 Frontend 개발
2.  파일 업로드 웹 페이지 구축: (2) AWS IAM 역할 생성
3.  파일 업로드 웹 페이지 구축: (3) AWS Lambda 생성
4.  파일 업로드 웹 페이지 구축: (4) AWS S3 생성
5.  파일 업로드 웹 페이지 구축: (5) AWS API Gateway 생성
6.  파일 업로드 웹 페이지 구축: (6) AWS Lambda 함수 작성
7.  파일 업로드 웹 페이지 구축: (7) Axios 기반 API Call
8.  파일 업로드 웹 페이지 구축: (8) 파일 업로드 테스트
9.  파일 업로드 웹 페이지 구축: (9) AWS S3 기반 웹 호스팅

---

포스팅 내용에 오류가 있거나 보완할 점이 있다면 아래에 댓글 남겨주세요!
그럼 오늘도 멋진 하루 만드시길 바랍니다 :)
고맙습니다😊