LASSIC Media らしくメディア

2026.10.06 らしくコラム

Twelve-Factor Appの12原則と今の読み替え方

監修・編集責任者:牛尾 昭昌(株式会社LASSIC 執行役員)

開発ツールのサイドバーとターミナルのタブが並び、JavaScriptで書かれたテストコードが表示されたエディタ画面の写真。

この記事の結論

  • Twelve-Factor Appは、アプリと実行基盤の間の約束を12の原則にまとめた、2011年に生まれた方法論です。
  • 設定、ログ、状態を持たないプロセス、停止の扱い、ビルドと実行の分離は、今もそのまま通用します。
  • 原文の最終更新は2017年で改訂も途中のため、依存関係などは今の道具に置き換えて読みます。

※ 本記事は2026年10月時点の公式情報(省庁・公的機関、および製品やサービスを提供する事業者が公開している資料)に基づきます。

Twelve-Factor Appは、クラウドで動くアプリの作り方としてよく名前が挙がる12の原則です。コンテナ化やクラウド移行の打ち合わせで耳にしたものの、中身が分からない、今も通用するのか知りたい、という方も多いのではないでしょうか。

本記事では、Twelve-Factor Appの意味と12の原則の一覧、今もそのまま使える原則と読み替えが要る原則を、表と図で順に整理します。最後に、移行を外部に頼むときに確かめておきたい点もまとめます。

Twelve-Factor Appとは

公式サイトは、Twelve-Factor Appを、ソフトウェアをサービスとして提供するアプリケーションを作るための方法論と位置づけています。*1 言語やデータベースの種類は問いません。

  • 生まれ:アプリの実行基盤を提供するHerokuの開発者たちが、2011年にまとめた*6
  • 目的:実行環境の間で持ち運びやすくすること、開発と本番の差を小さくして継続的なデプロイ(本番への反映)を可能にすること
  • 考え方:アプリと、それを動かす基盤との約束事。アプリは設定を外から受け取り、ログを書き出し、いつ止められても困らないように作る

この線引きがあるので、同じコードを手元でもクラウドでも動かせます。設定を環境変数に置く、ログを標準出力へ流すといった、今では当たり前の作法の出どころでもあります。

原則の一覧と今の扱い

12の原則(公式の日本語訳では「因子」)と、その要旨は次のとおりです。右の列は公式の分類ではなく、本記事での整理です。

Twelve-Factor Appの12の因子と今の扱い(因子名は公式サイトの日本語訳による)
因子 原文の要旨 今の扱い
I. コードベース 1つのアプリに1つのコードベース 読み替え
II. 依存関係 依存するものをすべて宣言し、分離する 読み替え
III. 設定 環境ごとに変わる値を環境変数に置く そのまま
IV. バックエンドサービス データベースなどを付け替えのきく部品として扱う 読み替え
V. ビルド、リリース、実行 3つの段階を厳密に分ける そのまま
VI. プロセス 状態を持たないプロセスとして動かす そのまま
VII. ポートバインディング アプリ自身が通信の窓口を開いて待ち受ける 読み替え
VIII. 並行性 プロセスの数を増やして処理を広げる 読み替え
IX. 廃棄容易性 速く起動し、停止の合図で行儀よく終わる そのまま
X. 開発/本番一致 開発と本番の差をできるだけ小さくする 読み替え
XI. ログ ログを標準出力へ書く そのまま
XII. 管理プロセス 一回限りの作業も通常と同じ環境で動かす 読み替え

Twelve-Factor Appの12の因子を2つに分けた図。左の「今もそのまま使える」には、III 設定、V ビルド・リリース・実行、VI プロセス、IX 廃棄容易性(停止の合図で行儀よく終了)、XI ログの5つ。右の「読み替えが要る」には、I コードベース、II 依存関係、IV バックエンドサービス、VII ポートバインディング、VIII 並行性、X 開発/本番一致、XII 管理プロセスの7つと、それぞれの今の読み替え先を並べている。

今もそのまま使える原則

次の5つは、コンテナやクラウドの前提として、今もそのまま通用します。

  • 設定:接続先や認証情報など、環境ごとに変わる値をコードに書かず、環境変数で渡す
  • ビルド、リリース、実行:実行できる形にまとめる段階と、設定を組み合わせる段階、動かす段階を分ける
  • プロセス:処理の途中の状態を手元に持たず、残すデータはデータベースなどに置く
  • 廃棄容易性:停止の合図を受けたら、新しい受付をやめ、処理中のものを終えてから止まる
  • ログ:ログファイルを自分で管理せず、標準出力へ書いて集めるのは基盤に任せる

設定について原文が示す「認証情報を漏らさずに、今すぐコードを公開できるか」という基準は、コードの点検でもそのまま使えます。*2 プロセスについては、次の要求も同じサーバーに届く前提の「スティッキーセッション」は違反とされています。*3 停止の扱いでは、ワーカーなら処理中のジョブをキューに戻すとしています。*4 ログは、各プロセスがイベントの流れをバッファせずに標準出力へ書くという線引きです。*5

環境変数の仕組みは「環境変数の基礎」、ログの項目のそろえ方は「構造化ログ基盤の導入を外注で進める」で扱っています。

読み替えが要る原則

残る7つは、考え方は通用するものの、原文の例や手段が今の環境と合わない部分があります。

  • コードベース:複数のアプリを1つの置き場で管理するなら、アプリの単位をどこで区切るかを先に決める
  • 依存関係:今はOSの道具まで含めてコンテナイメージに固めるのが一般的
  • バックエンドサービス:付け替えの考え方は有効。認証のしかたは見直しが進んでいる
  • ポートバインディング:考え方はそのまま。例に挙がる道具は今では選ばれにくい
  • 並行性:プロセスの起動や停止は、今はコンテナの実行基盤が受け持つ
  • 開発/本番一致:手元でも同じ種類のデータベースをコンテナで動かせば差を縮められる
  • 管理プロセス:同じイメージから一回限りのジョブとして動かし、記録を残す

原文そのものも見直しが進んでいます。Herokuは2024年11月12日、Twelve-Factor Appをオープンソースのプロジェクトにすると発表しました。*7 ただし12factor.netの本文は「Last updated 2017」の表示のままで、改訂版は「next」ブランチで作業が続いており、正式な版はまだ公開されていません。*8 コンテナの基本は「コンテナと仮想マシンの違い」で整理しています。

外部に頼むときに確認しておきたい点

既存のアプリをコンテナへ移す作業を外部に頼むときは、12の原則を点検表として使うと話が具体的になります。

  • 設定の棚卸し:コードや設定ファイルに埋め込まれた接続先や認証情報を、誰が洗い出し、どこへ移すか
  • 秘密情報の置き場:環境変数に入れる値と、専用の管理サービスで守る値を分けているか
  • 状態を持たない作り:セッションやアップロードされたファイルを、どこへ移すかが決まっているか
  • ログの集め先:標準出力に切り替えたログを、どこに集めて何日残すか
  • 停止時の動き:停止の合図を受けたときの動きを、受け入れの試験で確かめるか

原文の例どおりに作ることより、各原則が何を防ぐためのものかを説明でき、今の道具で同じ効果を出せる相手のほうが、移行後の運用まで任せやすいでしょう。

まとめ:12の原則で確かめたい3つの点

Twelve-Factor Appで確かめておきたい点は3つです。第一に、設定は環境変数で渡し、コードを今すぐ公開しても認証情報が漏れない状態にすること。第二に、プロセスに状態を持たせず、ログは標準出力へ、停止の合図を受けたら処理を終えてから止まる作りにすること。第三に、原文は2017年時点の文書で改訂も途中であることを踏まえ、依存関係などは今の道具に置き換えて読むことです。

LASSICに相談するメリット

LASSICは2006年の創業以来、システムの運用・保守に特化したプライム(一次請け)のシステムインテグレーターとして、企業のシステム開発と保守・運用を受託してきました。Rubyアソシエーション認定システムインテグレータ、日本ニアショア開発推進機構の認定ベンダーとして、全国のリモート人材による開発・運用の体制を整えています。

Twelve-Factor Appの考え方に沿った移行では、Dockerによるコンテナイメージ化、KubernetesのConfigMapとSecretによる設定の受け渡し、Fluent Bitなどによる標準出力ログの収集を組み合わせます。設計の判断点は、どの値を環境変数で渡し、どれを秘密情報の管理サービスに置くか、セッションやアップロードファイルをどこへ移すかです。検証と運用では、GitHub ActionsなどのCI/CDで同じイメージを検証環境から本番環境へ順に配り、停止時の動作を含む自動テストと、ログとメトリクスの監視までを整えます。

よくある質問

Twelve-Factor Appは今でも通用しますか

考え方の多くは今も通用します。設定を環境変数に置く、ログを標準出力へ流す、プロセスに状態を持たせないといった原則は、コンテナや管理サービスの前提になっています。例に挙がる道具は、今のものに置き換えて読みます。

12の原則をすべて守らないといけませんか

一度にすべてを満たす必要はありません。既存のアプリを移すときは、設定の切り出し、ログの標準出力化、セッションやファイルの置き場の見直しなど、移行先で問題になりやすいものから手を付けるのが現実的です。

秘密情報も環境変数に入れてよいですか

原文は外部サービスの認証情報も設定に含め、環境変数に置くとしています。実務では、値そのものは秘密情報の管理サービスで保管し、起動時に渡す構成がよく使われます。ログやエラーの出力に値が載らないようにすることも欠かせません。

クラウドネイティブなアプリへの移行のご相談

元請(プライムベンダー)として、既存アプリの設計の見直しからコンテナ化、保守・運用までご提案します。

2006年の創業以来、一次請けのシステムインテグレーターとして、企業のシステム開発と保守・運用を受託してきました。

無料相談はこちら

出典

  1. *1 参考:The Twelve-Factor App(公式サイト)(https://12factor.net/)。出典:Twelve-Factor Appの位置づけ、目的、Last updated 2017 の表示を参照(因子名は日本語版のページによる)(2026年10月確認)
  2. *2 参考:The Twelve-Factor App「III. Config」(https://12factor.net/config)。出典:設定の定義と、認証情報を漏らさずにコードを公開できるかという基準を参照(2026年10月確認)
  3. *3 参考:The Twelve-Factor App「VI. Processes」(https://12factor.net/processes)。出典:プロセスに状態を持たせないこと、スティッキーセッションを違反とする記述を参照(2026年10月確認)
  4. *4 参考:The Twelve-Factor App「IX. Disposability」(https://12factor.net/disposability)。出典:停止の合図で行儀よく終わること、ワーカーは処理中のジョブをキューに戻すことを参照(2026年10月確認)
  5. *5 参考:The Twelve-Factor App「XI. Logs」(https://12factor.net/logs)。出典:ログをイベントの流れとしてバッファせずに標準出力へ書くことを参照(2026年10月確認)
  6. *6 参考:The Twelve-Factor Blog「Twelve-Factor App Methodology is now Open Source」(https://12factor.net/blog/open-source-announcement)。出典:2011年にHerokuが最初にまとめた経緯と、改訂をコミュニティで進める方針を参照(2026年10月確認)
  7. *7 参考:Heroku「Heroku Open Sources the Twelve-Factor App Definition」(https://www.heroku.com/blog/heroku-open-sources-twelve-factor-app-definition/)。出典:2024年11月12日のオープンソース化の発表を参照(2026年10月確認)
  8. *8 参考:twelve-factor/twelve-factor(GitHub リポジトリ)(https://github.com/twelve-factor/twelve-factor)。出典:改訂版がいずれ12factor.netの文書を置き換えること、変更をnextブランチで進めることを参照。正式な版が未公開であることはリポジトリのリリース一覧(空)で確かめた(2026年10月確認)




View