OllamaとGitHub Actionsを連携させる方法｜セルフホストランナーにローカルLLMを導入してPRレビューと自動要約を実装する手順

この記事のポイント

・セルフホストランナーとOllamaを同一Linuxサーバーに同居させ、PRレビューをローカルLLMで実行する
・ワークフローYAMLでgit diff取得→ollama run呼び出し→gh pr comment投稿の流れを実装する
・Gemma3:9b-instruct-q4_0がコードレビュー用途で速度・品質のバランスが取りやすい
・GITHUB_TOKEN権限のスコープとセルフホストランナーのセキュリティ設定が実運用の要

# ランナー専用ユーザーの作成
$ sudo useradd -m -s /bin/bash ghrunner
$ sudo su - ghrunner

# ランナーの作業ディレクトリ作成
$ mkdir actions-runner && cd actions-runner

# ダウンロード（URLとトークンはGitHub画面のものに差し替える）
$ curl -o actions-runner-linux-x64-2.321.0.tar.gz -L \
  https://github.com/actions/runner/releases/download/v2.321.0/actions-runner-linux-x64-2.321.0.tar.gz
$ tar xzf ./actions-runner-linux-x64-2.321.0.tar.gz

# リポジトリへの接続設定（--url と --token はGitHub画面のものを使う）
$ ./config.sh --url https://github.com/your-org/your-repo \
  --token AXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX \
  --name "llm-runner-01" --labels "self-hosted,llm" --unattended

# 接続確認
$ ./run.sh &
Connected to GitHub Actions: Running in user mode.
Listening for Jobs

$ exit  # ghrunnerユーザーから抜ける

# ランナー付属のインストールスクリプトを実行
$ sudo /home/ghrunner/actions-runner/svc.sh install ghrunner
$ sudo /home/ghrunner/actions-runner/svc.sh start
$ sudo /home/ghrunner/actions-runner/svc.sh status
* actions.runner.your-org.llm-runner-01.service - GitHub Actions Runner
     Active: active (running)

# コードレビュー用モデルをあらかじめ取得しておく
$ ollama pull gemma3:9b-instruct-q4_0

# 確認
$ ollama list
NAME                           ID              SIZE    MODIFIED
gemma3:9b-instruct-q4_0     xxxxxxxxxxxx    5.5 GB  2 minutes ago

# ローカルAPIが応答するか確認
$ curl -s http://127.0.0.1:11434/api/tags | python3 -m json.tool | head -10
{
    "models": [
        {
            "name": "gemma3:9b-instruct-q4_0",

# .github/workflows/llm-code-review.yml
name: Local LLM Code Review

on:
  pull_request:
    types: [opened, synchronize]

jobs:
  llm-review:
    runs-on: [self-hosted, llm]   # セルフホストランナーのラベル指定
    permissions:
      pull-requests: write        # PRコメント投稿に必要

    steps:
      - name: Checkout
        uses: actions/checkout@v4
        with:
          fetch-depth: 0          # 全コミット履歴を取得（diff取得に必要）

      - name: Get PR diff
        id: diff
        run: |
          git diff origin/${{ github.base_ref }}...HEAD \
            -- '*.py' '*.sh' '*.go' '*.js' '*.ts' \
            > /tmp/pr_diff.txt
          echo "lines=$(wc -l < /tmp/pr_diff.txt)" >> $GITHUB_OUTPUT

      - name: Run LLM review
        id: review
        run: |
          DIFF=$(cat /tmp/pr_diff.txt | head -300)
          PROMPT="以下のコード差分をレビューしてください。\
          バグ・セキュリティリスク・改善点を日本語で箇条書きで指摘してください。\
          問題がなければ「問題なし」とだけ返してください。\n\n${DIFF}"

          RESULT=$(curl -s http://127.0.0.1:11434/api/generate \
            -d "{\"model\":\"gemma3:9b-instruct-q4_0\",
                 \"prompt\":$(echo "$PROMPT" | python3 -c \
                   'import sys,json; print(json.dumps(sys.stdin.read()))'),
                 \"stream\":false}" \
            | python3 -c "import sys,json; print(json.load(sys.stdin)['response'])")

          echo "result<> $GITHUB_OUTPUT
          echo "$RESULT" >> $GITHUB_OUTPUT
          echo "EOF" >> $GITHUB_OUTPUT

      - name: Post review comment
        uses: actions/github-script@v7
        with:
          script: |
            const review = `${{ steps.review.outputs.result }}`;
            await github.rest.issues.createComment({
              owner: context.repo.owner,
              repo: context.repo.repo,
              issue_number: context.issue.number,
              body: `## ローカルLLMコードレビュー\n\n${review}\n\n---\n*Powered by Ollama (gemma3:9b-instruct-q4_0) on self-hosted runner*`
            });

# コンテキスト長を4096に拡張してOllama APIを呼ぶ
RESULT=$(curl -s http://127.0.0.1:11434/api/generate \
  -d "{\"model\":\"gemma3:9b-instruct-q4_0\",
       \"prompt\":$(echo "$PROMPT" | python3 -c \
         'import sys,json; print(json.dumps(sys.stdin.read()))'),
       \"options\":{\"num_ctx\":4096},
       \"stream\":false}" \
  | python3 -c "import sys,json; print(json.load(sys.stdin)['response'])")

# Modelfile の例（code-reviewer という名前で登録）
FROM gemma3:9b-instruct-q4_0

SYSTEM """
あなたは経験豊富なシニアエンジニアです。
コードの差分を受け取り、以下の観点で日本語・箇条書きでレビューしてください:
1. バグ・ロジックエラー
2. セキュリティリスク（SQLインジェクション・コマンドインジェクション・認証不備など）
3. パフォーマンス上の懸念
4. 可読性・命名・コメントの改善点
問題がなければ「問題なし」とだけ返してください。余分な挨拶・まとめ文は不要です。
"""

PARAMETER num_ctx 4096
PARAMETER temperature 0.1

# モデルを登録
$ ollama create code-reviewer -f ./Modelfile
$ ollama list | grep code-reviewer
code-reviewer    xxxxxxxxxx    5.5 GB    just now

#!/bin/bash
# review_by_file.sh
# 変更ファイルを1つずつOllamaにレビューさせてJSONに積む

CHANGED_FILES=$(git diff --name-only origin/$BASE_BRANCH...HEAD \
  -- '*.py' '*.sh' '*.go' '*.js' '*.ts')

REVIEW_RESULTS=""
while IFS= read -r file; do
  [ -z "$file" ] && continue
  DIFF=$(git diff origin/$BASE_BRANCH...HEAD -- "$file" | head -200)
  [ -z "$DIFF" ] && continue

  RESULT=$(curl -s http://127.0.0.1:11434/api/generate \
    -d "{\"model\":\"code-reviewer\",
         \"prompt\":$(printf 'ファイル: %s\n\n%s' "$file" "$DIFF" | \
           python3 -c 'import sys,json; print(json.dumps(sys.stdin.read()))'),
         \"stream\":false}" \
    | python3 -c "import sys,json; print(json.load(sys.stdin)['response'])")

  REVIEW_RESULTS+="### \`${file}\`\n${RESULT}\n\n"
done <<< "$CHANGED_FILES"

echo "$REVIEW_RESULTS" > /tmp/review_results.txt
echo "done"

# .github/workflows/llm-commit-suggest.yml（抜粋）
      - name: Suggest commit message
        id: suggest
        run: |
          DIFF=$(git diff origin/${{ github.base_ref }}...HEAD | head -150)
          PROMPT="以下のコード差分から、Conventional Commits形式の\
          コミットメッセージを1行で提案してください（日本語可）。\
          形式: type(scope): description\n\n${DIFF}"

          MSG=$(curl -s http://127.0.0.1:11434/api/generate \
            -d "{\"model\":\"code-reviewer\",
                 \"prompt\":$(echo "$PROMPT" | python3 -c \
                   'import sys,json; print(json.dumps(sys.stdin.read()))'),
                 \"stream\":false}" \
            | python3 -c "import sys,json; print(json.load(sys.stdin)['response'])")

          echo "message=$MSG" >> $GITHUB_OUTPUT

      - name: Post commit message suggestion
        uses: actions/github-script@v7
        with:
          script: |
            const msg = `${{ steps.suggest.outputs.message }}`;
            await github.rest.issues.createComment({
              owner: context.repo.owner,
              repo: context.repo.repo,
              issue_number: context.issue.number,
              body: `## コミットメッセージ案\n\`\`\`\n${msg}\n\`\`\`\n*LLMによる自動生成です。内容を確認してから使用してください。*`
            });

# ランナーサービスの状態確認
$ sudo systemctl status actions.runner.your-org.llm-runner-01.service

# 停止していたら起動
$ sudo systemctl start actions.runner.your-org.llm-runner-01.service

# ログ確認（接続エラーの原因調査）
$ sudo journalctl -u actions.runner.your-org.llm-runner-01.service -n 50

# Ollamaの稼働確認（ghrunnerユーザーで実行）
$ sudo -u ghrunner curl -s http://127.0.0.1:11434/api/tags
{"models":[...]}

# Ollamaが止まっていたら起動
$ sudo systemctl start ollama

OllamaのCI/CD組み込みと応用をハンズオンで体験する

セルフホストランナーへのOllama導入からワークフローYAMLの実装まで、手順を読むだけでなく実機で動かして習得したい方向けに、「ローカルAIマスターセミナー」を開催しています。
少人数（最大8名）ZOOMハンズオン形式で実施しています。