Pulp 패치 관리 콘솔

공식 관리 UI가 없는 Pulp 3을 운영자가 클릭만으로 다루게 해주는 사내용 얇은 관리 콘솔. 핵심 가치: 검증이 끝난 특정 스냅샷(버전)만 운영 서버에 배포되도록 사람이 통제하는 화면.

• 스택: FastAPI + HTMX + Jinja2 (프론트 빌드 단계 없음), Pulp REST API를 BFF가 프록시.
• 브라우저는 Pulp를 직접 호출하지 않는다(인증정보·CORS 보호). 정적자산은 로컬 동봉(런타임 CDN 0개).
• 자세한 스펙은 pulp-console-spec.md, 단계별 진행은 PLAN.md, 디자인 기준은 ref/.

빠른 시작 (로컬)

python -m venv .venv
.venv/Scripts/python.exe -m pip install -r requirements-dev.txt   # Windows
# (리눅스/맥: .venv/bin/pip install -r requirements-dev.txt)

# 실행
.venv/Scripts/python.exe -m uvicorn app.main:app --reload          # http://127.0.0.1:8000
# 테스트 / 린트
.venv/Scripts/python.exe -m pytest -q
.venv/Scripts/python.exe -m ruff check app tests

데모 모드 — 실제 Pulp 없이 화면을 보려면:

PULP_DEMO=true .venv/Scripts/python.exe -m uvicorn app.main:app --reload

환경변수

변수	용도	비고
PULP_BASE_URL	Pulp API 주소	예 http://repo.internal:8080
PULP_USERNAME / PULP_PASSWORD	Pulp Basic Auth	비밀번호는 git에 두지 않음
PULP_VERIFY_TLS	TLS 검증 on/off	사내 self-signed면 PULP_CA_FILE 사용
PULP_CA_FILE	사내 CA(.pem) 경로	HTTPS Pulp + 사내 CA일 때
DATABASE_URL	감사 로그용 Postgres	미설정 시 배포는 되나 감사 기록 실패 경고
PORT	서버 포트	기본 8000
PULP_DEMO	데모 모드	기본 off

헬스 / 상태

• GET /healthz — 앱 라이브니스. Pulp와 무관하게 항상 {"ok": true} (컨테이너 health check용).
• GET /pulp-status — Pulp 연결 상태 배지(대시보드가 폴링).

컨테이너 빌드 (배포 전 점검 — MANUAL §10)

podman build -t pulp-console .
podman run --rm -p 8000:8000 \
  -e PULP_BASE_URL=... -e PULP_USERNAME=... -e PULP_PASSWORD=... \
  -e DATABASE_URL="$DATABASE_URL" pulp-console
curl 127.0.0.1:8000/healthz        # {"ok":true}

Coolify 배포 (MANUAL §11–12)

1. Gitea에 push.
2. Coolify에서 Public Repository → repo 전체 URL → Build Pack: Dockerfile, Branch main, Port 8000.
3. Environment Variables에 위 표의 값 입력(PULP_*, DATABASE_URL, PORT). 비밀번호/DATABASE_URL은 여기에만.
4. 도메인은 *.apps.bokdev.in으로 지정 → Deploy.

감사 로그 (배포 기록)

배포 확정은 Postgres deploy_audit 테이블에 기록된다(누가/언제/repo/이전→대상 버전, 롤백 추적). 테이블은 최초 기록 시 자동 생성(CREATE TABLE IF NOT EXISTS). DATABASE_URL 필요.

폐쇄망 반입 (최종 산출물)

정적자산(Pico/htmx/Pretendard)은 이미 app/static/에 동봉되어 인터넷 없이 동작한다. Python 의존성만 오프라인으로 넣으면 된다 — 인터넷 가능 리눅스에서 wheelhouse를 받아 동봉:

pip download -r requirements.txt -d vendor/ \
  --platform manylinux2014_x86_64 --python-version 313 --only-binary=:all:

그리고 Dockerfile의 설치 단계를 오프라인으로 교체:

COPY requirements.txt .
COPY vendor/ ./vendor/
RUN pip install --no-cache-dir --no-index --find-links=vendor -r requirements.txt

현재(데모) 배포는 Coolify가 빌드 시 의존성을 받는 pip install 방식이다. Coolify 빌드에서 PyPI 접근이 막히면 위 wheelhouse 방식으로 전환한다.