Skip to content

feat(docker): 이미지 빌드 메타데이터 기록 및 status 명령 추가#716

Merged
jk-kim0 merged 1 commit intomainfrom
fix/image-metadata-status
Feb 13, 2026
Merged

feat(docker): 이미지 빌드 메타데이터 기록 및 status 명령 추가#716
jk-kim0 merged 1 commit intomainfrom
fix/image-metadata-status

Conversation

@jk-kim0
Copy link
Copy Markdown
Contributor

@jk-kim0 jk-kim0 commented Feb 13, 2026

Summary

  • Docker 이미지에 빌드 시점을 기록하고, 실행 시 var/ 데이터 상태를 진단할 수 있는 기능 추가
  • Workflow 실행 로그에 Docker 이미지 메타데이터 로깅 추가

Background

Workflow run #21991197001에서 Docker Hub의 confluence-mdx:latest 이미지 내 var/ 데이터가 outdated 상태임을 확인:

위치 버전 수정일 내용
Docker Hub 이미지 v2 2025-07-25 오타 포함
Confluence 현재 v3 2026-02-13 교정됨

이미지의 stale 데이터를 사전에 식별하기 위한 진단 도구가 필요했습니다.

Changes

confluence-mdx/Dockerfile

  • ARG BUILD_DATE + .build-date 파일로 빌드 시점 기록

confluence-mdx/scripts/entrypoint.sh

  • full, help, fetch_cli.py 등 실행 시 Image Metadata 요약 자동 출력
  • status 명령 추가 → bin/image_status.py 실행

confluence-mdx/bin/image_status.py (신규)

  • var/ 내 모든 page.v2.yaml 스캔
  • 빌드 시점, fetch_state, 페이지 수, Age 분포, stale 후보 목록 출력

.github/workflows/generate-mdx-from-confluence.yml

  • Docker image metadata 스텝 추가 (Image Created, ID, Size 로깅)

Test plan

  • 로컬 Docker 빌드 성공 확인
  • docker run confluence-mdx:test help → Image Metadata 출력 확인
  • docker run confluence-mdx:test status → 상세 리포트 출력 확인
  • 새 이미지에서 기존 stale 데이터 (기록하고 기능입니다) 해소 확인

🤖 Generated with Claude Code

- Dockerfile: BUILD_DATE ARG로 빌드 시점을 .build-date 파일에 기록
- entrypoint.sh: full/help/fetch 실행 시 Image Metadata 요약 출력
- entrypoint.sh: `status` 명령 추가 (상세 var/ 데이터 보고서)
- bin/image_status.py: var/ 스캔하여 페이지 버전 통계, Age 분포,
  stale 페이지 후보 목록을 출력하는 진단 스크립트
- workflow: Docker image pull 후 메타데이터 로깅 스텝 추가

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@vercel
Copy link
Copy Markdown

vercel Bot commented Feb 13, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
querypie-docs Ready Ready Preview, Comment Feb 13, 2026 3:21pm

Request Review

@jk-kim0 jk-kim0 self-assigned this Feb 13, 2026
@jk-kim0 jk-kim0 merged commit b531a5c into main Feb 13, 2026
7 checks passed
@jk-kim0 jk-kim0 deleted the fix/image-metadata-status branch February 13, 2026 16:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant