[ARCHITECTURE] Wattup #3 OCI/VirtualBox-K8s | 하이브리드 네트워크 설계

NETWORK ARCHITECTURE

WattUp Infrastructure

OCI · Tailscale VPN · Kubernetes (VirtualBox) · Calico CNI

Architecture Diagram

트래픽 흐름

사용자 요청 경로

👤

사용자

HTTPS

☁

OCI Frontend

:80 Docker

🔒

Tailscale VPN

암호화 터널

🌐

Nginx

NodePort :30007

⚙

Backend

FastAPI / ClusterIP

📌 설계 포인트 외부로 노출되는 진입점은 Nginx NodePort 하나(30007)만 사용한다. PostgreSQL, MongoDB, Kafka, Debezium, Importer는 전부 ClusterIP로 내부 통신만 허용. OCI ↔ K8s 클러스터 간 통신은 Tailscale VPN으로 암호화.

구성 요소 상세

☁

Oracle Cloud (OCI)

무료 티어 · 프론트엔드 전용

React + Nginx를 Docker 컨테이너로 실행. VirtualBox K8s 클러스터와 분리 운영. Tailscale을 통해 백엔드와 통신.

ReactNginxPodman

🔒

Tailscale VPN

WireGuard 기반 암호화 터널

OCI 프론트엔드 ↔ VirtualBox K8s 클러스터 간 사설 네트워크 구성. 공인 IP 없이도 안전하게 내부 서비스에 접근 가능.

WireGuardZero-config

☸

Kubernetes Cluster

VirtualBox · kubeadm · Calico CNI

마스터 1대 + 워커 3대 구성. Calico CNI로 파드 간 네트워크 관리. local-path-provisioner로 PVC 처리.

master:56.10worker1~3Calico

🌐

Nginx (유일한 진입점)

NodePort 30007 · 호스트포워딩 50007

클러스터 외부와 연결되는 유일한 진입점. /api/* 요청을 backend-svc로 프록시. 나머지 모든 서비스는 ClusterIP로 격리.

NodePort:30007Reverse Proxy

🗄

PostgreSQL + MongoDB

StatefulSet + PVC · ClusterIP

PostgreSQL(PostGIS)은 공공API 원본 데이터 저장. MongoDB는 CDC로 동기화된 읽기 전용 뷰. PG → Kafka → Mongo 흐름.

PostGISStatefulSetlocal-path

🔄

Kafka + Debezium

3-node KRaft · CDC Pipeline

Debezium이 PostgreSQL 변경사항을 Kafka로 발행. Kafka 컨슈머가 MongoDB에 싱크. 3-node KRaft로 고가용성 구성.

KRaftCDC3-node HA