Feature #1263
openFeature #1226: [MDGU] 학사관리 시스템 v1 개발 (8주, 2026-11-05 시작)
Feature #1237: [MDGU-04] 인프라·배포 (성용)
[MDGU-04-01] VPS 생성·SSH·방화벽·DNS·Nginx 임시 페이지·HTTPS
100%
Description
목적¶
가이드 14절(AD 단계)을 수행해 개인정보 없는 임시 페이지가 HTTPS로 열리는 서버를 만듭니다.
쉬운 설명¶
서버(VPS)를 만들고 원격 접속(SSH), 방화벽, 도메인 연결, 임시 웹 페이지, HTTPS 인증서까지 한 번에 준비합니다. 개발 코드가 아니라 서버 설정 작업입니다.
기술 스택¶
기존 VPS(dbresting.com과 같은 서버, 00-01 결정), SSH 키, 방화벽, Nginx, Certbot(Let's Encrypt), DNS(A/CNAME).
예상 결과(산출물)¶
접속 가능한 서버, 방화벽(22·80·443만), g-dts.com DNS 연결, HTTPS 임시 페이지, 인증서 자동 갱신 점검 결과.
개발 작업 상세¶
- 00-01·00-03 결정에 따라 서버를 만들고 SSH 키 접속·호스트키 지문을 확인한다.
- UFW 규칙(22는 관리 IP만, 80, 443)을 설정하고 두 번째 SSH 세션으로 재접속을 확인한 뒤 활성화한다. 5432·8000은 공개하지 않는다.
- DNS A 레코드(필요 시 www CNAME)를 설정한다. 기존 MX/TXT/SPF 등은 건드리지 않는다.
- Nginx 임시 페이지(개인정보 없음)를 배포하고 HTTP 200을 확인한다.
- Certbot으로 HTTPS를 발급하고
renew --dry-run을 확인한다.
완료 기준¶
- https://g-dts.com이 임시 페이지를 보여 준다.
certbot renew --dry-run통과.- 5432·8000이 외부에 닫혀 있다.
충돌 방지(소유 범위)¶
저장소가 아닌 서버 작업입니다. 서버 접근 정보는 일감·저장소에 적지 않고 팀 비밀 저장소에서 공유합니다.
선행·후행·위험¶
선행: 00-01 배포 방식 최종 확정 (VPS vs Cloud Run)(성용, 11/06 종료) / 00-03 VPS 업체·사양·비용 승인 및 DNS 권한 확인(성용, 11/06 종료)
후행: 04-03 Dockerfile·Compose·/health/·Gunicorn·Nginx 연결·운영 설정(성용)
위험: DNS 전파·인증서 발급 지연, 기존 도메인 서비스 영향.
결과 확인 방법¶
"완료 기준"의 각 항목을 화면 또는 명령으로 직접 확인합니다.
- https://g-dts.com이 임시 페이지를 보여 준다.
certbot renew --dry-run통과.- 5432·8000이 외부에 닫혀 있다.
- 확인 결과(화면 캡처 또는 명령 출력 요약)를 일감 메모에 남긴다.
시작 전 준비¶
- 00-01·00-03 결정 내용과 팀 비밀 저장소(접속 정보 보관 위치)를 확인한다.
- 개발 가이드 7~9절을 읽는다.
- 서버 비밀번호·키·토큰은 일감, 저장소, 채팅에 적지 않는다.
작업 진행 순서¶
- "개발 작업 상세"를 순서대로 진행하며 각 단계의 명령과 결과를 기록한다.
- 한 단계가 끝날 때마다 "완료 기준"의 확인 항목을 점검한다.
- 설정 파일은 저장소에 올리고, 비밀 값은 비밀 저장소(GitHub Secrets 등)에만 둔다.
- PR로 올려 소유자 리뷰를 받고, 서버 작업 내용은 일감 메모에 남긴다.
막힐 때 확인¶
DNS 변경은 반영에 시간이 걸립니다. dig 도메인 명령으로 확인하고, 서버 비밀번호·키를 일감이나 저장소에 적지 마세요.
그래도 해결되지 않으면 일감 메모에 "무엇을 했고, 어떤 오류가 났는지"를 붙여 담당 분류 소유자 또는 팀장에게 질문하세요.
용어 풀이¶
- Nginx: 웹 요청을 받아 앱(Gunicorn)이나 정적 파일로 전달하고 HTTPS를 처리하는 웹 서버입니다.
- HTTPS: 주소창의 자물쇠 표시입니다. 통신 내용을 암호화합니다.
- DNS: 도메인 이름(예: example.com)을 서버 IP 주소로 연결해 주는 전화번호부 같은 서비스입니다.
- SSH: 원격 서버에 안전하게 접속해 명령을 입력하는 방법입니다.
- 세션: 로그인한 상태를 서버가 기억하는 방식입니다. 일정 시간이 지나면 만료됩니다.
- 방화벽: 필요한 통신 포트만 열고 나머지는 막는 서버 보호 설정입니다.
성양 Updated by 성용 양 19 days ago
- Follows Feature #1243: [MDGU-00-01] 배포 방식 최종 확정 (VPS vs Cloud Run) added
성양 Updated by 성용 양 19 days ago
- Follows Feature #1245: [MDGU-00-03] VPS 업체·사양·비용 승인 및 DNS 권한 확인 added
성양 Updated by 성용 양 19 days ago
- Precedes Feature #1265: [MDGU-04-03] Dockerfile·Compose·/health/·Gunicorn·Nginx 연결·운영 설정 added
성양 Updated by 성용 양 8 days ago
[성용] 04-01 진행 계획·착수 게이트 정리 (2026-11-09)
착수 전 확인 필요 (선행 #1243, #1245 모두 아직 미기록)
- #1243 배포 방식: 가이드 기준안(VPS + Docker Compose)과 Cloud Run(동백 프로젝트 PR #76~#78 경로)이 갈려 있어 팀장 결정 필요. Cloud Run으로 정해지면 아래 단계는 적용되지 않음.
- #1245: VPS 업체·사양(2 vCPU/4GB/40GB 이상)·월 비용 승인자, g-dts.com DNS 관리 주체(기존 MX/TXT 영향 점검), 공인 IP·SSH 키·관리 계정 보관자.
진행 순서 (개발·배포 가이드 1~4절)
- A: Ubuntu 24.04 VPS 생성, SSH 접속·OS 확인, 패키지 설치, UFW(22는 관리 IP만, 80/443, 5432·8000 비공개)
- B: DNS A 레코드(@ → 서버 IP), 필요 시 www CNAME, 기존 MX/TXT 유지
- C: Nginx HTTP 임시 페이지, curl -I http://g-dts.com/ 에서 200 확인
- D: Let's Encrypt 발급, HTTP→HTTPS 리다이렉트, certbot renew --dry-run PASS
완료 기준: HTTPS 200, HTTP→HTTPS 리다이렉트, renew dry-run PASS. 각 게이트 결과(비밀값 제외)는 이 일감에 계속 기록.
성양 Updated by 성용 양 8 days ago
[성용] 위 계획 댓글 정정 (2026-11-09)
배포 방식(#1243)은 요구사항 5절과 개발·배포 가이드가 모두 "Linux VPS + Gunicorn + Nginx + HTTPS"이므로, 이 일감은 VPS + Docker Compose를 기준안으로 진행합니다. 위 댓글의 "팀장 결정 필요, Cloud Run이면 적용되지 않음"은 확정 대기가 아니라 확인 사항으로 읽어 주세요. 다른 의견이 있으면 알려 주시고, 그 경우 04 하위 일감을 다시 정리합니다.
실제 서버 생성(게이트 A~D)은 아래 두 가지가 확인된 뒤에 진행합니다.
대학 확인 사항(운영 서버 관리 주체, 키·백업 책임)은 개발·테스트 진행을 막지 않습니다(공통 개발 기준 1절 9번, 모델 계약 4.5절). 확인 전까지 운영 배포 게이트는 닫아 두고, 서버 없이 가능한 04-03(Docker·Compose·/health/ 등)은 로컬 Docker 기준으로 먼저 준비합니다.
성양 Updated by 성용 양 7 days ago
- Description updated (diff)
- Status changed from In Progress to Resolved
- % Done changed from 0 to 100
[성용] 완료 기록 (2026-11-11)
- 서버: 기존 VPS에 학사관리 전용 경로·Compose 프로젝트로 배치(00-01 #1243). dbresting.com(127.0.0.1:8001)과 g-dts.com(127.0.0.1:8002)을 Nginx server 블록으로 분리.
- HTTPS: Let's Encrypt 인증서 발급·적용(만료 2027-02-08), Certbot 자동 갱신 등록. HTTP 요청은 HTTPS로 301.
- 확인: https://g-dts.com/health/ 200 {"status": "ok"}, 로그인 화면 200, 정적 파일 200, DB 포트 5432 외부 비노출. 웹 포트는 127.0.0.1에만 열림.
- 기존 사이트: dbresting.com, misssbin.mycafe24.com 모두 200 (배포 전후 영향 없음).
- 임시 페이지 단계는 건너뛰고 04-03 앱 컨테이너로 바로 연결함.
- 서버 IP·접속 정보는 일감에 적지 않음.
성양 Updated by 성용 양 6 days ago
[성용] 변경 기록 (2026-11-11)
- PR #33 병합(https://github.com/GilbertMoon/university-academic-system/pull/33): 기존 Certbot 로그로 g-dts.com 인증서 갱신 dry-run 성공 확인(
all simulated renewals succeeded). 운영 매뉴얼 인수표·배포 가이드의 "결과 기록 필요"를 완료로 정정. 재시험은 하지 않음