2020년에 Podman을 처음 접한 것은 의도치 않은 경험이었습니다. 저희는 컨테이너화된 마이크로서비스 스택을 배포해야 하는, 에어 갭(air-gapped) 환경의 RHEL 7 장비가 있는 고객사를 맡았습니다. Docker와 같은 서드파티 소프트웨어를 설치하는 것은 큰 관료적 장애물이 될 수 있었기 때문에, 저희는 기본적으로 내장된 기능을 살펴볼 수밖에 없었습니다.

이 도구들은 사용 방식에 따라 몇 가지 독특한 점(quirks)들이 있었습니다. 하지만 Podman 생태계의 전반적인 데몬리스(daemonless) 아키텍처는 처음부터 올바르게 느껴졌습니다. 그리고 말할 필요도 없이, 해당 고객 프로젝트의 현재 버전은 오늘날까지도 Podman으로 운영되고 있습니다. 게다가 이보다 훨씬 더 많은 인스턴스들이 뒤따랐습니다.

좋은 기술 서적에 관심이 많았던 저는 첫 생각이 들었습니다: 누군가 이 훌륭한 공학적 산물(piece of engineering)에 대한 책을 써야 한다고. 그래서 저는 개요를 작성하고, 첫 장들을 쓰고, 도메인을 구매하고, 다시 시작했지만, 삶(그리고 일)이 방해가 되었고, 그 외의 여러 일이 있었습니다. 물론 그 사이에 꽤 많은 Podman 관련 서적들이 출판되었고, 저는 대부분을 구매했다고 생각합니다.

제 책 프로젝트가 마침내 출판 버전까지 도달할 만큼 충분한 추진력을 얻게 된 것은 두 가지였습니다: 다가오는 (이미 출시된) Podman 버전 6에 대한 개인적인 관심과 프론티어 LLM(frontier LLMs)의 발전이었습니다.

AI는 출판 과정의 모든 단계에 참여했습니다. 아래 다이어그램은 전체 도구 체인(toolchain)을 보여줍니다: Markdown 소스 및 실행 가능한 예제는 소스 게이트(just check)를 통과하고, 빌드는 출처가 기록된 PDF/EPUB을 생성하며, 아티팩트 게이트(just check-artifacts)가 결과를 확인하고, just release는 모든 것을 Polar로 전송하며, just verify-polar는 --buyer-path를 사용한 실제 구매자 결제까지 포함하여 Polar가 실제로 제공하는 것을 확인합니다.

The whole toolchain, from Markdown sources to the buyer's download

예제의 검증은 모든 just check에서 빠른 로컬 게이트를 거치고, Fedora 실험실 호스트에서의 라이브 감사(136회 기록된 실행, 실패는 실제 결함과 실험실 아티팩트로 분류)를 거치며, 그 보고서는 구매자 zip 파일 안에 포함됩니다.

How the runnable examples are verified and shipped

빌드 파이프라인의 경우, md2pdf(제가 책과 독립적으로 작성한 CLI Markdown-to-PDF 변환기)가 챕터를 발견하고, 메타데이터를 병합하며, 다이어그램 울타리(diagram fences)를 미리 렌더링한 다음, pandoc을 한 번 실행합니다. 이 과정에서 인쇄용 KOMA book 템플릿이 적용된 LuaLaTeX와 리플로우 가능한 에디션을 위한 epub3가 생성됩니다 (메타데이터와 개요는 동일한 실행에서 포함되므로).

Inside the md2pdf build pipeline

릴리스 흐름은 다음과 같습니다: 하나의 고정된 커밋, 플래그 없음. 두 게이트가 모두 녹색이고, 출처 스탬프(provenance stamps)가 검증되면 PDF + EPUB + 새로 빌드된 예제 zip 파일이 업로드됩니다. 그런 다음 다운로드 가능한 링크의 목적지가 변경되고 이전 파일들은 삭제되어 기존 구매자들의 링크는 계속 작동합니다.

The release flow to Polar

네, 정말 속임수처럼 느껴집니다. 하지만 출판 파이프라인을 구축하고 타이포그래피를 조정하는 것만으로도 저에게는 며칠 대신 몇 주가 걸렸을 것입니다.

고품질의 기술 문서 작성에 관심이 있으시다면 (AI 시대에 여전히 누군가가 그것이 필요한지 논하는 것은 나중으로 미루겠습니다), 언제든지 저에게 연락해 주세요.

물론, 책의 샘플 챕터를 보고 싶으시면 책의 랜딩 페이지에서 확인하실 수 있습니다: podman-book.com

(다이어그램은 클릭 가능한 링크입니다 — 전체 해상도의 벡터 이미지를 보려면 아무거나 열어보세요.)

원래는 sysop.cafe에서 게시되었습니다.