피드로 돌아가기
Dev.toDevOps
원문 읽기
Chromium 기반 Dockerized Action을 통한 PDF 렌더링 파이프라인 자동화
PaperQuire Render Action — PDFs in Your CI Pipeline
AI 요약
Context
Markdown 기반 문서 작성 후 PDF 변환 및 업로드 과정에서 발생하는 수동 작업으로 인한 비효율 발생. Pandoc이나 LaTeX와 같은 외부 바이너리 설치 및 환경 설정의 복잡성이 CI 파이프라인 통합의 병목 지점으로 작용함.
Technical Solution
- Node.js 및 Chromium 의존성을 사전 패키징한 Docker 컨테이너 기반의 Runtime 환경 구축
- GHCR(GitHub Container Registry) 활용을 통한 이미지 캐싱으로 빌드 시간 최적화
- Glob 패턴 매칭을 통한 다중 Markdown 파일의 일괄 렌더링 및 PDF 생성 로직 구현
- GitHub Actions의 Artifacts 및 Release API 연동을 통한 결과물 배포 자동화
pdf-files출력 변수를 통해 후속 단계에서 생성 경로를 참조하는 파이프라인 데이터 흐름 설계- 데스크톱 앱과 동일한 Chromium 엔진을 적용하여 렌더링 일관성 확보
실천 포인트
- 문서 생성 프로세스를 CI 파이프라인에 통합하여 수동 배포 리스크 제거 - 복잡한 의존성을 가진 렌더링 도구 도입 시 Docker 기반의 Action으로 캡슐화하여 환경 격리 - 생성된 파일 목록을 Output으로 정의하여 파이프라인 내 단계 간 데이터 전달 구조 설계