4. 내부 마이크로서비스와 웹 프레임워크(Flask·Django·FastAPI)

 

내부 마이크로서비스와 웹 프레임워크(Flask/Django/FastAPI)

---

1) 내부 마이크로서비스란? 왜 쓰는지?

내부 마이크로서비스는 “회사 내부에서만 쓰는 작은 API 서비스”라고 생각하시면 됩니다. 사용자는 보통 포털(React)이나 다른 서버가 호출하고, 서비스는 한 가지 책임(예: WHOIS 조회, VT 조회, CSV 업로드)을 깔끔하게 담당합니다.

왜 굳이 ‘내부 API’로 분리하나요?

• 경계(보안/권한)를 만들기 위해서: 외부 API 키(예: VirusTotal)를 프론트에 노출하지 않고 서버가 대신 호출합니다.
• 캐시/쿼터/타임아웃을 통제하기 위해서: 외부 호출은 느리고 실패도 나므로, 내부에서 TTL 캐시·쿼터 카운터·재시도를 일관되게 관리합니다.
• 공통 기능의 재사용: “IP 설명 채우기”는 여러 화면/잡에서 필요합니다. 한 곳에 모아두면 유지보수가 쉬워집니다.
• 배포/변경 영향 최소화: 포털 UI를 건드리지 않고도 조회 로직만 교체할 수 있습니다.

운영자 체크리스트(내부 마이크로서비스)

• 외부 호출은 timeout을 짧게(예: 3~5초) + 실패 시 graceful degrade
• 쿼터 있는 API는 일일 카운터 + 응답에 quota 정보 포함
• 캐시는 TTL 명확히(WHOIS 24h, VT 12h 등) + 캐시 미스만 외부 호출
• 로그는 journalctl로 추적 가능하게(요청 IP/경로/상태코드/에러스택)

2) 웹 프레임워크란? 정의와 사용 용도

웹 프레임워크는 라우팅(URL → 함수), 요청/응답 처리, 보안, 세션, DB 연동 같은

“반복되는 웹 작업”을 쉽게 만들어주는 틀입니다.

 

---

프레임워크를 쓰면 좋아지는 점

 

 : “HTTP 파싱/라우팅/에러 처리/미들웨어” 같은 기본 작업을 덜 하고, 업무 로직(조회·가공·정책) 에 집중할 수 있습니다.

대표 프레임워크(언어별)

Python

• Flask: 가볍고 단순(내부 도구/작은 API)
• Django: 올인원(관리자/ORM/인증 포함)
• FastAPI: 타입힌트 기반 API + 자동 문서(OpenAPI)

다른 언어

• Node.js: Express
• Java: Spring Boot
• .NET: ASP.NET Core Minimal APIs
• Go: Gin
• Ruby: Rails
• PHP: Laravel
• Rust: Actix Web

3) Flask · Django · FastAPI 비교(장단점과 사례)

 Flask

• 장점: 아주 가볍고, 필요한 것만 골라 붙이기 쉬움(“마이크로 프레임워크”).
• 단점: 인증/관리/ORM 같은 ‘기본 세트’는 직접 조합해야 함.
• 추천 사례: 사내 포털 보조 API, 운영 자동화 도구, 조회·업로드 같은 단일 기능 서비스.

Django

• 장점: 사용자/관리자/ORM/폼/보안 등 “필요한 것 대부분이 기본 제공(batteries included)”이라 웹앱 전체를 빠르게 만들기 좋습니다.
• 단점: 작은 API 하나만 필요할 때는 프레임워크가 다소 ‘크게’ 느껴질 수 있습니다.
• 추천 사례: 계정/권한/관리 화면이 중요한 내부 업무 시스템, CRUD 중심 서비스.

FastAPI

• 장점: 타입힌트 기반으로 요청 검증 + 자동 문서(OpenAPI/Swagger UI)가 자연스럽게 따라옵니다.
• 단점: “웹앱 전체(관리자/ORM/템플릿)”가 목적이면 Django가 더 편할 수 있습니다.
• 추천 사례: 스키마가 중요한 API, 외부/내부 연동이 많은 서비스.

실무 팁(초보 운영자 기준 선택법)

• “API 몇 개 + 캐시 + 파일/JSON 저장”이면 → Flask로 빠르게
• “인증/관리/DB/권한/CRUD 풀세트”면 → Django
• “API 문서/검증이 중요하고, 타입으로 안전하게”면 → FastAPI

 

4) Python이 아닌 다른 언어로도 마이크로서비스를 만들 수 있나요?

가능합니다. “팀의 스택/운영 경험/성능 요구”에 따라 선택이 갈립니다. 중요한 건 언어가 아니라 서비스 경계, 배포, 관측(로그/메트릭), 장애 격리입니다.

대표 선택지와 성격

• Node.js(Express): I/O 친화적, 빠른 개발. 팀이 JS/TS에 익숙하면 강점.
• Java(Spring Boot): 엔터프라이즈 표준에 강함(풍부한 생태계/운영 사례).
• .NET(Minimal APIs): 적은 코드로 HTTP API, Microsoft 환경과 궁합.
• Go(Gin): 빌드된 단일 바이너리, 가벼운 메모리, 높은 처리량.
• Ruby on Rails / PHP Laravel: 풀스택 웹 개발 생산성에 강함(관리/CRUD).
• Rust(Actix): 성능/안전성 강점. 대신 러닝커브가 있을 수 있습니다.

Python 기반의 장단점(운영 관점)

• 장점: 개발 속도, 라이브러리(보안/분석/자동화) 풍부, 운영 자동화에 친화적
• 주의: 매우 높은 QPS/낮은 레이턴시 극한 요구에서는 언어/런타임 선택도 영향을 줍니다(대부분은 I/O/DB가 병목)

 

마무리: “내부 마이크로서비스”를 한 문장으로

 

내부 마이크로서비스는 포털/배치/다른 서비스가 공통으로 쓰는 ‘작은 HTTP API’이고,

Flask/Django/FastAPI 같은 웹 프레임워크는 그 API를 빠르고 안전하게 만들기 위한 “틀”입니다.

 

참고 레퍼런스

• MDN — Server-side web frameworks(정의/역할)
• AWS — What are Microservices?(정의/장점)
• Martin Fowler — Microservices(개념/특징)
• Flask — GitHub
• Django — Overview
• FastAPI — Features
• Express — Official site
• Spring — Microservices
• Microsoft — ASP.NET Core Minimal APIs
• Gin (Go) — GitHub
• Ruby on Rails — Official site
• Laravel — Installation docs
• Actix Web — Official site