プロジェクトで jpegoptim による JPEG 最適化を自動化
ビルドディレクトリに画像をコピーし、そのコピーに jpegoptim を実行します。元の画像と Git のステージングエリアを変更せず、公開用に最適化した JPEG を作成できます。このチュートリアルでは、Linux 上で可逆最適化した JPEG のディレクトリを作成します。いずれかの画像の処理に失敗すると、エラーで停止します。
Ubuntu への jpegoptim のインストール
Bash、GNU coreutils と findutils、および JPEG アセットが入った既存のディレクトリが必要です。以下のスクリプトは GNU realpath のオプションを使用します。Linux 向けの例であり、macOS や Windows でネイティブに動作するスクリプトではありません。Ubuntu 24.04 の jpegoptim 1.4.7 パッケージと、Linux 上の jpegoptim 1.5.6 でテスト済みです。
Ubuntu 24.04 では、jpegoptim パッケージをインストールします。
sudo apt-get update &&
sudo apt-get install -y jpegoptim &&
jpegoptim --version
実行時ライブラリはパッケージマネージャーがインストールします。パッケージ版のプログラムを実行するために libjpeg-dev は必要ありません。
単一画像のプレビュー
photo.jpg をアセットディレクトリ内のファイルに置き換えます。
jpegoptim --noaction --strip-none --nofix -- assets/images/photo.jpg
--noaction はファイルを書き込まず、最適化した場合のサイズを表示します。--max または --size を指定しなければ、jpegoptim は JPEG の符号化を可逆的に最適化します。マニュアルでは、この処理と画質を下げる処理を区別しています。圧縮後のバイト列が変わっても、デコードしたピクセルは同じままです。skipped という結果は、単に最適化してもサイズが小さくならなかったことを示す場合があります。
最適化した JPEG を別のディレクトリに作成
以下をプロジェクトルートに optimize-jpegs.sh として保存します。大文字の拡張子や入れ子のディレクトリも含め、通常ファイルの .jpg と .jpeg をコピーし、そのコピーを最適化します。ほかのファイルとシンボリックリンクのエントリは除外します。スクリプトの実行中はソースツリーを変更しないでください。
#!/usr/bin/env bash
set -euo pipefail
if (( $# != 2 )); then
printf 'Usage: bash optimize-jpegs.sh SOURCE NEW_OUTPUT\n' >&2
exit 1
fi
command -v jpegoptim >/dev/null || {
printf 'Install jpegoptim first.\n' >&2
exit 1
}
IFS= read -r -d '' source_dir < <(realpath -e -z -- "$1")
[[ -d "$source_dir" ]] || { printf 'Source must be a directory.\n' >&2; exit 1; }
IFS= read -r -d '' output_dir < <(realpath -m -z -- "$2")
if [[ "$source_dir" == / || "$output_dir/" == "$source_dir/"* ]]; then
printf 'Output must be outside the source tree.\n' >&2
exit 1
fi
if [[ -e "$2" || -L "$2" ]]; then
printf 'Output already exists; choose a new directory.\n' >&2
exit 1
fi
mkdir -- "$output_dir"
find "$source_dir" -type f \( -iname '*.jpg' -o -iname '*.jpeg' \) -print0 |
while IFS= read -r -d '' file; do
relative=${file#"$source_dir"/}
target="$output_dir/$relative"
mkdir -p -- "${target%/*}"
cp -- "$file" "$target"
jpegoptim --strip-none --nofix -- "$target"
done
printf 'JPEG build ready: %s\n' "$output_dir"
まだ存在しない出力ディレクトリを指定し、プロジェクトルートから実行します。出力先の親ディレクトリは、あらかじめ存在している必要があります。この例では、プロジェクトと同じ階層に書き込みます。
bash optimize-jpegs.sh assets/images ../optimized-images
たとえば、assets/images/products/front.JPG は
../optimized-images/products/front.JPG になります。先にコピーすることで、それ以上小さくならないファイルも保持できます。jpegoptim の --dest オプションだけでは、そのようなファイルが省かれる場合があります。スクリプトは既存の出力ディレクトリを上書きしないため、再実行時には新しい出力先が必要です。
ヌル区切りのファイルリストと引用符で囲んだパスにより、ファイル名に含まれる空白、改行、先頭のハイフン、リテラルの % 文字を扱えます。ディレクトリ引数にシンボリックリンクとそれに続く .. が含まれる場合も、検索とコピーの両方で同じ解決済みソースパスを使用します。
--nofix は、デコード時に警告が発生する画像の修復を試みず、処理を拒否します。コピーまたは最適化に失敗するとループが停止し、Bash の pipefail によって
find の失敗も伝播します。出力先の作成後に失敗すると、不完全なディレクトリが残る場合があります。再試行する前に、失敗したビルドの出力を確認するか削除してください。終了ステータスがゼロで、最後の成功メッセージが表示された場合にのみ公開してください。ソースディレクトリが空の場合は、空の出力ディレクトリを作成して正常終了します。
コミット用にステージした変更の保持
作業中のファイルを最適化してから git add assets/images を実行する pre-commit フックは避けてください。Git はそのディレクトリ全体の現在の状態を追加するため、無関係な編集、新規ファイル、削除も含まれます。また、意図的にステージした画像を、作業ツリー内の異なるバージョンで置き換えてしまう場合もあります。
ビルドスクリプトは独立したタスクとして使用します。Git コマンドを実行せず、元の画像も書き換えないため、ステージ済み、一部のみステージ済み、未ステージ、未追跡の作業をそのまま保持します。ローカルでは未追跡の JPEG も含めて作業ツリーを読み取るため、出力はステージしたコミットのスナップショットではありません。出力をコミットに一致させる必要がある場合は、CI でクリーンなチェックアウトを使用してください。
CI での同じスクリプトの実行
Ubuntu の CI ジョブでプロジェクトをチェックアウトし、上記のインストールコマンドを実行してから、プロジェクトルートでスクリプトを呼び出します。GitHub Actions のシェルステップでは、RUNNER_TEMP
の下に新しく作成するディレクトリを第 2 引数に指定します。スクリプトが成功した場合にのみ、そのディレクトリをアーティファクトのアップロードやデプロイに使用するよう設定してください。スクリプトが生成するのは JPEG アセットであり、完全なウェブサイトではありません。ビルドでは、ほかのファイルを用意し、最適化したアセットを参照する必要があります。
メタデータと画質の方針を慎重に選択
スクリプトは --strip-none を使用し、EXIF の向き情報、ICC カラープロファイル、コメントなどのメタデータマーカーを保持します。ただし、JFIF と Adobe のマーカーは
JPEG ライブラリによって再生成される場合があります。これはバイト単位で同一のアーカイブを作る処理でも、プライバシー情報を除去する処理でもありません。位置情報やカメラ情報が残る場合があります。
画像でメタデータをどう使用しているかを考慮せずに、--strip-all に置き換えないでください。向きや色の情報を削除すると、デコードしたピクセルのサンプル値が変わらなくても、表示に影響する場合があります。メタデータのオプションには、各フラグが保持または削除するマーカーが説明されています。
画質と引き換えにファイルを小さくする場合、--max=80 を指定すると、適用可能な場合に非可逆最適化が有効になります。これは画質の上限であり、サイズを 80% にする目標ではありません。--size も非可逆最適化を有効にし、指定サイズを目指しますが、そのサイズを保証しません。こうした変更は、元の画像から新しく作ったコピーで評価してください。このビルドスクリプトは、意図的に可逆最適化のみを行います。
実際の画像での測定
ビルドした画像について、元の画像と出力のバイト数を比較します。
wc -c -- assets/images/photo.jpg ../optimized-images/photo.jpg
削減率は一定ではありません。すでに最適化されている画像では、サイズが変わらない場合もあります。また、アセットが小さくなっただけでは、ページ読み込みが改善したとは判断できません。実際のビルド出力を確認し、そのファイルを配信した状態でページを測定してください。再圧縮済みの画像を出発点にせずに画質やメタデータの選択を見直せるよう、元の画像を保持してください。
