YAMLResume GitHub Action で履歴書のビルドを自動化する

新しい YAMLResume GitHub Action を使用して、履歴書を自動的に構築およびデプロイします

公式の YAMLResume GitHub Action を発表できることを嬉しく思います！

この新しい Action は、YAMLResume を CI/CD パイプラインにシームレスに統合することで、「Resume as Code（コードとしての履歴書）」の哲学を自然な結末へと導きます。

なぜ GitHub Action を使用するのか？

YAMLResume は世界中の GitHub のユーザーに採用されています。彼らはそれぞれ、履歴書をビルドしてデプロイするための独自のワークフローを構築しています。Makefile を使用する人もいれば、シェルスクリプトを使用する人、GitHub Actions を使用する人、GitHub Pages に公開する人もいます。

例えば：

これを統一された方法で提供する時が来ました。

yamlresume/action を使用すると、これを完全に自動化できます。更新した resume.yml を GitHub に push するだけで、Action が自動的に以下のことを行います：

  1. 履歴書を YAMLResume スキーマに照らして検証する。
  2. PDF、LaTeX、HTML、Markdown の出力をビルドする。
  3. 生成された PDF を GitHub Release に添付するか、ワークフローのアーティファクトとしてアップロードする、あるいは GitHub Pages に公開する。

理論上、もう二度とローカルで履歴書をビルドする必要はありません。

クイックスタート

Action の使い方は非常に簡単です。履歴書をビルドし、生成された PDF を GitHub Actions のアーティファクトとしてアップロードする最小限の .github/workflows/build.yml の例を以下に示します：

name: Build Resume

on:
  push:
    branches: [main]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Build resume
        id: build
        uses: yamlresume/action@v0.1.1
        with:
          resumes: resume.yml

      - name: Upload PDF
        uses: actions/upload-artifact@v4
        with:
          name: resume
          path: ${{ steps.build.outputs.pdf-files }}

主な機能

この GitHub Action は単なるラッパーではなく、実際の履歴書管理のために設計された強力な機能が備わっています：

複数の履歴書を一度にビルド

多くのユーザーは、履歴書の複数のバージョン（例：英語版と翻訳版、あるいはフロントエンド向けとバックエンド向け）を維持しています。改行区切りのリストを渡すことで、それらをすべて同時にビルドできます：

- uses: yamlresume/action@v0.1.1
  with:
    resumes: |
      resume-en.yml
      resume-zh.yml

カスタマイズ可能なビルド

独自の PDF 生成パイプラインがあり、LaTeX 出力のみが必要な場合、またはドラフト作成のためにスキーマ検証をスキップしたい場合、この Action には no-pdf および no-validate 入力が用意されており、ニーズに合わせてワークフローを調整できます。

PDF 生成のスキップ

LaTeX ファイルのみを生成する場合（カスタム PDF パイプラインに便利です）：

- uses: yamlresume/action@v0.1.1
  with:
    resumes: resume.yml
    no-pdf: true

検証のスキップ

ビルド中のスキーマ検証をスキップする場合：

- uses: yamlresume/action@v0.1.1
  with:
    resumes: resume.yml
    no-validate: true

裏側の仕組み

yamlresume/action は、以前に紹介した YAMLResume Docker イメージ を活用しています。

LaTeX ディストリビューションは非常に大きく、インストールに時間がかかる（GitHub ランナーでは 20〜30 分かかることがよくあります）ため、ランナー上で直接履歴書をビルドすると、CI パイプラインが大幅に遅くなります。事前パッケージ済みの Docker イメージを使用することで、Action は必要な環境をわずかな時間で取得し、高速で信頼性が高く、一貫したビルドを実現します。

試してみましょう！

キャリアを自動化する準備はできましたか？yamlresume/action リポジトリ をチェックして始めてください。または、GitHub Action エコシステム ドキュメント で、詳細な設定オプションや高度な使用例を確認してください。

自動化を楽しんでください！

Written by

Xiao Hanyu

At

Thu Mar 12 2026