セマンティックバージョニング
Semantic Versioning
セマンティックバージョニングとは?
- バージョンを メジャー.マイナー.パッチ で採番
- 数字で変更の性質を把握
- 互換性管理
セマンティックバージョニングが実際に変えるのは、更新の判断を誰がするのかという点です。ルールがなければリリースノートを人がすべて読んで決める必要がありますが、ルールがあればパッケージマネージャーが「マイナーバージョンまでは自動で上げ、メジャーバージョンには触れるな」という指示を機械的に実行します。package.json の ^1.4.0、Python の ~=1.4 のような表記がその指示文です。人の確認作業がツールの設定値へ移っていくのが核心で、だからこそ依存関係が200〜300個あるプロジェクトでも、メジャーバージョンが変わったものだけを人が確認する方式で回っていきます。
細かい条件にも、実務者がよく見落とす例外があります。0.y.z の区間は規則による保護を受けず、公式仕様も「0.x では互換性がいつ壊れてもおかしくない」と明記しています。1.0.0 を付けた瞬間から公開APIが固定される、ということです。1.0.0-beta.2 のようにハイフンの後ろに付くプレリリースは、正式版の 1.0.0 より低いバージョンとして扱われ、プラス記号の後ろのビルドメタデータは比較で完全に無視されます。Ubuntu 24.04 のように日付をバージョンとして使うCalVerとは目的が違うため、一つの組織内で混ぜて使うと混乱が増すだけです。
現場で最もよくある誤解は、バージョン番号を保証だと信じてしまうことです。番号はデプロイする人が自分で付ける宣言にすぎず、検証された事実ではありません。実際、パッチバージョンだと言いながら設定の既定値を変えて入れてくるライブラリは少なくなく、社内チームも「メジャーバージョンを上げると他チームが嫌がる」という理由で、互換性を壊す変更をマイナーバージョンに隠しがちです。ここにlockファイルをコミットしないと、同じインストールコマンドが開発者のPCと本番のサーバーで違う結果を出し、障害の原因を探すだけで数日が消えてしまいます。
GitHub共同創業者のトム・プレストン=ワーナーが整理した仕様(semver.org)で、オープンソースのエコシステムにおける事実上の標準になりました。
架空の事例で見てみましょう。役職員140名規模の物流SaaSを運営するA社は、昨年第4四半期だけでデプロイ直後の障害を3回経験しました。原因を追跡すると、3件すべて外部ライブラリの自動アップデートから始まっており、そのうち2件はバージョンの末尾の数字だけが変わった「バグ修正」でした。
- バックエンドリーダーのキム責任が1か月分のデプロイログを調べたところ、自動で上がったパッケージは47個で、lockファイルはリポジトリにコミットすらされていませんでした。
- CTOが「末尾の数字しか上がっていないのに、なぜサービスが止まるのか」と尋ねると、キム担当者は認証ライブラリが0.9.3から0.9.4に上がる際、トークンの有効期限の既定値が24時間から1時間に変わったコミットを画面に映しました。
- チームは0.xパッケージはバージョンを丸ごと固定し、キャレット範囲は1.0.0以上にだけ使い、lockファイルは例外なくコミットするという3行のルールを、リポジトリのREADMEの一番上に貼り付けました。
- 社内共通モジュール12個にも同じ基準を適用し、APIレスポンスのフィールドを一つでも削除したらメジャーバージョンを上げるという項目をコードレビューのチェックリストに入れました。初月には精算モジュールが2.7.0から3.0.0に上がりました。
- 半年後、デプロイ直後の障害は四半期3件から0件になり、アップデートPR1件をレビューする時間も平均40分から10分に減りました。
パク・スンテ
金鍾赫