Files » DEVELOPMENT_DEPLOYMENT_GUIDE.md
동백쉴만한교회 CMS — 로컬 개발환경 및 신규 운영 서버 구축·배포 가이드
문서 버전: 0.1 / 2026-10-12
대상 저장소: https://github.com/GilbertMoon/dbresting-website
서비스 도메인: https://dbresting.com / https://www.dbresting.com
상태: 실행 가이드 초안. 현재 저장소는 요구사항 중심으로, Django 소스·Dockerfile·Compose·CI/CD workflow는 아직 구현되지 않았다. 아래 일부 명령은 해당 파일이 생성된 뒤에만 실행 가능하다. 이 문서를 추가하는 행위가 서버 배포를 수행하는 것은 아니다.
1. 목표와 배포 방식
목표: 신규 Cafe24 Linux VPS에서 먼저 HTTP/HTTPS 및 임시 페이지를 확인하고, 이후 Django + Wagtail + PostgreSQL을 배포하여 /admin/ 로그인과 주보·메뉴 CMS 기능을 점진적으로 검증한다.
권장 구성:
- 로컬: Windows 11, PowerShell, Git, VS Code, Python 3.12, Python venv, PostgreSQL 16, Node.js(프런트 빌드가 필요한 경우만).
- 운영: Ubuntu Server 24.04 LTS, Docker Engine + Docker Compose plugin, Nginx(호스트), Certbot, Django/Gunicorn 컨테이너, PostgreSQL 컨테이너, 볼륨 기반 미디어/DB 데이터.
- CMS: Django + Wagtail(최종 PoC 승인 전 후보), PDF: WeasyPrint(별도 검증).
- 배포: GitHub Actions에서 테스트, 운영 서버는 제한된 SSH 배포 계정으로 pull/build/up; 운영 DB 마이그레이션은 사전 백업 및 승인 절차 후 수행.
- 운영·개발 환경 비밀키와 DB를 절대 공유하지 않는다.
전제 확인: 서버 공인 IPv4, Cafe24 계정/SSH 접속 권한, 도메인 DNS 관리 권한, GitHub 비공개 저장소 접근 수단, 관리자 이메일, 서버 방화벽 포트 22/80/443, 운영 서비스 백업 대상 확보.
2. 작업 체크포인트
| 단계 | 완료 기준 |
|---|---|
| A 서버 | SSH 접속, Ubuntu 버전·디스크·시간 확인 |
| B DNS | dbresting.com/www가 서버 공인 IP로 조회 |
| C HTTP | http://dbresting.com/ 에서 임시 페이지 표시 |
| D HTTPS | 유효한 TLS 인증서로 https://dbresting.com/ 접속 |
| E 로컬 | Python venv, DB 연결, Django 개발 서버 실행 |
| F 앱 | Wagtail /admin/ 및 기본 페이지 실행 |
| G 운영 | Gunicorn 컨테이너, DB, Nginx 연동 |
| H CI/CD | 테스트 PASS, 승인된 배포, HTTPS 확인 |
| I 운영 | 백업·복구·로그·인증서 갱신 검증 |
각 단계의 정상 결과를 확인하기 전 다음 단계로 넘어가지 않는다.
3. Cafe24 신규 VPS 준비
3.1 서버 생성 시 선택
- Cafe24에서 Linux VPS를 생성한다. Ubuntu 24.04 LTS가 선택 가능하면 OS만 설치(PHP/APM 묶음 불필요).
- 초기 권장: 2 vCPU, RAM 4GB 이상, SSD 40GB 이상. 실제 사양은 사용량에 맞춰 조정한다.
- 공인 IPv4, SSH 접속 포트, 관리자 계정, 초기 비밀번호 또는 SSH 키를 확인한다.
- Cafe24 관리 패널의 방화벽/보안 그룹에서 TCP 22(관리 IP만), 80, 443 허용. DB 5432와 Gunicorn 8000은 외부에 공개하지 않는다.
- 서버 공인 IP는 아래 문서에서
SERVER_IP로 표기한다. 실제 IP를 GitHub 문서에 기록하지 않아도 된다. - Ubuntu 제공 여부, VPS 콘솔, 기본 사용자명, 방화벽 UI는 Cafe24 상품별로 다를 수 있으므로 실제 패널에서 확인한다.
3.2 Windows PowerShell에서 접속
첫 연결 시 서버 호스트키 지문을 Cafe24 콘솔/별도 안전한 경로와 대조한 후 승인한다.
서버에서:
정상 결과: Ubuntu 24.04 계열, 디스크/메모리 확인, 시간 동기화 활성.
3.3 OS 업데이트 및 기본 보안
sudo apt update
sudo apt upgrade -y
sudo apt install -y git curl ca-certificates gnupg ufw nginx certbot python3-certbot-nginx
sudo systemctl enable --now nginx
sudo ufw allow OpenSSH
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable
sudo ufw status verbose
주의: SSH가 22가 아닌 사용자 지정 포트면 OpenSSH 대신 실제 포트를 먼저 허용한다. UFW 활성화 전 두 번째 SSH 세션으로 재접속 가능 여부를 확인한다. Cafe24 외부 방화벽과 OS 방화벽을 모두 점검한다.
관리자 계정의 SSH 키 인증, 비밀번호 로그인 제한, root 직접 로그인 제한은 키 접속이 검증된 뒤 단계적으로 적용한다. 자동화 배포용 계정은 최소 권한으로 별도 생성한다.
4. 도메인 DNS 연결
4.1 DNS 관리 화면
도메인을 구매·관리하는 서비스의 DNS 레코드 편집 화면으로 이동한다. Cafe24에서 구매했더라도 네임서버가 다른 곳이면 실제 권한 있는 DNS 제공자에서 수정한다.
권장 레코드(예시):
| 타입 | 호스트 | 값 | 비고 |
|---|---|---|---|
| A | @ | <SERVER_IP> |
루트 도메인 |
| CNAME | www | dbresting.com |
www 별칭 |
| AAAA | @/www | 미설정 또는 실제 작동하는 IPv6 | 오래된 AAAA 레코드 주의 |
기존 웹서비스·메일 레코드(MX/TXT/SPF/DKIM/DMARC)는 함부로 삭제하지 않는다. Cloudflare 등 프록시가 있다면 인증서 발급 전에 DNS-only 또는 적절한 검증 방식을 검토한다.
4.2 Windows에서 확인
nslookup dbresting.com
nslookup www.dbresting.com
Resolve-DnsName dbresting.com -Type A
Resolve-DnsName dbresting.com -Type AAAA
정상 결과: A 레코드가 운영 VPS 공인 IP로 연결되고, 유효하지 않은 AAAA 레코드가 없다. DNS 전파는 TTL·캐시에 따라 지연될 수 있다.
5. HTTP 임시 페이지 배포 — 애플리케이션 없어도 즉시 검증
서버에서:
sudo mkdir -p /var/www/dbresting-bootstrap
echo '<!doctype html><html lang="ko"><meta charset="utf-8"><title>동백쉴만한교회</title><body><h1>동백쉴만한교회</h1><p>서버 연결 테스트 성공</p></body></html>' | sudo tee /var/www/dbresting-bootstrap/index.html >/dev/null
sudo tee /etc/nginx/sites-available/dbresting.conf >/dev/null <<'EOF'
server {
listen 80;
server_name dbresting.com www.dbresting.com;
root /var/www/dbresting-bootstrap;
index index.html;
location / { try_files $uri $uri/ =404; }
}
EOF
sudo ln -s /etc/nginx/sites-available/dbresting.conf /etc/nginx/sites-enabled/dbresting.conf
sudo nginx -t
sudo systemctl reload nginx
sites-enabled/dbresting.conf가 이미 존재하면 symlink 명령은 건너뛴다. 기본 사이트가 혼동을 주면 해당 서버에서 기본 Nginx 설정의 우선순위를 점검한다.
Windows에서:
정상 결과: HTTP/1.1 200 OK; 브라우저에 서버 연결 테스트 성공 표시.
실패 시: sudo systemctl status nginx, sudo journalctl -u nginx -n 50 --no-pager, DNS, Cafe24 방화벽, UFW 확인.
6. 무료 TLS 인증서 발급 및 자동 갱신
사전 조건: 80/443 포트 외부 접속 가능, 루트/www DNS 모두 정상, Nginx HTTP 임시 페이지 동작.
Certbot 프롬프트에서 실제 운영 관리자 이메일을 입력하고 약관을 확인한다. 두 도메인 모두 DNS가 연결되지 않았다면 www를 포함하지 않고 루트만 먼저 발급한 뒤 나중에 확장한다.
검증:
sudo nginx -t
sudo systemctl reload nginx
sudo certbot certificates
sudo certbot renew --dry-run
curl -I https://dbresting.com/
curl -I https://www.dbresting.com/
정상 결과: 브라우저 자물쇠/유효한 인증서, HTTPS 200, HTTP는 HTTPS로 리다이렉트. www를 루트로 통일할지는 별도 Nginx 리다이렉트 정책으로 확정한다.
인증서 자동 갱신 타이머:
갱신 방식은 패키지/OS에 따라 timer 또는 cron일 수 있다. renew --dry-run이 성공해야 한다. 포트 80 차단 시 HTTP-01 갱신이 실패할 수 있다.
7. Windows 로컬 개발환경
7.1 필수 설치
- Git for Windows: https://git-scm.com/downloads/win
- Python 3.12: https://www.python.org/downloads/
- VS Code: https://code.visualstudio.com/
- PostgreSQL: https://www.postgresql.org/download/windows/
- (선택) Docker Desktop: https://www.docker.com/products/docker-desktop/
PowerShell:
psql 명령을 찾지 못하면 PostgreSQL 설치 경로의 bin을 PATH에 추가하거나 pgAdmin에서 접속 테스트한다.
7.2 저장소 복제 및 가상환경
mkdir C:\DEV -ErrorAction SilentlyContinue
cd C:\DEV
git clone https://github.com/GilbertMoon/dbresting-website.git
cd dbresting-website
py -3.12 -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
PowerShell 정책상 활성화가 차단되면 정책을 임의로 시스템 전체에 변경하지 말고 .\.venv\Scripts\python.exe를 직접 실행할 수 있다. 필요 시 조직 보안정책 확인 후 CurrentUser 범위에서만 변경한다.
7.3 Django/Wagtail 초기 프로젝트 생성 — 소스 생성 전용
현재 저장소에는 Django 프로젝트 코드가 아직 없다. 아래 명령은 별도 기능 구현 단계에서 실행하고, 사용 버전의 Django/Wagtail 호환성을 검증한 뒤 requirements 파일에 버전을 고정한다.
python -m pip install "Django>=5.2,<6" wagtail "psycopg[binary]" python-dotenv gunicorn
python -m wagtail start config .
wagtail start 명령의 설치 버전별 사용법을 확인하고 기존 파일 덮어쓰기 여부를 먼저 점검한다. 위 명령은 초기 스캐폴딩 예시이지, 완성된 교회 CMS가 아니다. 운영 배포 전 의존성 버전을 lock하고 개발/운영 requirements를 정리한다. Windows에서 Gunicorn은 실행하지 않고 runserver를 사용한다. WeasyPrint는 Windows에서 별도 네이티브 라이브러리가 필요할 수 있어 PDF 테스트는 Docker/Linux 환경에서 우선 검증한다.
7.4 로컬 PostgreSQL
PostgreSQL 관리 계정으로:
CREATE ROLE dbresting_dev LOGIN PASSWORD 'CHANGE_TO_STRONG_LOCAL_PASSWORD';
CREATE DATABASE dbresting_dev OWNER dbresting_dev ENCODING 'UTF8';
실제 비밀번호를 문서나 Git에 올리지 않는다.
예시 .env.local (Git에 커밋 금지):
DJANGO_DEBUG=True
DJANGO_SECRET_KEY=GENERATE_UNIQUE_LOCAL_SECRET
DJANGO_ALLOWED_HOSTS=127.0.0.1,localhost
DATABASE_URL=postgresql://dbresting_dev:URL_ENCODED_PASSWORD@127.0.0.1:5432/dbresting_dev
주의: 위 환경변수는 권장 계약 예시다. Django settings에서 직접 파싱하거나 django-environ 등으로 연결하는 코드를 구현해야 한다. 특수문자가 있는 DB 비밀번호는 URL 인코딩이 필요하다.
Django 설정 및 모델 구현 후:
python manage.py check
python manage.py migrate
python manage.py createsuperuser
python manage.py runserver 127.0.0.1:8000
정상 결과: http://127.0.0.1:8000/ 및 /admin/ 접속. 이 명령들은 manage.py가 실제 생성된 뒤에만 동작한다.
8. 운영 Docker 설치
서버에서 Docker 공식 Ubuntu 저장소 설치 절차(https://docs.docker.com/engine/install/ubuntu/)를 따른다. 배포 시점에 최신 명령을 공식 문서에서 재확인한다.
sudo apt update
sudo apt install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo ${UBUNTU_CODENAME:-$VERSION_CODENAME}) stable" | sudo tee /etc/apt/sources.list.d/docker.list >/dev/null
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo systemctl enable --now docker
sudo docker version
sudo docker compose version
주의: Docker 그룹 가입은 사실상 root 권한을 주므로 무분별하게 부여하지 않는다. Docker가 방화벽 규칙에 영향을 줄 수 있으므로 앱/DB 컨테이너 포트를 공인 인터페이스에 publish하지 않는다.
9. 운영 애플리케이션 배포 준비
9.1 디렉터리
sudo mkdir -p /opt/dbresting /var/backups/dbresting
sudo chown <DEPLOY_USER>:<DEPLOY_GROUP> /opt/dbresting
<DEPLOY_USER>, <DEPLOY_GROUP>는 실제 최소 권한 배포 계정/그룹으로 치환한다.
9.2 비공개 GitHub 저장소 접근
- 서버에 전용 읽기 전용 Deploy Key 생성 후 GitHub 저장소의 Settings → Deploy keys에 등록.
- 서버 SSH 호스트키와 GitHub 호스트키 지문을 검증한 뒤 연결.
- 배포 계정으로
git clone git@github.com:GilbertMoon/dbresting-website.git /opt/dbresting. - 개인 PAT를 서버의 shell history/스크립트에 하드코딩하지 않는다.
9.3 운영 .env (서버에만)
예시 경로 /opt/dbresting/.env.production:
DJANGO_DEBUG=False
DJANGO_SECRET_KEY=GENERATE_UNIQUE_PRODUCTION_SECRET
DJANGO_ALLOWED_HOSTS=dbresting.com,www.dbresting.com
DJANGO_CSRF_TRUSTED_ORIGINS=https://dbresting.com,https://www.dbresting.com
POSTGRES_DB=dbresting
POSTGRES_USER=dbresting
POSTGRES_PASSWORD=GENERATE_STRONG_DB_PASSWORD
DATABASE_URL=postgresql://dbresting:URL_ENCODED_PASSWORD@db:5432/dbresting
chmod 600 /opt/dbresting/.env.production 적용. GitHub Secrets/Actions 로그에 실제 값을 출력하지 않는다. 위 값은 Django settings 및 Compose와 동일한 계약으로 구현해야만 적용된다.
9.4 필요한 배포 파일 — 아직 구현 전
저장소에 다음 파일을 추가해야 한다:
Dockerfile: Python 3.12 기반, OS 패키지(WeasyPrint 의존성), pinned dependencies, non-root 사용자, Gunicorn.compose.prod.yml:web(Gunicorn) +db(PostgreSQL), DB healthcheck, 데이터/미디어 볼륨, 내부 네트워크, 재시작 정책.config/settings/production.py또는 동등 설정: DEBUG=False, ALLOWED_HOSTS, DB, STATIC_ROOT, MEDIA_ROOT, HTTPS proxy 헤더 신뢰 범위, 보안 쿠키, 로깅.requirements*.txt또는 lockfile,.env.example,.gitignore./health/또는 동등 헬스체크 엔드포인트(비밀·DB 상세정보 노출 금지)..github/workflows/ci.yml, 승인형deploy.yml.- Wagtail CMS 메뉴/페이지 타입과 주보 모듈은 별도 개발.
이 파일들이 없는 현재 상태에서 docker compose up 또는 운영 마이그레이션을 실행하지 않는다.
9.5 컨테이너/호스트 연결 정책
- DB
5432: 외부 노출 금지. - Gunicorn
8000: 호스트의 127.0.0.1:8000에만 바인딩하거나 Unix socket 이용. - Nginx: 외부 80/443, 내부
proxy_pass http://127.0.0.1:8000;. - 미디어·정적파일: 컨테이너와 Nginx 간 공유 볼륨 및 권한을 설계; 배포 때
collectstatic. - PDF 생성 파일: 영속 볼륨 또는 별도 스토리지, 백업/접근 정책 수립.
9.6 앱 배포 후 Nginx 전환
7절 임시 페이지 + HTTPS 검증이 끝나고 앱이 로컬 127.0.0.1:8000에서 응답할 때만 기존 HTTPS server 블록의 location /를 다음과 같이 변경한다:
location / {
proxy_pass http://127.0.0.1:8000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_connect_timeout 10s;
proxy_read_timeout 60s;
}
Certbot이 만든 listen 443 ssl, ssl_certificate, ssl_certificate_key, HTTP 리다이렉트 설정은 유지한다. 기존 Nginx 설정을 통째로 덮어쓰지 않는다. 정적/미디어 경로는 별도 alias로 설정하고, 비공개 파일은 직접 서빙하지 않는다. Django에서 SECURE_PROXY_SSL_HEADER를 설정할 경우 프록시 헤더를 Nginx에서만 신뢰하도록 제한한다.
sudo nginx -t && sudo systemctl reload nginx
curl -I http://127.0.0.1:8000/
curl -I https://dbresting.com/
10. 운영 첫 배포 및 DB 변경 통제
- 테스트 통과한 Git commit SHA 확정.
- 운영 DB·미디어 백업 상태 확인.
- 서버에서 해당 SHA checkout 또는 안전한 fast-forward pull.
sudo docker compose -f compose.prod.yml --env-file .env.production config로 구성 검증. config 출력에는 비밀값이 나타날 수 있으므로 공유/로그 업로드 금지.- 이미지 build 후 앱/DB 기동(파일 구현 후):
sudo docker compose -f compose.prod.yml --env-file .env.production build
sudo docker compose -f compose.prod.yml --env-file .env.production up -d
sudo docker compose -f compose.prod.yml --env-file .env.production ps
check --deploy와migrate --plan을 먼저 실행하고, 초기 빈 DB인지 확인 후 승인된 migration만 실행한다. 실제 명령은 앱 서비스명이web으로 구현된 경우:
sudo docker compose -f compose.prod.yml --env-file .env.production exec web python manage.py check --deploy
sudo docker compose -f compose.prod.yml --env-file .env.production exec web python manage.py migrate --plan
# 검토 및 백업 확인 후 승인된 경우에만:
sudo docker compose -f compose.prod.yml --env-file .env.production exec web python manage.py migrate
sudo docker compose -f compose.prod.yml --env-file .env.production exec web python manage.py collectstatic --noinput
- 관리자 생성은 초기 1회만 안전한 서버 세션에서
createsuperuser실행. - /, /admin/, /health/ 및 정적 파일 확인 후 Nginx를 앱으로 전환.
- 실패 시 이전 앱 이미지/commit으로 복귀하되 DB 마이그레이션은 자동 역실행하지 않는다. 백업·스키마 호환성을 먼저 검토한다.
11. GitHub Actions CI/CD 설계
11.1 CI — PR과 main push
- Python 버전/의존성 고정, PostgreSQL 서비스 컨테이너 테스트.
python manage.py check,python manage.py test또는 pytest, migration drift 검사, 보안/HTML sanitizer 테스트, 주보 PDF 레이아웃 테스트.- 테스트 결과 실패 시 merge/배포 차단.
- 운영 비밀값을 PR 테스트에 제공하지 않는다.
- Linux 기본 GitHub 호스팅 러너의 무료 할당량을 확인하고 Actions budget/사용량 알림을 설정한다.
11.2 CD — 안전한 첫 운영 배포
- [권장]
workflow_dispatch수동 배포 + GitHub Environmentproduction승인자 설정. - 배포 workflow는 CI PASS, 검증된 SHA, 배포 승인, 백업 확인을 요구.
- 서버 접속용 SSH 키는 GitHub Environment Secrets에 저장, 호스트키 핑거프린트 검증.
- 서버 배포 계정의 sudo/Docker 권한은 공격 표면이 크므로 최소화하고 허용 명령을 제한한다.
- 최초에는 자동 migration 금지; 변경 계획 검토·백업·승인 후 실행.
- 배포 후 HTTPS 헬스체크 실패 시 실패 알림 및 수동 복구 절차 제공.
- 무료 범위는 요금제·비공개 저장소 실행 시간·계정 총사용량에 따라 달라진다.
12. 백업·모니터링·운영 점검
12.1 백업
- PostgreSQL 논리 백업 + 미디어/PDF 파일 + 복구에 필요한 설정/비밀키를 분리된 안전한 저장소에 보관.
- 일일 백업, 보존기간, 암호화, 오프사이트 복제는 운영 정책으로 확정.
- 실제 복구 연습을 별도 환경에서 수행해 성공 여부 기록.
- 백업 파일은 공개 웹 루트에 두지 않는다.
12.2 로그/상태
sudo systemctl status nginx
sudo journalctl -u nginx -n 100 --no-pager
sudo docker compose -f /opt/dbresting/compose.prod.yml --env-file /opt/dbresting/.env.production ps
sudo docker compose -f /opt/dbresting/compose.prod.yml --env-file /opt/dbresting/.env.production logs --tail=100 web
df -h
free -h
sudo certbot renew --dry-run
로그에는 비밀번호·토큰·선교 관련 민감 정보가 남지 않도록 필터링한다.
13. 장애 진단표
| 증상 | 확인 |
|---|---|
| DNS가 이전 IP | A/CNAME/AAAA, 실제 네임서버, TTL |
| HTTP 연결 실패 | Cafe24 방화벽, UFW, Nginx 상태, 포트 80 |
| 인증서 발급 실패 | DNS·80 포트·도메인별 응답·ACME rate limit |
| HTTPS 502 | Gunicorn 실행, 127.0.0.1:8000, 컨테이너 로그 |
| Django 400 Bad Request | ALLOWED_HOSTS, 프록시 헤더 |
| CSRF 403 | CSRF_TRUSTED_ORIGINS, HTTPS, 쿠키, 프록시 설정 |
| 관리자 CSS 깨짐 | collectstatic, STATIC_ROOT, Nginx alias |
| DB 연결 실패 | Compose 네트워크, DB 서비스명, 인증정보, healthcheck |
| PDF 한글 깨짐 | 한글 폰트 설치·임베딩, WeasyPrint OS 라이브러리 |
| PDF 레이아웃 깨짐 | 용지 규격, 템플릿, 글꼴, 긴 텍스트 오버플로 |
| 배포 실패 | CI 결과, Git SHA, 권한, 이미지/디스크 용량, 앱 로그 |
14. 단계별 최종 검증 체크리스트
- Cafe24 서버 신규 생성 및 SSH 접속
- 서버 OS·리소스·방화벽 확인
- DNS A/CNAME/AAAA 검증
- Nginx 임시 페이지 HTTP 200
- Certbot HTTPS 인증서 발급 및 자동 갱신 dry-run PASS
- Windows VS Code/Python venv/PostgreSQL 준비
- Django/Wagtail 스캐폴딩 및 /admin/ 로컬 실행
- Dockerfile/Compose/설정 파일 구현 및 검증
- 운영 DB 최초 migration 승인·완료
- Nginx ↔ Gunicorn ↔ PostgreSQL 연결
- 관리자 계정 생성·로그인
- 정적파일/이미지/PDF 경로 확인
- GitHub Actions CI PASS 및 승인형 CD
- 운영 백업/복구 검증
- 사이트 공개 전 보안·접근성·주보 PDF 검수
15. 현재 시점의 다음 구현 작업
이 가이드가 완성되어도 실제 앱 파일은 자동으로 생성되지 않는다. 다음 개발 PR에서 최소 실행 가능한 Wagtail 스캐폴드 + Dockerfile + Compose + .env.example + /health/ + GitHub Actions CI를 만들고, 로컬 테스트 후 서버 연결을 검증해야 한다. 디자인과 주보 PDF는 그 다음 기능 단계에서 구현한다.
운영 주의: 실제 서버 계정, IP, SSH 키, DB 비밀번호, Django SECRET_KEY, 개인/선교사 정보는 GitHub 문서·PR·CI 로그에 기록하지 않는다.