YAMLResume

Docker

除了 CLI 包,YAMLResume 還提供了 docker 鏡像以便於快速上手。

正如我們文件中所述,您可以使用以下命令運行 yamlresume docker 容器:

docker run --rm -v $(pwd):/app -w /app yamlresume/yamlresume <command>

但是,如果您感興趣,可以自定義 Docker 鏡像以滿足您的需求。

構建 Docker 鏡像

YAMLResume 的 Docker 鏡像在兩個階段中定義和生成:

Dockerfile.base

Dockerfile.base 包含運行 YAMLResume 的基礎環境,包括所有必要的依賴,如來自 TeX Live 的 XeTeX 和 Google Noto 字體。

這是一個基礎鏡像,主要用於加速 GitHub Actions 上的構建過程。它不再透過 apt 安裝完整的 TeX Live 發行版(約需 30 分鐘),而是安裝 TinyTeX,並用 tlmgr 只安裝內建模板實際需要的 37 個 LaTeX 宏包,然後裁掉 XeTeX 永遠不會讀取的內容:未使用的引擎、pTeX 時代的 CJK 字體樹,以及僅在構建期使用的工具。它還只附帶模板引用的 4 個 Noto CJK SC 字重,而不是完整的 fonts-noto-cjk 套件。這些改動將基礎鏡像從 894 MB 縮減到 807 MB——好奇細節的話可以看看 Docker 鏡像瘦身博文。

通常您不需要自己構建這個鏡像,您可以直接重複使用 dockerhub 上發布的鏡像。

Dockerfile

Dockerfile 定義了如何構建 yamlresume/yamlresume 鏡像,它非常簡單直接,只是通過 npm install -g yamlresume@latest 從 npmjs 安裝 yamlresume,並根據 Docker 的安全最佳實踐創建必要的用戶和組。

在本地構建 yamlresume 鏡像是一個簡單的任務。您只需要運行

docker build -t yamlresume/yamlresume .

如果您遇到為不同架構構建 docker 鏡像的問題,您可能需要查看 docker 多平台構建。

我在 X 上寫了一些技巧,如果您感興趣可以看看。

Edit on GitHub

Last updated on

On this page