Project

General

Profile

Actions

Feature #1263

open
성양 성양

Feature #1226: [MDGU] 학사관리 시스템 v1 개발 (8주, 2026-11-05 시작)

Feature #1237: [MDGU-04] 인프라·배포 (성용)

[MDGU-04-01] VPS 생성·SSH·방화벽·DNS·Nginx 임시 페이지·HTTPS

Feature #1263: [MDGU-04-01] VPS 생성·SSH·방화벽·DNS·Nginx 임시 페이지·HTTPS

Added by 성용 양 19 days ago. Updated 6 days ago.

Status:
Resolved
Priority:
Normal
Assignee:
Start date:
11/09/2026
Due date:
11/13/2026 (4 days late)
% Done:

100%

Estimated time:

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 임시 페이지, 인증서 자동 갱신 점검 결과.

개발 작업 상세

  1. 00-01·00-03 결정에 따라 서버를 만들고 SSH 키 접속·호스트키 지문을 확인한다.
  2. UFW 규칙(22는 관리 IP만, 80, 443)을 설정하고 두 번째 SSH 세션으로 재접속을 확인한 뒤 활성화한다. 5432·8000은 공개하지 않는다.
  3. DNS A 레코드(필요 시 www CNAME)를 설정한다. 기존 MX/TXT/SPF 등은 건드리지 않는다.
  4. Nginx 임시 페이지(개인정보 없음)를 배포하고 HTTP 200을 확인한다.
  5. 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 전파·인증서 발급 지연, 기존 도메인 서비스 영향.

결과 확인 방법

"완료 기준"의 각 항목을 화면 또는 명령으로 직접 확인합니다.

  1. https://g-dts.com이 임시 페이지를 보여 준다.
  2. certbot renew --dry-run 통과.
  3. 5432·8000이 외부에 닫혀 있다.
  4. 확인 결과(화면 캡처 또는 명령 출력 요약)를 일감 메모에 남긴다.

시작 전 준비

  1. 00-01·00-03 결정 내용과 팀 비밀 저장소(접속 정보 보관 위치)를 확인한다.
  2. 개발 가이드 7~9절을 읽는다.
  3. 서버 비밀번호·키·토큰은 일감, 저장소, 채팅에 적지 않는다.

작업 진행 순서

  1. "개발 작업 상세"를 순서대로 진행하며 각 단계의 명령과 결과를 기록한다.
  2. 한 단계가 끝날 때마다 "완료 기준"의 확인 항목을 점검한다.
  3. 설정 파일은 저장소에 올리고, 비밀 값은 비밀 저장소(GitHub Secrets 등)에만 둔다.
  4. PR로 올려 소유자 리뷰를 받고, 서버 작업 내용은 일감 메모에 남긴다.

막힐 때 확인

DNS 변경은 반영에 시간이 걸립니다. dig 도메인 명령으로 확인하고, 서버 비밀번호·키를 일감이나 저장소에 적지 마세요.

그래도 해결되지 않으면 일감 메모에 "무엇을 했고, 어떤 오류가 났는지"를 붙여 담당 분류 소유자 또는 팀장에게 질문하세요.

용어 풀이

  • Nginx: 웹 요청을 받아 앱(Gunicorn)이나 정적 파일로 전달하고 HTTPS를 처리하는 웹 서버입니다.
  • HTTPS: 주소창의 자물쇠 표시입니다. 통신 내용을 암호화합니다.
  • DNS: 도메인 이름(예: example.com)을 서버 IP 주소로 연결해 주는 전화번호부 같은 서비스입니다.
  • SSH: 원격 서버에 안전하게 접속해 명령을 입력하는 방법입니다.
  • 세션: 로그인한 상태를 서버가 기억하는 방식입니다. 일정 시간이 지나면 만료됩니다.
  • 방화벽: 필요한 통신 포트만 열고 나머지는 막는 서버 보호 설정입니다.

Related issues 3 (3 open — 0 closed)

Follows Feature #1243: [MDGU-00-01] 배포 방식 최종 확정 (VPS vs Cloud Run)Resolved성용 양11/05/202611/06/2026

Actions
Follows Feature #1245: [MDGU-00-03] VPS 업체·사양·비용 승인 및 DNS 권한 확인In Progress성용 양11/05/202611/06/2026

Actions
Precedes Feature #1265: [MDGU-04-03] Dockerfile·Compose·/health/·Gunicorn·Nginx 연결·운영 설정Resolved성용 양11/20/202611/25/2026

Actions

성양 Updated by 성용 양 19 days ago Actions #1

  • Follows Feature #1243: [MDGU-00-01] 배포 방식 최종 확정 (VPS vs Cloud Run) added

성양 Updated by 성용 양 19 days ago Actions #2

  • Follows Feature #1245: [MDGU-00-03] VPS 업체·사양·비용 승인 및 DNS 권한 확인 added

성양 Updated by 성용 양 19 days ago Actions #3

  • Precedes Feature #1265: [MDGU-04-03] Dockerfile·Compose·/health/·Gunicorn·Nginx 연결·운영 설정 added

성양 Updated by 성용 양 14 days ago Actions #4

  • Assignee changed from 서현 임 to 성용 양

성양 Updated by 성용 양 14 days ago Actions #5

  • Due date changed from 11/10/2026 to 11/13/2026
  • Start date changed from 11/04/2026 to 11/09/2026

성양 Updated by 성용 양 14 days ago Actions #6

  • Description updated (diff)

설명 보강: 쉬운 설명, 확인 방법, 시작 전 준비, 작업 순서, 막힐 때, 용어 풀이 추가. 담당자·날짜·선행 관계 최신화

성양 Updated by 성용 양 14 days ago Actions #7

  • Description updated (diff)

검수 반영: 선행 관계·일정·담당 최신화, 결과 확인 방법을 완료 기준 기준으로 정리

성양 Updated by 성용 양 8 days ago Actions #8

  • Status changed from New to In Progress

04-01 착수 (2026-11-09). 배포 가이드 14절(VPS·SSH·DNS·Nginx 임시 페이지·Let's Encrypt, 게이트 AD) 기준으로 진행. 선행 00-01·00-03 승인 항목(업체·사양·비용·DNS 담당)은 확인 후 기록 예정.

성양 Updated by 성용 양 8 days ago Actions #9

[성용] 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 Actions #10

[성용] 위 계획 댓글 정정 (2026-11-09)

배포 방식(#1243)은 요구사항 5절과 개발·배포 가이드가 모두 "Linux VPS + Gunicorn + Nginx + HTTPS"이므로, 이 일감은 VPS + Docker Compose를 기준안으로 진행합니다. 위 댓글의 "팀장 결정 필요, Cloud Run이면 적용되지 않음"은 확정 대기가 아니라 확인 사항으로 읽어 주세요. 다른 의견이 있으면 알려 주시고, 그 경우 04 하위 일감을 다시 정리합니다.

실제 서버 생성(게이트 A~D)은 아래 두 가지가 확인된 뒤에 진행합니다.

  • 서버 비용 승인자·결제 담당자 (#1245)
  • g-dts.com DNS 관리자와 기존 서비스(MX·TXT 등) 영향 확인 (#1245)

대학 확인 사항(운영 서버 관리 주체, 키·백업 책임)은 개발·테스트 진행을 막지 않습니다(공통 개발 기준 1절 9번, 모델 계약 4.5절). 확인 전까지 운영 배포 게이트는 닫아 두고, 서버 없이 가능한 04-03(Docker·Compose·/health/ 등)은 로컬 Docker 기준으로 먼저 준비합니다.

성양 Updated by 성용 양 7 days ago Actions #11

  • 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 Actions #12

[성용] 변경 기록 (2026-11-11)

Actions

Also available in: PDF Atom