[Plugin] Version Release 시 대표 facade 도 함께 떨어지도록

[yspaik]

프로젝트

중부발전 2차 고도화, 삼성 디스플레이

상세 설명

Background

배경

• 현재 이미지(versioned image)와 Facade 코드는 릴리스 프로세스가 분리되어 있음
• 실질적으로 Facade 코드는 버전이 없는 것처럼 운용되고 있으며, 이미지와 느슨하게 pairing 되는 구조

문제점

• 이미지와 Facade가 명시적으로 같은 버전을 공유하지 않아, 어떤 이미지에 어떤 Facade가 대응되는지 추적이 어려움
• 운영/QA 환경에서 이미지와 Facade 조합 불일치로 인한 오류 가능성이 큼

요구사항

• 이미지 Version Release 시 대표 Facade 코드도 동일 버전으로 태깅 및 배포
• 2주마다 이미지가 Release 될 때, 동일한 버전의 대표 Facade 코드도 GenOS에 함께 반영될 것

예: genos-image:v1.6.2 릴리스 시, facade:v1.6.2 - 첨부용, facade:v1.6.2 - 적재용 같은 태그가 붙어 개발망/운영망에 전처리기 등록되는 방식

Facade 코드의 명시적 버전 관리

• Facade 저장소(또는 디렉토리)에 이미지 버전과 동일한 버전 태그/브랜치 관리
• “버전 없는 Facade” 상태를 제거하고, 항상 특정 이미지 버전과 1:1 매핑 가능하도록 할 것

Release 플로우 통합

• Release 파이프라인 상에서 이미지 빌드/배포와 Facade 코드 태깅/배포가 하나의 플로우로 동작하도록 정비

[yspaik]

Before:

• 기존 기본 전처리기 하나만 나옴

After:
3가지 유형

• 첨부용: 채팅에서 간단히 보여주기용
• 적재용: 문서 확장자별 정밀 레이아웃 분석용
• 변환 후 적재용: 비PDF를 PDF로 바꿔서 폭넓게 적재하기용
  사용자가 선택하면 그에 맞는 전처리기 코드가 syntax highlighting 됨

간단한 코드니까 중부발전 클러스터에서 PR 하려고 합니다. PR 되면
UI 기획안과 sync 바랍니다. @dkswldls100

[seongmincho315]

Refactoring Plan 반영 내용

이 이슈는 Phase 3 (2주) 에서 처리됩니다.

단일 버전 소스 전략

module/version.py 를 유일한 버전 정의 파일로 사용:

# module/version.py
__version__ = "1.6.2"
FACADE_COMPATIBLE_FROM = "1.6.0"  # 이 이미지가 지원하는 facade 최소 버전

Docker 이미지 버전 연동

# Dockerfile
ARG APP_VERSION=unknown
ENV GENOS_DOC_PARSER_VERSION=${APP_VERSION}

빌드 시:

--build-arg APP_VERSION=$(python -c "from module.version import __version__; print(__version__)")

Healthcheck 엔드포인트

/get (현재 헬스체크) 응답에 버전 정보 추가:

{
  "status": "ok",
  "version": "1.6.2",
  "facade_compatible_from": "1.6.0"
}

플랫폼에서 이미지-facade 버전 불일치를 런타임에 감지 가능.

CI 검증

pyproject.toml 버전 ≠ module/version.py 버전이면 빌드 실패:

# .github/workflows 에 추가
- name: Check version consistency
  run: |
    PYPROJECT_VER=$(python -c "import tomllib; print(tomllib.load(open('pyproject.toml','rb'))['project']['version'])")
    MODULE_VER=$(python -c "from module.version import __version__; print(__version__)")
    [ "$PYPROJECT_VER" = "$MODULE_VER" ] || (echo "Version mismatch!" && exit 1)

facade README 호환성 매트릭스 추가

## Version Compatibility
| facade version | doc-parser image |
|---|---|
| 1.6.x | >= 1.6.0 |
| 1.5.x | >= 1.5.0 |