Docker

CLI パッケージに加えて、YAMLResume はクイックスタートを容易にするためのdocker イメージも提供しています。

ドキュメントで説明されているように、以下のコマンドを使用して yamlresume docker コンテナを実行できます：

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

しかし、興味があれば、ニーズに合わせて Docker イメージをカスタマイズできます。

Docker イメージのビルド

YAMLResume の Docker イメージは2つの段階で定義・生成されます：

Dockerfile.base

Dockerfile.base には、YAMLResume を実行するための基本環境が含まれており、TeX Live からの XeTeX や Google Noto フォント など、すべての必要な依存関係が含まれています。

これは基本イメージで、主に GitHub Actions でのビルドプロセスを加速するために使用されます。apt 経由で TeX Live 全体をインストールする（約30分かかる）代わりに、TinyTeX をインストールし、tlmgr で組み込みテンプレートが実際に必要とする 37 個の LaTeX パッケージだけをインストールします。その後、XeTeX が読まないもの——未使用のエンジン、pTeX 時代の CJK フォントツリー、ビルド時専用のツール——をすべて削除します。また、テンプレートが参照する Noto CJK SC の 4 ウェイトのみを同梱し、完全な 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 マルチプラットフォームビルドを確認する必要があるかもしれません。

Twitter でいくつかのコツを書きました。興味があればご覧ください。