Twelve-Factor App とぅえるぶふぁくたーあっぷ
簡単に言うとこんな感じ!
クラウドで動く Web アプリを作るときの「12か条の心得」だよ。「設定はプログラムに書き込まない」「サーバーの中に大事なものを置きっぱなしにしない」みたいな約束を守ると、台数を増やすのも、引っ越すのも、壊れたときの入れ替えも楽になるんだ!
Twelve-Factor Appとは
Twelve-Factor App(トゥエルブ・ファクター・アップ) は、Web アプリや SaaS をクラウドの上で育てやすく、運用しやすくするための 12 の設計の原則 です。クラウドでアプリを動かすサービス(PaaS)の草分けである Heroku の共同創業者 Adam Wiggins が中心になってまとめ、2011 年ごろに Web サイト(12factor.net)で公開しました。日本語訳もあります。
背景には、Heroku の上で何千ものアプリを見てきた経験があります。「本番だけ設定が違って動かない」「サーバーを増やしたらログインが切れる」といった、どこでも起きる問題を12の項目に整理したものです。特定の言語や製品には縛られません。
正式な規格ではなく、よく参照される 考え方の目安 です。今では クラウドネイティブ なアプリの土台として、開発会社の提案書でもよく名前が出てきます。
12の原則
| # | 原則 | ひとことで言うと |
|---|---|---|
| I | コードベース | 1つのアプリは1つのコードの置き場で管理し、各環境へ配る |
| II | 依存関係 | 使う部品(ライブラリ)は一覧に書き、サーバーにある物に頼らない |
| III | 設定 | 環境ごとに違う値は、コードでなく 環境変数 に置く |
| IV | バックエンドサービス | データベースなども「付け外しできる部品」として扱う |
| V | ビルド・リリース・実行 | 作る→設定と合わせる→動かす、を分ける |
| VI | プロセス | アプリの中に利用者の状態を持たない(ステートレス) |
| VII | ポートバインディング | アプリ自身が受付の窓口(ポート)を開いてサービスを出す |
| VIII | 並行性 | 忙しくなったら、同じプロセスを増やして対応する |
| IX | 廃棄容易性 | すぐ起動し、止めるときは仕事を片付けてから止まる |
| X | 開発/本番一致 | 開発・検証・本番の環境の違いをできるだけ小さくする |
| XI | ログ | ログは自分で貯めず、流して外の仕組みで集める |
| XII | 管理プロセス | データ移行などの作業も、本番と同じコードと環境で動かす |
特に効いてくる3つ
- III. 設定:パスワードがコードに書いてあると、コードを見た人全員に漏れます。環境変数や秘密情報の管理サービス(→ Secrets Manager)に分ければ、同じコードを開発にも本番にも使えます。
- VI. プロセス:ログイン状態などをサーバーの中に置くと、台数を増やしたり入れ替えたりしたときに消えます。データベースなど外に置くのが原則です。
- XI. ログ:サーバーが使い捨てだと、中のログも一緒に消えます。外の仕組みに集めて検索できるようにします(→ ログ設計)。
すごく役に立つよ! 12か条を全部覚えなくても、質問に変えて使えるんだ。たとえば、
- 「パスワードや接続先は、ソースコードのどこにありますか?」(III)
- 「サーバーを2台に増やしても、ログイン状態は消えませんか?」(VI)
- 「本番の環境を作り直すのに、手作業はどれくらいありますか?」(V・X)
すらすら答えられる会社なら、運用まで考えて作っている証拠だね。
全部守る必要はないよ。もともとはクラウドで台数を増減させる Web アプリ向けの心得だから、1台で動く社内システムには合わない項目もある。
でも「設定をコードから分ける」「ログを外に集める」「環境を自動で作れるようにする」あたりは、どんなシステムでも得をするよ。クラウドへ移す前のチェックにも使えるね。
歴史と背景
- 2007年:Heroku が創業。Web アプリを簡単にクラウドへ載せられる PaaS として広まる
- 2011年ごろ:Adam Wiggins が Twelve-Factor App を公開。Heroku の上での経験をまとめたもの
- 2013年以降:Docker や Kubernetes が登場。使い捨てのコンテナで動かす考え方と相性がよく、改めて広く読まれる
- 2024年11月:Heroku が Twelve-Factor をオープンソースにし、GitHub 上でコミュニティが改訂を進める形になる
関連する考え方との比較
| 考え方 | 何を決めるか | Twelve-Factor との関係 |
|---|---|---|
| Twelve-Factor App | 1つのアプリの作り方と動かし方 | ― |
| マイクロサービス | システムをどう小さく分けるか | 分けた1つ1つを12か条で作ると運用しやすい |
| クラウドネイティブ | 組織や基盤を含めた全体の進め方 | その中の「アプリの作法」にあたる |
| モノリス | 1つにまとめて作る形 | モノリスでも12か条は守れる |
12か条は「分けるかどうか」とは別の話で、1つにまとまったアプリにも当てはまります。
実務のポイント
- 秘密の情報:パスワードや API キーがソースコードに書かれていないか
- 環境の作り方:開発・検証・本番を、同じ手順(自動化)で作れるか(→ 環境分離)
- 台数を増やせるか:サーバーを増やしてもログイン状態やファイルが消えない作りか
- ログの行き先:サーバーの外に集めて、障害のときに検索できるか
- 配る手順:ビルドからリリースまでが自動で、1つ前の版に戻す方法があるか(→ CI/CDパイプライン)
- 合わない項目:守らない原則は、理由を設計書に書いてもらったか
参考文献・外部リンク
- The Twelve-Factor App(日本語訳) — 12の原則の本文の日本語版
- The Twelve-Factor App — 原文の公式サイト
- twelve-factor/twelve-factor|GitHub — オープンソース化後の改訂の場
- Heroku Open Sources the Twelve-Factor App Definition|Heroku — 2024年11月のオープンソース化の発表
関連用語
- クラウドネイティブ — クラウドの特長を活かして作り、動かす考え方
- Docker — 12か条と相性のよいコンテナ
- Kubernetes — たくさんのコンテナを自動で動かす仕組み
- マイクロサービスアーキテクチャ — 機能ごとに小さく分けて作る設計
- CI/CDパイプライン — ビルドからリリースまでの自動化
- ログ設計 — 何をどこに記録するか
- Secrets Manager — パスワードなどをコードの外で管理する
- 環境分離 — 開発・検証・本番を分ける考え方