Docker を使ったローカル検証手順

この手順はローカル環境を汚さずに、Docker コンテナ上で Jekyll ビルドと生成物の確認を行うための手順です。

• ポート：localhost:4000 を使用します（必要に応じて変更可）。
• 前提：docker がインストールされていること。

---

1. リポジトリを作業ディレクトリにする

cd /path/to/your/notes
# 例: cd ~/repos/notes

2. Jekyll イメージでサイトをビルド（生成物を _site に出力）

# Jekyll イメージを使ってビルド
docker run --rm --platform=linux/amd64 -v "$PWD":/srv/jekyll -w /srv/jekyll jekyll/jekyll:4 sh -lc 'bundle install && bundle exec jekyll build'

• 成功すると _site/ に静的ファイルが出力されます。
• Gemfile が無い場合は、リポジトリ直下に Gemfile を置いて github-pages を入れる構成にしています。

3a. Python 簡易サーバーで _site を配信（素早く確認する場合）

docker run --rm --platform=linux/amd64 -v "$PWD/_site":/srv/site -p 4000:8000 python:3.11-slim \
  python3 -m http.server 8000 --directory /srv/site

ブラウザで http://localhost:4000 を開きます。

3b. nginx で本番寄りに配信する場合

docker run --rm --platform=linux/amd64 -v "$PWD/_site":/usr/share/nginx/html:ro -p 4000:80 nginx:alpine

ブラウザで http://localhost:4000 を開きます。

4. 自動チェック（簡易スモークテスト）

• HTTP ステータスを確認:

python3 - <<'PY'
import urllib.request

with urllib.request.urlopen('http://localhost:4000/') as response:
  print(response.status)
PY

• 特定ページの存在確認:

python3 - <<'PY'
import urllib.request

with urllib.request.urlopen('http://localhost:4000/README/') as response:
  print(response.status)
PY

（パスはサイトの実際のURLに合わせて調整してください）

5. よくあるトラブルと対処

• _site が空: ビルドログを確認。docker run ... jekyll build の出力にエラーがないか確認。
• ファイル権限でホストとずれる: --user $(id -u):$(id -g) を docker run に追加するとホスト側の所有権を揃えられます。
• curl が入っていない軽量コンテナを使う場合は、上の python3 版スモークテストを使います。

6. Docker Compose で簡易化（任意）

docker-compose.yml を作る例:

version: "3.8"
services:
  jekyll:
    image: jekyll/jekyll:4
    platform: linux/amd64
    volumes:
      - ./:/srv/jekyll
    command: jekyll build
  serve:
    image: nginx:alpine
    platform: linux/amd64
    depends_on:
      - jekyll
    volumes:
      - ./_site:/usr/share/nginx/html:ro
    ports:
      - "4000:80"

使い方:

docker compose run --rm jekyll
docker compose up --remove-orphans

---

必要なら、この手順書をワークフローに組み込むための Makefile や github actions 用のステップ例も追加します。どちらを希望しますか？