docs: PostgreSQL systemd 서비스 정상화 트러블슈팅 추가

troubleshooting/250730_admin_PostgreSQL_systemd정상화.md

@@ -0,0 +1,54 @@
+# PostgreSQL systemd 서비스 정상화
+
+**날짜**: 2025-07-30  
+**작업자**: admin & Claude  
+**관련 서비스**: PostgreSQL, Gitea, auth-server
+
+## 오후 11시 30분
+
+### 문제 발견
+
+서버 상태 점검 중 PostgreSQL 서비스 상태 불일치 발견:
+- 실제 프로세스는 5432 포트에서 정상 실행 중
+- `systemctl status postgresql`은 inactive (dead) 표시
+- 기능상 문제없으나 관리 일관성 부족
+
+## 오후 11시 39분
+
+### 정상화 작업
+
+**1. PostgreSQL 클러스터 확인**:
+```bash
+pg_lsclusters
+# 결과: 14  main  5432 online
+```
+
+**2. systemd 서비스 재시작 및 활성화**:
+```bash
+sudo systemctl restart postgresql@14-main.service
+sudo systemctl enable postgresql@14-main.service
+sudo systemctl restart postgresql.service
+```
+
+**3. 연동 서비스 확인**:
+- auth-server: 정상 연결 확인
+- Gitea: 111개 테이블 정상, 최근 활동 확인
+
+## 결과
+
+### 해결된 문제
+- ✅ systemctl 명령으로 PostgreSQL 제어 가능
+- ✅ 서버 재부팅 시 자동 시작 보장
+- ✅ journalctl로 통합 로그 관리 가능
+
+### 확인 사항
+- PostgreSQL 14 버전 실행 중
+- auth-server, Gitea 모두 정상 작동
+- 서비스 상태: active (running)
+
+## 교훈
+
+서비스가 실제로 작동해도 systemd 상태가 불일치하면 장기적으로 문제가 될 수 있음. 정기 점검 시 systemd 서비스 상태도 함께 확인 필요.
+
+---
+**작성 완료**: 2025-07-30 23:45