AWS Elastic Beanstalk에 Python Flask 앱 배포하는 방법
AWS Elastic Beanstalk에 Python Flask 애플리케이션을 배포하면 웹 앱의 확장 및 관리가 간편해집니다. 이 가이드에서는 기본적인 Flask 앱을 빌드하고 Elastic Beanstalk에 배포하는 과정을 살펴봅니다. 서버 설정이 자동으로 처리되므로 개발자는 코드에만 집중할 수 있습니다. 사전 준비 사항으로는 Python 3.12 설치, AWS 계정, AWS CLI 및 Elastic Beanstalk CLI(eb-cli)가 필요하며, 가상 환경에 익숙하면 더욱 도움이 됩니다.
설정
프로젝트를 위한 새 디렉터리를 만들고 이동하세요. 가상 환경을 사용해 종속성을 격리하면 프로젝트를 깔끔하게 유지하고 시스템 패키지와의 충돌을 피할 수 있습니다.
mkdir flask-eb-app
cd flask-eb-app
python -m venv venv
source venv/bin/activate # Windows의 경우: venv\Scripts\activate
다음으로 Flask와 기타 필요한 패키지를 설치합니다. Flask는 웹 프레임워크를 담당하고, gunicorn은 프로덕션 환경을 위한 WSGI 서버 역할을 합니다. 이러한 도구들은 배포된 환경에서 앱이 효율적으로 실행되도록 도와줍니다.
pip install flask gunicorn
pip freeze > requirements.txt
필수 파일들로 프로젝트 구조를 초기화합니다. application.py 파일에는 Flask 코드가 담기며, requirements.txt에는 Elastic Beanstalk이 설치해야 할 종속성 목록이 포함됩니다. 이 설정을 통해 서버에서 수동으로 패키지를 관리할 필요 없이 배포 준비를 마칠 수 있습니다.
Flask 애플리케이션 생성
요청에 응답하는 간단한 Flask 앱을 작성하는 것부터 시작해 보겠습니다. 이 코드는 라우트를 정의하고 서버를 실행하며, 기본적인 기능을 보여줍니다. 구조를 이해하면 Flask가 들어오는 요청을 어떻게 처리하는지 파악하는 데 도움이 됩니다.
# application.py
from flask import Flask
app = Flask(__name__)
@app.route('/')
def home():
return "Hello, Elastic Beanstalk!"
@app.route('/health')
def health():
return "OK", 200
if __name__ == '__main__':
app.run(debug=True)
앱을 로컬에서 실행하여 제대로 작동하는지 확인하세요. 브라우저에서 http://127.0.0.1:5000/에 접속합니다. 홈 페이지에 "Hello, Elastic Beanstalk!"이 표시되면 라우트가 올바르게 설정된 것입니다.
python application.py
터미널의 예상 출력에는 "* Running on http://127.0.0.1:5000"과 같은 서버 시작 메시지가 포함됩니다. /health 라우트에 접속했을 때 200 상태 코드와 함께 "OK"가 반환되면, 나중에 배포 환경에서 헬스 체크(Health Check)용으로 유용하게 사용할 수 있습니다.
⚠️ 주의: 프로덕션 환경에서는 개발용 서버를 사용하지 마세요. 실제 트래픽을 처리하기에는 보안상 취약하고 효율적이지 않습니다. 여러 요청을 안정적으로 처리할 수 있도록 배포 시에는 gunicorn으로 전환하세요.
Elastic Beanstalk 설정
Elastic Beanstalk이 앱을 인식하려면 설정 파일이 필요합니다. .ebextensions 디렉터리를 만들고 python.config 파일을 생성하여 런타임 설정을 지정하세요. 이를 통해 Beanstalk에 Python 3.12를 사용하고 gunicorn으로 앱을 실행하도록 지시할 수 있습니다.
mkdir .ebextensions
# .ebextensions/python.config
option_settings:
aws:elasticbeanstalk:container:python:
WSGIPath: application.py
웹 프로세스를 정의하기 위해 Procfile을 추가합니다. 이 파일은 Beanstalk이 앱 모듈과 함께 gunicorn을 시작하도록 지시합니다. 이를 통해 서버에서 적절한 수의 워커(worker)와 함께 앱이 올바르게 실행되도록 보장합니다.
# Procfile
web: gunicorn -w 4 -k gevent -b 0.0.0.0:$PORT application:app
왜 gevent인가요? gevent는 기본 워커보다 비동기 작업을 더 잘 처리하므로 I/O 집약적인 앱의 성능을 향상시킵니다. Flask 서버 대신 gunicorn을 실행하여 로컬에서 테스트해 보세요.
gunicorn -w 4 -k gevent -b 0.0.0.0:8000 application:app
예상 출력에는 gunicorn이 워커를 시작하는 모습이 표시되며, http://127.0.0.1:8000/에 접속하면 동일한 "Hello, Elastic Beanstalk!" 메시지가 나타납니다. 이를 통해 배포 전 호환성을 확인할 수 있습니다.
⚠️ 주의: "ModuleNotFoundError"가 발생하면 requirements.txt에 모든 패키지가 포함되어 있는지, 가상 환경이 활성화되어 있는지 확인하세요. application.py의 import 구문이 설치된 모듈과 일치하는지도 다시 한번 점검하세요.
AWS Elastic Beanstalk에 배포하기
프로젝트 디렉터리에서 Elastic Beanstalk 환경을 초기화합니다. eb 명령어를 사용하여 새 애플리케이션을 설정하세요. 이 작업은 AWS 콘솔을 수동으로 조작하지 않고도 필요한 AWS 리소스를 생성합니다.
eb init -p python-3.12 flask-eb-app --region us-west-2
init 명령어는 AWS 자격 증명이 설정되어 있지 않은 경우 이를 입력하라는 메시지를 표시합니다. 애플리케이션 이름을 생성하고 플랫폼을 Python 3.12로 설정합니다. 설정 내용은 .elasticbeanstalk/config.yml에서 확인할 수 있습니다.
이제 환경을 생성하고 배포합니다. 이 명령어는 서버를 프로비저닝하고, requirements.txt의 종속성을 설치하며, 코드를 배포합니다. Beanstalk은 로드 밸런싱과 확장을 자동으로 처리합니다.
eb create flask-env
eb deploy
배포에는 몇 분 정도 소요됩니다. eb status로 진행 상황을 모니터링하세요. 완료되면 eb open을 입력해 브라우저에서 앱을 실행합니다. http://flask-env.eba-xxxxxxxx.us-west-2.elasticbeanstalk.com/과 같은 제공된 URL에서 "Hello, Elastic Beanstalk!"을 확인할 수 있습니다.
⚠️ 주의: 권한 오류로 배포에 실패하는 경우, AWS IAM 사용자에게 ElasticBeanstalkFullAccess 정책이 있는지 확인하세요. 또한 .ebextensions 파일에 오타가 있으면 프로세스가 중단될 수 있으니 주의해야 합니다.
테스트 및 확인
배포 후에는 앱의 엔드포인트를 테스트합니다. curl이나 브라우저를 사용해 루트 및 헬스 체크 라우트에 접속해 보세요. 이를 통해 앱이 AWS 인프라에서 예상대로 작동하고 응답하는지 확인할 수 있습니다.
curl http://flask-env.eba-xxxxxxxx.us-west-2.elasticbeanstalk.com/
예상 출력: "Hello, Elastic Beanstalk!". 헬스 체크의 경우, curl http://your-app-url/health 명령어가 "OK"를 반환해야 합니다. eb logs로 로그를 모니터링하여 문제를 디버깅하고 요청 중에 오류가 발생하지 않는지 확인하세요.
AWS 콘솔에서 인스턴스 유형을 업데이트하거나 오토 스케일링을 추가하여 환경을 확장해 보세요. 동시에 여러 요청을 보내 부하 테스트를 진행해 봅니다. 모든 응답이 올바르게 돌아온다면 배포에 성공한 것입니다.
⚠️ 주의: Beanstalk 환경은 비용이 발생합니다. 요금이 부과되지 않도록 사용하지 않는 환경은 eb terminate로 종료하세요. 새 계정에서 테스트 중이라면 항상 AWS 프리 티어 한도를 확인하시기 바랍니다.
이 튜토리얼에서는 간단한 Flask 앱을 구축하고 AWS Elastic Beanstalk에 배포하여 확장 가능한 웹 서비스를 위한 서버 관리를 자동화해 보았습니다. RDS를 통한 데이터베이스 연동이나 CodePipeline을 이용한 자동 업데이트 CI/CD를 구현하여 기능을 확장해 보세요. 환경 변수를 사용한 설정을 실험해 보면 프로덕션 환경에서 앱을 더욱 유연하게 운영할 수 있습니다.
