アーキテクチャパターン

Twelve-Factor App とぅえるぶふぁくたーあっぷ

Twelve-Factor Appクラウドネイティブ環境変数ステートレスHeroku
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 App1つのアプリの作り方と動かし方―
マイクロサービスシステムをどう小さく分けるか分けた1つ1つを12か条で作ると運用しやすい
クラウドネイティブ組織や基盤を含めた全体の進め方その中の「アプリの作法」にあたる
モノリス1つにまとめて作る形モノリスでも12か条は守れる

12か条は「分けるかどうか」とは別の話で、1つにまとまったアプリにも当てはまります。


実務のポイント

  • 秘密の情報:パスワードや API キーがソースコードに書かれていないか
  • 環境の作り方:開発・検証・本番を、同じ手順(自動化)で作れるか(→ 環境分離)
  • 台数を増やせるか:サーバーを増やしてもログイン状態やファイルが消えない作りか
  • ログの行き先:サーバーの外に集めて、障害のときに検索できるか
  • 配る手順:ビルドからリリースまでが自動で、1つ前の版に戻す方法があるか(→ CI/CDパイプライン)
  • 合わない項目:守らない原則は、理由を設計書に書いてもらったか

参考文献・外部リンク


関連用語

シス担のミカタ メールマガジン

セキュリティの速報とシステムの最新情報をメールで受け取る

登録すると、次の配信からお届けします。配信はメールの下のリンクから、いつでも解除できます。個人情報の取り扱い