[Cloud] ☁️ Managemet Cloud FastAPI

새기능 #44

minkyu park이(가) 21일 전에 변경

{{>toc}} 

 # 📘 Mangement Cloud server FastAPI 프로젝트 

 ## 🟦 Epic Issue 1 — FastAPI 프로젝트 구조 설계 

 
 트래커: Task 
 카테고리: FastAPI 서버 개발 

 설명: 

 
 - FastAPI 기반 mgmt 서버의 전체 디렉토리 구조를 설계한다. 
 

 - app / worker / routers / models / core 구조 정의 
 

 - Gitea 저장소 생성 
 

 - PyCharm 개발 환경 준비 
 

 - 기본 실행 구조(main.py) 설계 

 ## 🟦 Issue 2 — Django 모델 분석 및 FastAPI 모델 변환 계획 
 트래커: Task 
 카테고리: Django → FastAPI 마이그레이션 

 설명 
 기존 Django ORM 모델을 분석하고 SQLAlchemy 모델로 변환 계획을 수립한다. 

 ServerMaster 

 ServerStatus 

 ServerControl 

 ServerDetail 

 JSONField → PostgreSQL JSONB 변환 

 관계(OneToOne, ForeignKey) 매핑 방식 정의 

 ## 🟦 Issue 3 — FastAPI 기본 서버 구축 
 트래커: Feature 
 카테고리: FastAPI 서버 개발 

 설명 
 FastAPI 기본 서버를 구축한다. 

 /ping 

 /server/list 

 /server/status/{hostname} 

 uvicorn 실행 테스트 

 test_main.http 테스트 

 ## 🟦 Issue 4 — PostgreSQL 연결 및 SQLAlchemy 모델 생성 
 트래커: Feature 
 카테고리: DB(PostgreSQL) 

 설명 
 PostgreSQL 연결 및 SQLAlchemy 모델을 생성한다. 

 DB 연결 테스트 

 SQLAlchemy Base 생성 

 모델 매핑 

 JSONB 필드 테스트 

 ## 🟦 Issue 5 — MQTT Worker 독립 프로세스 설계 
 트래커: Feature 
 카테고리: MQTT Worker 

 설명 
 MQTT worker를 FastAPI와 분리된 독립 프로세스로 설계한다. 

 asyncio-mqtt 사용 

 메시지 수신 구조 설계 

 DB 업데이트 방식 결정 

 FastAPI와 연동 방식 정의(API 호출 vs DB 직접 업데이트) 

 ## 🟦 Issue 6 — Reverse SSH 구조 설계 
 트래커: Task 
 카테고리: Reverse SSH 

 설명 
 Reverse SSH 기능을 FastAPI에서 제어할 수 있도록 구조를 설계한다. 

 포트 관리 

 세션 관리 

 FastAPI 제어 API 설계 

 로컬 테스트 플로우 정의 

 ## 🟦 Issue 7 — AlmaLinux 서버 2대 구성 계획 
 트래커: Task 
 카테고리: 서버 분리(1GB × 2대) 

 설명 
 서버를 2대로 분리하고 1GB 메모리 기준으로 최적화한다. 

 mgmt + worker 서버 

 lotto + pwa 서버 

 systemd 서비스 구성 

 메모리 최적화 계획 

 ## 🟦 Issue 8 — journald / systemd 최적화 계획 
 트래커: Task 
 카테고리: AlmaLinux 환경 구성 

 설명 
 AlmaLinux에서 journald 및 systemd 최적화를 수행한다. 

 journald 메모리 제한 

 로그 로테이션 

 systemd 서비스 파일 설계 

 gunicorn/uvicorn 서비스 구성 

 ## 🟦 Issue 9 — Django → FastAPI 마이그레이션 체크리스트 작성 
 트래커: Task 
 카테고리: Django → FastAPI 마이그레이션 

 설명 
 Django에서 FastAPI로 전환하기 위한 전체 체크리스트를 작성한다. 

 기능 비교 

 API 매핑 

 DB 스키마 비교 

 MQTT 로직 분리 

 reverse SSH 기능 이전 

 배포 플로우 정의 

 ## 🟦 Issue 10 — 전체 아키텍처 문서화 
 트래커: Documentation 
 카테고리: 문서화 

 설명 
 FastAPI mgmt 서버 + MQTT worker + PostgreSQL + reverse SSH + 서버 분리 구조를 문서화한다. 

 전체 아키텍처 다이어그램 

 데이터 흐름 

 서버 구성 

 배포 전략 

 운영 가이드

뒤로