Skip to content

README.ko.md

Latest commit

 

History

History
45 lines (35 loc) · 3 KB

README.ko.md

File metadata and controls

45 lines (35 loc) · 3 KB

texlive-node

이 프로젝트는 texlive/texlive 공식 이미지를 기반으로, Node.js 런타임과 최신 한글 폰트가 포함된 최적화된 멀티 아키텍처(amd64, arm64) Docker 이미지를 제공합니다. 스마트 버전 관리 기능을 통해 효율적인 빌드 및 배포를 지원합니다.

📦 이미지 종류 (Images)

1. 기본 이미지 (Base Image)

TeXLive의 기본 기능과 Node.js 환경이 통합된 이미지입니다.

  • 이미지 태그 패턴: ${DOCKER_ORG}/texlive-node:<texlive-version>-<node-version>
  • 핵심 전략:
    • 베이스 소스: 공식 texlive/texlive:latest를 기본으로 사용합니다. 필요시 TL2024-historic 등 특정 연도 버전 고정이 가능합니다.
    • 런타임: Node.js 최신 Stable LTS (v24.13.0+) 환경을 지원합니다.

2. 한국어 지원 이미지 (Korean Support Image)

기본 이미지 위에 한국어 렌더링을 위한 필수 패키지와 최신 폰트가 추가되었습니다.

🚀 빌드 및 CI 전략

이 프로젝트는 멀티 아키텍처(linux/amd64, linux/arm64) 도커 이미지를 효율적으로 빌드하고 배포하기 위한 통합된 CI 구조를 사용합니다.

1. 통합된 워크플로우

  • 이미지 빌드 및 배포:
    • 최신 Node.js LTS 버전을 자동 감지합니다.
    • Docker Hub에 이미지가 이미 존재하는지 확인하여 불필요한 빌드를 건너뜁니다 (Skip 로직).
    • Docker Buildx와 QEMU를 사용하여 멀티 아키텍처 Base 이미지를 빌드 및 푸시합니다.
    • 이어서 앞서 배포된 Base 이미지를 기반으로 한국어(KO) 멀티 아키텍처 이미지를 빌드 및 푸시합니다.
    • GitHub Actions 캐시(type=gha)를 적극 활용하여 빌드 속도를 극대화합니다.

2. TeXLive 버전 관리

  • 기본값 (Default): 별도의 설정이 없으면 공식 latest 태그를 사용합니다.
  • 버전 고정: 특정 연도 버전이 필요한 경우 texlive-versions.txt에 명시하면 됩니다 (예: TL2024-historic).
  • 스마트 빌드: 주간 자동 빌드 시 설정 파일에 기술된 (혹은 latest) 버전과 최신 LTS 버전을 결합하여 단일 베이스라인을 빌드합니다.

3. 수동 빌드 및 로컬 환경

  • GitHub Actions UI에서 원하는 버전 조합을 직접 입력하여 빌드할 수 있습니다.
  • 로컬 개발 시 ./build-base.sh 등에 --force 플래그를 사용하여 버전 제약 조건을 무시할 수 있습니다.