
ソフトウェアアーキテクチャの学習地図を読む~50項目は「判断」から「運用」へ並んでいる~
最近、Neo Kimさん(@systemdesignone)の投稿「Software Architecture — Ultimate Roadmap (SAVE NOW)!」を読みました。
10章・50項目のツリーです。パターン名を並べた一覧に見えますが、順番を見ると設計の考え方が読み取れます。
この記事では、その順番の意味を解説します。
【発端】 型より先に「判断」がある

この地図は「何を使うか」の前に「どう決めるか」を学ばせる並びです。
投稿は項目名だけのツリーで、各項目の解説は含まれていません。10章は次の通りです。
基礎と役割
設計の思考
設計原則
スタイルとパターン
ドメインモデリング
データと永続化
分散システム
連携とAPI
進化と本番運用
実践とコミュニケーション
目を引いたのは第2章です。
トレードオフ分析、ADR(設計判断の記録)、フィットネス関数(特性が保たれているかを確かめる仕組み)、技術的負債、コンウェイの法則(組織の構造がシステムの構造に似る、という観察)が、レイヤード、マイクロサービス、CQRSといったスタイルの章より前にあります。
末尾の一文は、変化・チーム・規模を越えて残る判断ができるようになることを、目標に掲げています。
以降は、この地図を入口にした私の整理です。各項目の中身は、公式の資料や定評ある解説で補います。
【基礎】 アーキテクチャは、変更に耐える判断の集まり

図やパターンはその結果であり、本体は「何を優先し、何を捨てたか」という判断です。
第1章の項目は、役割、品質特性(性能、可用性、変更容易性などの「〜性」)、機能要件と非機能要件、利害関係者と制約です。判断の材料を揃える章といえます。
材料が決まらないと、判断の良し悪しを測れません。「速く」「安全に」と言うだけでは、何と引き換えにするのかが決まらないからです。
ADRの提唱者であるMichael Nygardは、判断の背景には技術・政治・社会・プロジェクト固有の力が働き、それらはたいてい互いに引っ張り合っていると述べています(Documenting Architecture Decisions)。
その引っ張り合いの中で「今回はこちらを選ぶ」と決めること。これがアーキテクチャの中心にある仕事です。
【違い】 型の暗記から、判断と検証の習慣へ

変わるのは知識の量ではなく、決め方と確かめ方です。
学ぶ対象
カタログ型:名前のついたパターン
判断型:判断の理由と代償
良し悪しの基準
カタログ型:流儀や好み
判断型:品質特性と制約への適合
記録
カタログ型:コードと図だけ
判断型:判断の背景と結果を文章で残す
検証
カタログ型:レビューで見る
判断型:自動の検査で守る
変化への態度
カタログ型:最初に完成形を描く
判断型:少しずつ変える前提で設計する
判断型の側を支えるのが、第2章のADRとフィットネス関数です。ADRは1つの判断を短い文書にして、コードと同じリポジトリで管理する方法です。
Martin Fowlerは、判断・背景・重要な影響を数ページで書くものと説明しています(Architecture Decision Record)。
フィットネス関数は、アーキテクチャの特性が保たれているかを客観的に評価する仕組みです。『Building Evolutionary Architectures』の定義がもとで、Summary of Building Evolutionary Architecturesで概要を確認できます。
【仕組み】 10章は、判断・構造・稼働・伝達の四層で読める
境界をどこに引くかが、データ、通信、失敗、運用へと連鎖します。
地図の10章は、次のように読めます。これは公式の分類ではなく、私の読み方です。

判断(第1〜3章):何を守り、何を捨てるかを決める層です。
構造(第4〜6章):どこで切り、データを誰が持つかを決める層です。
稼働(第7〜9章):ネットワーク越しの失敗と変化に耐える層です。
伝達(第10章):決めたことを他人に伝え、検討し合う層です。
サービスの境界を切ると、データの持ち主も分かれます。

モノリス(単一のプログラム)の中では、部品同士の連絡はメソッド呼び出しです。サービスに分けると、ネットワーク越しの通信になります。
通信が入ると、遅延、失敗、再試行が現実の問題になります。第7章のリトライと冪等性(同じ操作を繰り返しても結果が変わらない性質)が必要になるのは、この流れの先です。
最後に、動き続けるシステムを測る第9章が来ます。GoogleのSRE本では、利用者にとって大事な振る舞いをSLI(測る指標)、SLO(目標値)、SLA(約束)に分けて扱います。
詳しくは Service Level Objectives の章に書いてあります。
【具体例】 モノリスかマイクロサービスかを、記録して検証する

第4章でよく出る問いも、第2章の道具を使うと「後から検証できる判断」になります。
Martin Fowlerは Monolith First で、新規開発ではまずモノリスから始める戦略を勧めています。マイクロサービスは、安定した良い境界が引けて初めてうまく動くためです。
境界を引く作業は、第5章の境界づけられたコンテキスト(用語や意味が一貫する範囲)を描くことに当たります。モノリスで作り、モジュール性を保てば、境界の見極めに時間をかけられます。
この判断を、第2章のADRの形で書くと次のようになります。以下は書き方の骨組みで、実在のプロジェクトの例ではありません。
Title:判断を短い名詞句で書きます。
Status:提案中、承認済み、置き換え済みのいずれかです。
Context:判断を迫る力を、価値中立の言葉で書きます。
Decision:「〜する」と能動態で言い切ります。
Consequences:良い結果だけでなく、すべての結果を書きます。
この構成はNygardの原典に沿っています。1つのADRには、1つの重要な判断だけを入れます。
さらに、モジュール間の依存を自動で検査すれば、境界が保たれているかをフィットネス関数として守れます。後から分割する日が来ても、判断の理由と境界の状態が残っています。
【関連概念】 最初に読む入口は、判断を支える四つ

コンウェイの法則:システムの構造は、作る組織の構造に似るという観察です。Fowlerは、システムの分割と組織の分割は一緒に考えるべきと述べています。
ストラングラーフィグ:古いシステムを一度に作り直さず、新しい機能を少しずつ外側に作って、古いシステムを置き換える方法です。Fowlerの解説があります。
C4モデル:システムを、コンテキスト、コンテナ、コンポーネント、コードの4階層で図にします。公式サイトにあります。
SLOとエラーバジェット:どこまでの失敗を許すかを数値で決め、速度と信頼性の釣り合いを取ります。
それぞれ、第2章の判断を、組織、移行、図、運用へ広げる入口です。
参考情報・参考書籍(PR)
本記事をより深く理解するために、概念マップスライドを作成しました。こちらをみることで理解の補助になるはずです。
『ソフトウェアアーキテクチャの基礎 第2版 ―エンジニアリングに基づく体系的アプローチ』(Mark Richards、Neal Ford、訳は島田 浩二):地図の10章に近い範囲を、エンジニアリングの観点から体系的に扱っています。第2版にはモジュラーモノリスやイベント駆動の話題があります。
『進化的アーキテクチャ ―絶え間ない変化を支える』(Neal Fordほか。ThoughtWorksの3名):フィットネス関数と進化的アーキテクチャの出典にあたる日本語版です。
『ソフトウェアアーキテクチャの基礎 ―エンジニアリングに基づく体系的アプローチ(初版)』(Mark Richards、Neal Ford)
『ドメイン駆動設計をはじめよう ―ソフトウェアの実装と事業戦略を結びつける実践技法』(Vlad Khononov。監訳等に増田 亨、綿引 琢磨):第5章の境界づけられたコンテキストをさらに読む候補です。
関連記事
【まとめ】 まず、今の判断を1つ、1ページに残す

地図を全部たどる必要はありません。自分のシステムで過去に下した判断を1つ選び、書き出すところから始められます。
試す手順の一例です。
「なぜこの構成にしたのか」が説明しにくい判断を1つ選びます。
Context、Decision、Consequencesの3節だけ書きます。
結果の欄に、守りたい特性を1つ入れます。
それを自動で確かめる方法がないか、考えます。
書けない節があれば、そこが地図で次に読む章です。私自身が実際のプロジェクトで検証した手順ではなく、あくまでも資料から組み立てた試し方です。