社内での開発コミュニティ活動とモジュラーモノリス標準化事例のご紹介/xPalette and Introduction of Modular monolith standardization

社内での開発コミュニティ活動とモジュラーモノリス標準化事例のご紹介 JJUG CCC Spring 2025 2025年6月7日株式会社野村総合研究所生産革新センタープラットフォームサービス開発一部
丸山光晴

1 Copyright （C） Nomura Research Institute, Ltd. All rights reserved.
NRIについて 01 開発コミュニティ活動（xPalette）のご紹介モジュラーモノリス標準化最後に 02 04 05 xPaletteの現場での活用事例 03

自己紹介 JJUG CCC Spring 2025 氏名: 丸山光晴所属: 野村総合研究所生産革新センタープラットフォームサービス開発一部本日の意気込み: 社会人歴10年目にして初のセッション登壇となります！恐らくとても緊張していますが、やさしい眼差しでご覧いただけるとありがたいです。皆さんと意見交換して色々持ち帰れたらと思います！

入社からプロジェクトへの技術支援業務に従事 JJUG CCC Spring 2025 NRIは幅広い業界の顧客がいるため、様々なプロジェクトに技術支援として参画できたプロジェクト種別凡例 :R&D・施策, :金融ITソリューション, :産業ITソリューション 2016 2017 2018 2019 2020 2021 2022 2023 2024 2025 R&D 大規模システム統合システム構築大規模フロントシステム再構築技術施策大規模システム再構築大規模基幹システム再構築（マイクロサービス） R&D フロントシステム構築証券金融流通通信産業金融

入社からプロジェクトへの技術支援業務に従事 JJUG CCC Spring 2025 NRIは幅広い業界の顧客がいるため、様々なプロジェクトに技術支援として参画できたプロジェクト種別凡例 :R&D・施策, :金融ITソリューション, :産業ITソリューション 2016 2017 2018 2019 2020 2021 2022 2023 2024 2025 R&D 大規模システム統合システム構築大規模フロントシステム再構築技術施策大規模システム再構築大規模基幹システム再構築（マイクロサービス） R&D フロントシステム構築証券金融流通通信産業金融システム開発における技術的課題の解決を実施 • アーキテクチャの検討 • アプリケーション処理方式の検討 • アプリケーション標準化ルール整備 • 共通部品の作成

NRIについて

NRIは売上の約9割をITソリューションが占める企業 NRIについて

NRIの事業領域 NRIについてコンサルティング金融ITソリューション産業ITソリューション IT基盤サービスマネジメントとシステム分野においてあらゆる産業のコンサルティング金融分野でのシステム開発やソリューションを提供産業分野でのシステム開発やソリューションを提供企業のIT基盤の構想・設計・構築・運用などのサービスやソリューションを提供

IT基盤サービスのソリューション紹介：OpenStandia NRIについて OpenStandiaとは… NRIが提供するOSSに対するサポート＆サービスの総称です。 https://openstandia.jp/oss_info/ サービスライナップ • オープンソース年間サポートサービス • オープンソース導入サービス • プロフェッショナルサービス（技術相談）

サポート対象OSSは137 NRIについて機能オープンソースインフラ OS Red Hat Enterprise Linux コンテナ仮想化 Kubernetes, Docker, Rancher, Argo CD, Helm, Argo Rollouts, Kustomize, containerd, CRI-O サービスメッシュ Istio, Envoy, Linkerd, Cilium クラスタリング Heartbeat, Corosync, Pacemaker, DRBD, Keepalived , Apache Zookeeper RDBMS MySQL, MySQL Cluster, MariaDB, PostgreSQL NoSQL MongoDB, Redis, etcd, Valkey, Traefik オブジェクトストレージ MinIO Webサーバ Apache HTTP Server, Nginx, OpenResty プロキシサーバ Squid, OpenIG メールサーバ Postfix, sendmail, Mailman POP3/IMAP Dovecot, Courier-IMAP SPF/DKIM/DMARC OpenDKIM, OpenDMARC DNS BIND, PowerDNS, unbound ファイルサーバ Samba ディレクトリサーバ OpenLDAP, OpenDJ (ForgeRock DS), 389 Directory Server ビッグデータ集積 Apache Kafka, Apache Hadoop, Apache Spark ワークフロー Argo Workflows, Argo Events, Apache Airflow APIゲートウェイ Gloo Gateway, Kong Gateway, Tyk メッセージ ActiveMQ 機能オープンソース開発 APサーバ Apache Tomcat, JBoss AS/Wildfly, JBoss EAP, JBoss EWS, Red Hat Runtimes フレームワーク Apache Struts, Spring Framework, Spring Boot, Spring Batch, Spring Security, Spring Session, Spring Modulith, HikariCP,Spring for Apache Kafka, Spring Data Redis, Spring Data JPA, Spring Cloud Azure, Spring Cloud GCP, Spring Cloud Function, Echo, TailwindCSS フロントエンドフレームワーク Angular, React, Vue.js, Bootstrap, NgRx, NgBootstrap, Next.js, Nuxt テンプレートエンジン Thymeleaf ORマッピング Hibernate, MyBatis SOAP Apache Axis2 全文検索 Apache Solr, Apache ManifoldCF, Elasticsearch Java OpenJDK Javaライブラリ Log4j, Jackson, Logback, Netty, Micrometer, MapStruct, Dozer, Lombok, gRPC-Java, Java JWT, Gson, Redisson Goライブラリ gRPC-Go, gRPC-Gateway ポリシーエンジン Open Policy Agent, Casbin ツールバージョン管理 Apache Subversion, Git チケット管理 Redmine 運用管理 Tripwire テレメトリー管理 Vector 運用監視 Zabbix, Prometheus, Thanos, Jaeger, OpenTelemetry ログ管理 Fluentd, Fluent Bit, Grafana Loki トレース管理 Grafana Tempo メトリクス管理 Grafana Mimir ダッシュボード Grafana アンチウイルス Clam AntiVirus 暗号化 OpenSSL アプリシングルサインオン Keycloak, Red Hat SSO, OpenAM (ForgeRock AM), OAuth2 Proxy ID管理 midPoint, OpenIDM (ForgeRock IDM) BI・ETL・レポート作成 Jaspersoft, Pentaho ※2025年5月現在 ⇒ ピンクの文字は直近1年間で追加したOSS

開発コミュニティ活動（xPalette）のご紹介

開発コミュニティ活動(xPalette) xPaletteのご紹介 xPalette(クロスパレット)とは？

xPaletteが提供するモノ xPaletteのご紹介ガイドラインライブラリサンプル/テンプレート Prj 開発手順や方式の説明開発に利用可能な部品群開発の雛形/実装例各処理方式についての設計考慮事項を記載。設計ガイドラインの内容に沿ってアプリケーションを実装する際の実装方式や実装例を参照することで高品質なアプリケーション開発が可能となる。ガイドラインに記載した部品をライブラリとして提供。テンプレートプロジェクトに組み込むことで素早いアプリケーション開発が可能となる。ガイドラインに記載した実装例を実際に動くサンプルコードとして提供。テンプレートは開発開始時にプロジェクトの雛形として利用する。

開発コミュニティ活動(xPalette)の構想 xPaletteのご紹介 (開発ベースライン) フィードバック社外のエンジニア/企業 NRIのお客様開発/エンハンス xPalette開発コミュニティ社内開発PJ 公開/利用プロダクト開発公開/利用フィードバック構想

開発コミュニティ活動(xPalette)の構想 xPaletteのご紹介 (開発ベースライン) フィードバック社外のエンジニア/企業 NRIのお客様開発/エンハンス xPalette開発コミュニティ社内開発PJ 公開/利用プロダクト開発公開/利用フィードバック構想現時点では一部を除き社内での利用にとどまっています本日は社内でのxPalette開発コミュニティとその活動内容についてお話します

開発コミュニティ活動のきっかけ xPaletteのご紹介開発現場のトレンド ◼ 利用技術のオープン化 OSSなどオープンな開発技術の採用が求められる。 ◼ 技術の多様化と高度化クラウドネイティブ、マイクロサービスなどを中心に技術が多様化している。開発現場の課題 ◼ 技術適用の準備が不十分スピーディーな開発が求められており、開発の準備に労力を要する。 ◼ 高度技術エンジニアの不足最適な技術選定・適用方法を検討することができる高度なエンジニアの確保が難しい。全社としての課題 ◼ ノウハウ・ナレッジの点在技術的なノウハウやナレッジが各事業部、開発部隊内部に閉じている、またノウハウ共有の場（リポジトリ）がないため、全社的な技術情報の共有が効率的にできていない。多様な技術から選択できる半セルフの開発ベースラインが必要。さまざまな案件で得たナレッジで継続的にブラッシュアップする場としてxPaletteを提供する。

xPaletteの活動領域 xPaletteのご紹介バックエンド領域アプリ実行基盤領域フロントエンド領域アプリケーションレイヤーインフラレイヤー APP

xPaletteの利用イメージ xPaletteのご紹介フロントエンド領域バックエンド領域アプリ実行基盤領域開発に必要となる技術要素を組み合わせて素早いアプリ開発をサポート開発エンジニア

公開事例1（Next.js 公式ドキュメント和訳版） xPaletteのご紹介 xPaletteの活動として作成したNext.js 公式ドキュメントの和訳版を公開

公開事例２（AILERON Gateway） xPaletteのご紹介トラフィック・API管理リバースプロキシ負荷分散流量制御タイムアウト/リトライプロトコル変換 … セキュリティ認証(OIDC) 認可(OAuth2,OPA) FAPI ネットワークセキュリティ Webセキュリティセッション管理 … 運用オブザーバビリティ (OpenTelemetry, Jaeger, Prometheus) … https://aileron-gateway.github.io/ ◼ AILERON Gateway （エルロンゲートウェイ）はNRI発のシンプルな汎用ゲートウェイOSSです（Go言語製）。 ◼ ゲートウェイに求められる基本機能に加え、プロトコル変換や認証・認可など、アプリケーション側での実装が敬遠されがちな処理をAILERON Gatewayに切り出すことができます。

バックエンド領域の活動 xPaletteのご紹介バッチアプリケーションオンラインアプリケーション非同期アプリケーションバックエンド領域では「バッチ」「オンライン」「非同期」の3軸で活動中特定の時刻やイベントで起動し、特定の処理を実行するアプリケーションクライアントからのリクエストに応じた処理を実行し、即時に処理結果を応答するアプリケーション処理要求に対して、処理結果を即時に応答せず、別のサーバーで処理を実行するアプリケーション

xPaletteにおけるオンラインの取組み xPaletteのご紹介開発ガイドライン Springの実装に必要なノウハウを集約したガイドライン共通部品作成ガイドライン Spring前提で利用頻度の高い共通部品の作成方法を記載したガイドラインサンプルプロジェクト各ガイドラインに記載している実装例のコードセキュリティガイドライン Spring Securityを用いた際に社内のセキュリティルールに準拠するためのガイドライン

xPaletteの現場での活用事例とモジュラーモノリス標準化

あるプロジェクトでアーキテクチャとしてモジュラーモノリスを選択 xPaletteの現場での活用事例とモジュラーモノリス標準化顧客からのアーキテクチャ要望は下記。 1. 厳密なデータ整合性 2. コードの再利用性 3. マルチベンダ開発 ⇒ 開発体制・コスト・要望を勘案した結果、モジュラーモノリスを選択。 ⇒ 将来的なサービス分割も視野に方式設計を実施。円が業務の実装単位 1つのプロセスにまとめて実行四角が業務の実装単位業務それぞれでプロセスを実行呼び出し関係凡例プロセス単位モノリスモジュラーモノリスマイクロサービスこちらを採用当初の顧客要望

プロジェクト成果物の一部はxPaletteを用いて省力化可能 xPaletteの現場での活用事例とモジュラーモノリス標準化プロジェクト特化 xPalette未取込プロジェクト共通 xPalette利用可アプリケーション処理方式標準化共通部品サンプル開発ガイドラインセキュリティガイドライン共通部品作成ガイドラインサンプルプロジェクト xPalette成果物 • モジュラーモノリス関連 • プロジェクト特化 • xPaletteにまだないものは別途検討・作成。プロジェクト成果物（の一部）

プロジェクト成果物の一部はxPaletteを用いて省力化可能 xPaletteの現場での活用事例とモジュラーモノリス標準化プロジェクト特化 xPalette未取込プロジェクト共通 xPalette利用可アプリケーション処理方式標準化共通部品サンプル開発ガイドラインセキュリティガイドライン共通部品作成ガイドラインサンプルプロジェクト xPalette成果物 • モジュラーモノリス関連 • プロジェクト特化 • xPaletteにまだないものは別途検討・作成。プロジェクト成果物（の一部） xPalette成果物の適用事例と、プロジェクトでのモジュラーモノリス標準化、それぞれお話します。

プロジェクト成果物の一部はxPaletteを用いて省力化可能 xPaletteの現場での活用事例とモジュラーモノリス標準化プロジェクト特化 xPalette未取込プロジェクト共通 xPalette利用可アプリケーション処理方式標準化共通部品サンプル開発ガイドラインセキュリティガイドライン共通部品作成ガイドラインサンプルプロジェクト xPalette成果物 • モジュラーモノリス関連 • プロジェクト特化 • xPaletteにまだないものは別途検討・作成。プロジェクト成果物（の一部） xPalette成果物の適用事例と、プロジェクトでのモジュラーモノリス標準化、それぞれお話します。技術方式的な内容を中心にお話します。 ※特定顧客がいるプロジェクトなので業務設計などは話しません

xPaletteの現場での活用事例

プロジェクト成果物の一部はxPaletteを用いて省力化可能 xPaletteの現場での活用事例とモジュラーモノリス標準化プロジェクト特化 xPalette未取込プロジェクト共通 xPalette利用可アプリケーション処理方式標準化共通部品サンプル開発ガイドラインセキュリティガイドライン共通部品作成ガイドラインサンプルプロジェクト xPalette成果物 • モジュラーモノリス関連 • プロジェクト特化 • xPaletteにまだないものは別途検討・作成。プロジェクト成果物（の一部）再掲

xPaletteを利用したプロジェクト共通処理の省力化 xPaletteの現場での活用事例 JSON変換設定 DB日時取得業務日時取得冪等性管理メッセージ管理（プロパティ） REST-APIサーバ例外ハンドリングフィルタエラーハンドラ共通例外セキュリティ関連共通コンテキスト REST-APIクライアント設定 JSONログ出力設定 SQLログ出力メッセージロガー REST-APIクライアントジャーナルログマスクアクセスログログ出力共通項目設定ヘルスチェック閉塞制御アプリケーションモジュール分割方式設計・標準化などを経て、アプリ設定や共通部品開発が待ち受けるプロジェクトにおける設定・実装すべき項目の一例などなど…

xPaletteを利用したプロジェクト共通処理の省力化 xPaletteの現場での活用事例 JSON変換設定 DB日時取得業務日時取得冪等性管理メッセージ管理（プロパティ） REST-APIサーバ例外ハンドリングフィルタエラーハンドラ共通例外セキュリティ関連共通コンテキスト REST-APIクライアント設定 JSONログ出力設定 SQLログ出力メッセージロガー REST-APIクライアントジャーナルログマスクアクセスログログ出力共通項目設定ヘルスチェック閉塞制御アプリケーションモジュール分割方式設計・標準化などを経て、アプリ設定や共通部品開発が待ち受けるプロジェクトにおける設定・実装すべき項目の一例などなど… xPaletteを用いると上記の設定・開発を省力化することが可能

xPaletteバックエンドのラインナップ xPaletteの現場での活用事例開発環境構築ビルドログ出力エラーハンドリングファイルダウンロードファイルアップロードセッション管理 RDBアクセス O/Rマッパー設定値管理 Beanマッパーメッセージ管理 REST通信ヘルスチェックアクセスログエラーハンドリング SQLログ RESTクライアントログログメッセージ管理入力値データ送受信セッション管理ユーザー認証画面表示・ブラウザリリース・運用開発ガイドライン共通部品作成ガイドラインセキュリティガイドラインサンプルプロジェクト

開発ガイドラインとは… xPaletteの現場での活用事例 ◼よく利用するところだと… ⚫ Spring Boot + コンテナを利用した際の設定値管理のベストプラクティス ⚫ よく出力するログ一覧やログ標準化設定例など、NRIの技術支援で得られたノウハウをxPaletteにフィードバックしています。 Spring Bootをベースとした開発ノウハウを記載したガイドを作成

セキュリティガイドラインとは… xPaletteの現場での活用事例 ◼NRIでは全社標準のセキュリティガイドラインが存在しており、 Spring Boot + Spring Securityの開発においてそのガイドラインに準拠するための実装や設定について網羅的に記載しています。 NRI標準のセキュリティガイドラインに準拠するためのガイドを作成

共通部品作成ガイドラインとは… xPaletteの現場での活用事例 ◼共通部品をそのまま提供するのではなく、どのような意図で共通部品を作成すべきかなどを示したガイドラインです。 ◼ガイドライン以外に下記も提供しているので、プロジェクト利用でもスムーズに導入できます。 ⚫ 共通部品サンプルコード ⚫ 共通部品利用サンプル共通部品を作成するためのノウハウを記載したガイドを作成

xPaletteを利用したプロジェクト共通処理の省力化 xPaletteの現場での活用事例 JSON変換設定 DB日時取得業務日時取得冪等性管理メッセージ管理（プロパティ） REST-APIサーバ例外ハンドリングフィルタエラーハンドラ共通例外セキュリティ関連共通コンテキスト REST-APIクライアント設定 JSONログ出力設定 SQLログ出力メッセージロガー REST-APIクライアントジャーナルログマスクアクセスログログ出力共通項目設定ヘルスチェック閉塞制御アプリケーションモジュール分割方式設計・標準化などを経て、アプリ設定や共通部品開発が待ち受けるプロジェクトにおける設定・実装すべき項目の一例などなど… xPaletteを用いると上記の設定・開発を省力化することが可能こちらを例として共通部品作成ガイドラインについて紹介

共通部品作成ガイドライン xPaletteの現場での活用事例 ◼SQLログ出力部品をガイドライン化した背景… ⚫ NRIではO/R MapperとしてMyBatisを利用することがよくある。 ⚫ 開発・テスト時に実行したSQLをログ出力しておくと、デバッグ時に便利。 ⚫ Mybatisの機能としてSQLログ出力機能はあるが、出力フォーマット変更などの柔軟性に欠ける。 ◼MybatisのSQLログ出力部品を作成することにより、柔軟なログ出力を可能にする。 2025-06-01 14:19:04 [application] INFO j.c.n.p.l.c.m.l.i.SqlLoggingInterceptor – [SQL_JOURNAL] sqlId=jp.co.nri.palette.example.rest.db.mybatis.mapper.SampleTableMapper.insert sql={INSERT INTO sample_table (id, point, type_id, chars, insert_date, insert_timestamp) VALUES (?, ?, ?, ?, ?, ?)} parameters={id=11125, point=11111, typeId=11111, chars=11111, insertDate=20250101000000.000, insertTimestamp=20250101134556.000} (elapsed time: 19 ms) SQL実行ごとのログ出力 SQL実行時間の計測ログ出力フォーマットや出力項目のカスタマイズ

共通部品作成ガイドライン xPaletteの現場での活用事例 ◼SQLログ出力ガイドラインの「実装クラス一覧と役割」として下記のようなクラス図を記載。

共通部品作成ガイドライン xPaletteの現場での活用事例 ◼SQLログ出力ガイドラインの「拡張ポイントについて」にはどのように拡張するのかを記載。

共通部品作成ガイドライン xPaletteの現場での活用事例 ◼SQLログ出力ガイドラインの「利用方法」には利用のための設定を記載。

モジュラーモノリス標準化

プロジェクト成果物の一部はxPaletteを用いて省力化可能 xPaletteの現場での活用事例とモジュラーモノリス標準化プロジェクト特化 xPalette未取込プロジェクト共通 xPalette利用可アプリケーション処理方式標準化共通部品サンプル開発ガイドラインセキュリティガイドライン共通部品作成ガイドラインサンプルプロジェクト xPalette成果物 • モジュラーモノリス関連 • プロジェクト特化 • xPaletteにまだないものは別途検討・作成。プロジェクト成果物（の一部）再掲

アーキテクチャ概観モジュラーモノリス標準化非同期処理イベント駆動などを実現するため非同期処理方式を導入。モジュラーモノリス Spring Modulith導入でモジュールの疎結合化を実現。トランザクションアウトボックス業務的なDB更新とメッセージ更新を同一のDBトランザクションで実現する設計パターン。TxOutBox自体もSpringで実装。アーキテクチャとしての主な特徴 REST REST REST REST 非同期 TxOutBox Queue Module A Module B Module A Module B BFF 方式設計・標準化担当範囲メッセージ管理業務テーブル DB フロントエンド

あるプロジェクトでアーキテクチャとしてモジュラーモノリスを選択 xPaletteの現場での活用事例とモジュラーモノリス標準化顧客からのアーキテクチャ要望は下記。 1. 厳密なデータ整合性 2. コードの再利用性 3. マルチベンダ開発 ⇒ 開発体制・コスト・要望を勘案した結果、モジュラーモノリスを選択。 ⇒ 将来的なサービス分割も視野に方式設計を実施。円が業務の実装単位 1つのプロセスにまとめて実行四角が業務の実装単位業務それぞれでプロセスを実行呼び出し関係凡例プロセス単位モノリスモジュラーモノリスマイクロサービスこちらを採用当初の顧客要望再掲

モジュラーモノリスのサービス分割を見据えた設計のポイントモジュラーモノリス標準化 ① モジュールを疎結合に保つ仕組みモジュラーモノリスの根幹となるモジュールを疎結合に保つための仕組み。今回はSpring Modulithの機能を利用する。 ② モジュール間呼び出しIF 隣のモジュールを呼び出す際のインターフェースの考慮。あるモジュールをサービス分割した際にどれだけ簡単に呼び出し箇所を切り替えできるか。 ③ 非同期処理方式の用意サービスの疎結合化や時間のかかる処理をバックグラウンドで処理するため、非同期処理方式を用意。

Spring Modulith機能でパッケージ境界を規定モジュラーモノリス標準化 ◼Application.Java（mainクラス）のパッケージをベースパッケージとみなす。 ⚫ 例の場合、ベースパッケージは「example」（①）。 ◼ベースパッケージ直下のパッケージをそれぞれモジュールと認識する。 ⚫ 例の場合、「inventory」「order」をそれぞれモジュールとして認識する（②）。 ◼他のモジュールを呼び出したい場合、明示的にどのモジュールを呼び出すのかを定義する。 ⚫ 下記はinventoryのpackage-info.javaにApplicationModuleでorderへの依存を許可させている（③）。 ② ① ③ ⇒ 詳細は下記URLを参照。 https://spring.pleiades.io/spring-modulith/reference/fundamentals.html ① モジュールを疎結合に保つ仕組み ② モジュール間呼び出しIF ③ 非同期処理方式の用意

Spring Modulith機能でパッケージ境界を規定モジュラーモノリス標準化 ◼モジュール構造チェックを実施する。 ⚫ サブドメインごとに分割したモジュールが、規定した依存先にのみ依存しているかチェック ⚫ チェックするためのコードは下記。 @SpringBootTest class ModularMonolithSampleApplicationTests { @Test void test() { var modules = ApplicationModules.of(Application.class); modules.forEach(System.out::println); // モジュール情報の出力 modules.verify(); // モジュール構造チェック } } モジュール inventory モジュール order inventoryはorderに依存するが、 orderはinventoryに依存してはならない ① モジュールを疎結合に保つ仕組み ② モジュール間呼び出しIF ③ 非同期処理方式の用意

Spring Modulith機能でパッケージ境界を規定モジュラーモノリス標準化 ◼モジュール構造チェックの実行結果が下記。 # Inventory > Logical name: inventory > Base package: example.inventory > Spring beans: o ….controller.InventoryController o ….core.service.InventoryApplicationServiceImpl # Order > Logical name: order > Base package: example.order > Spring beans: o ….controller.OrderController o ….core.service.OrderApplicationServiceImpl - Module 'order' depends on non-exposed type example.inventory.core.service.InventoryApplicationService within module 'inventory'! OrderApplicationService declares constructor OrderApplicationService(OrderRepository, InventoryApplicationService) in (OrderApplicationService.java:0) - Module 'order' depends on non-exposed type example.inventory.core.entity.Inventory within module 'inventory'! Method <example.order.core.service.OrderApplicationService.findById(java.lang.String)> calls method <example.inventory.core.entity.Inventory.getInventory()> in (OrderApplicationService.java:41) - Module 'order' depends on non-exposed type example.inventory.core.service.InventoryApplicationService within module 'inventory’! （以下略） ---モジュール情報の出力結果--- ---モジュール構造チェック結果--- ① モジュールを疎結合に保つ仕組み ② モジュール間呼び出しIF ③ 非同期処理方式の用意許可されていないモジュールを呼び出している場合、エラーが発生する

独自ツールで正しいテーブルを参照しているか確認モジュラーモノリス標準化 ◼あるサブドメインから別のサブドメインのテーブルを参照していないかどうかのチェックも導入。 ⚫ 前提として、テーブル名のプレフィックスにサブドメイン名を入れるような標準化を実施。 Module A Module B サブドメインA サブドメインB テーブルテーブル Module A Module B サブドメインA サブドメインB テーブルテーブルサブドメイン間でテーブルの参照がされている良くない状態お手製チェックツールを用いてサブドメイン間のテーブル参照を検知 CIを実施してチェックツールを実行 ① モジュールを疎結合に保つ仕組み ② モジュール間呼び出しIF ③ 非同期処理方式の用意

モジュール呼び出しインターフェースを考慮する必要性モジュラーモノリス標準化 ◼モジュラーモノリスは将来的なサービス分割を考慮する必要がある。もし考慮していない場合… public List<Products> getProduct(List<Integer> productIds) { List<Product> products = productsService.getProducts(); /* 直接対象モジュールのメソッドを呼び出す */ return products; } public List<Products> getProduct(List<Integer> productIds) { List<ProductResponse> productResponses = restClient.get() .uri("https://service-d/products") .retrieve() .body(new ParameterizedTypeReference<>() {}); // Java Bean変換処理など… return products; inventory order cart product inventory order cart product 一部の業務で分割が必要になった場合、別のサービスとして切り出す。モジュラーモノリス一部のマイクロサービス化サービスサービス変更前：変更後：すべての箇所でメソッド呼び出しからREST クライアント呼び出しに変更する必要がある ① モジュールを疎結合に保つ仕組み ② モジュール間呼び出しIF ③ 非同期処理方式の用意 HTTP

モジュール/サービス呼び出しの切り替えを検討モジュラーモノリス標準化アプリ処理 REST Client モジュール呼出別モジュールサービス Client切替部品 HTTP通信メソッド呼出アプリ処理 Client(REST) REST Client Client(Module) モジュール呼出別モジュールサービス HTTP通信メソッド呼出設定によって切り替え DIで切り替え Client切替部品を用意アプリ処理からはClient切替部品を呼び出すだけ。ただ、 Client切替部品の実装自体に時間がかかる。 DIでClientを切り替えアプリでは通信先にあわせて実装を作成する。サービス統合/分割する場合、Client実装追加が必要。こちらを採用今回はわかりやすさや開発体制を考慮して DIでのクライアント切り替えを採用。 ① モジュールを疎結合に保つ仕組み ② モジュール間呼び出しIF ③ 非同期処理方式の用意

ClientからControllerを呼び出すような標準化を実施モジュラーモノリス標準化 ① モジュールを疎結合に保つ仕組み ② モジュール間呼び出しIF ③ 非同期処理方式の用意 Client(REST) REST Client Client(Module) モジュール呼出 Service Controller モジュールB モジュールA モジュラーモノリスY モジュラーモノリスX Service Controller HTTP通信モジュールA モジュラーモノリスX Service Controller Service Controller モジュールB メソッド呼出サービス呼び出し：モジュール呼び出し： Controllerをそれぞれのインターフェースにすることにより、設計や実装の省力化を図る。両方ともControllerを呼び出している

ClientからControllerを呼び出すような標準化を実施モジュラーモノリス標準化 @Service @RequiredArgsConstructor public class ProductAppilcationService { // Clientのインタフェース。 private final ProductClient productClient; @Override public Products getProduct(List<Integer> productIds) { // Clientを呼び出す。 List<ProductClientOutDto> getProductResponses = productClient.getProduct(productIds); （以下略） @Repository @RequiredArgsConstructor public class DefaultProductClient implements ProductClient { // APIのインタフェース。ここに実装クラス(Controller)がインジェクトされる。 private final GetProductApi getProductApi; @Override public List<ProductClientOutDto> getProduct(List<Integer> productIds) { // Controllerを通常メソッドとして呼び出す。 List<GetProductResponse> getProductResponses = getProductApi.getProducts(productIds).getBody(); return OrderClientDtoMapper.INSTANCE.mapToProductClientOutDtos(getProductResponses); } } Client - モジュール呼び出し実装 Client - サービス呼び出し実装 @Repository @RequiredArgsConstructor public class RestProductClient implements ProductClient { // RestClient private final RestClient restClient; @Override public List<ProductClientOutDto> getProduct(List<Integer> productIds) { // REST呼び出し実行 List<ProductResponse> getProductResponses = restClient.get() .uri("https://service-d/products") .retrieve() .body(new ParameterizedTypeReference<>() {}); return OrderClientDtoMapper.INSTANCE.mapToProductClientOutDtos(getProductResponses); } } アプリ処理 DIで切り替え ① モジュールを疎結合に保つ仕組み ② モジュール間呼び出しIF ③ 非同期処理方式の用意

非同期処理で実現しようとした方式はふたつモジュラーモノリス標準化コマンド処理イベント処理イベント処理ではクライアントは事象を送信する。 • ユーザが作成された。 • 注文が確定した。コンシューマは関心のあるイベントを受信して処理を実施。 • ユーザが作成された旨のメールを送信。 • 在庫引き当ての実施。イベント処理では事象発生の順序を保つ。 ⇒ 順序入替があるとサービス間で整合性が保てないコマンド処理ではクライアントは指示を送信する。 • 帳票の作成の指示。 • 集計処理実施の指示。コンシューマはコマンドを受信して処理を実施。 • 帳票作成の実施。 • 集計処理の実施。コマンド処理では順序制御が不要な処理のみ実施。 ⇒ 単発の重い処理を実施するだけにするサービス間を疎結合にするための方式時間のかかる処理を非同期に流す方式 REST TxOut Box Topic REST Command Consumer TxOut Box Queue Event Consumer A B A A ※これはサブドメイン ① モジュールを疎結合に保つ仕組み ② モジュール間呼び出しIF ③ 非同期処理方式の用意 Event Consumer Event Consumer C D Sub Sub

非同期処理で実現しようとした方式はふたつモジュラーモノリス標準化コマンド処理イベント処理イベント処理ではクライアントは事象を送信する。 • ユーザが作成された。 • 注文が確定した。コンシューマは関心のあるイベントを受信して処理を実施。 • ユーザが作成された旨のメールを送信。 • 在庫引き当ての実施。イベント処理では事象発生の順序が保つ。 ⇒ 順序入替があるとサービス間で整合性が保てないコマンド処理ではクライアントは指示を送信する。 • 帳票の作成の指示。 • 集計処理実施の指示。コンシューマはコマンドを受信して処理を実施。 • 帳票作成の実施。 • 集計処理の実施。コマンド処理では順序が不要な処理のみ実施。 ⇒ 単発の重い処理を実施するだけにするサービス間を疎結合にするための方式時間のかかる処理を非同期に流す方式 REST TxOut Box Topic REST Command Consumer TxOut Box Queue Event Consumer A B A A ※これはサブドメイン ① モジュールを疎結合に保つ仕組み ② モジュール間呼び出しIF ③ 非同期処理方式の用意 Event Consumer Event Consumer C D Sub Sub 方式を実現するためにAzure Service Busを採用 • セッション機能によって順序制御が可能。 • トピック・サブスクリプション機能により複数コンシューマに配信可能。 • 利用実績も考慮。

非同期コンシューマライブラリの決定モジュラーモノリス標準化 ◼Azure Service Busの機能をそのまま利用できるライブラリを採用する必要があった。 ⚫ JMSなどを利用すると、順序制御機能が利用できないなど制約あり。 ⚫ メッセージ受信時の処理をカスタマイズしたい要望があった。 Consumer Topic・Queue メッセージID:BBB メッセージID:AAA ライブラリメッセージハンドラ AAA メッセージハンドラ BBB Spring Cloud Azure Service Bus Starterを採用 • Azure Service Busと組み合わせたときの順序制御・カスタマイズ性を優先 ① モジュールを疎結合に保つ仕組み ② モジュール間呼び出しIF ③ 非同期処理方式の用意

トランザクションアウトボックス方式の決定モジュラーモノリス標準化方式説明と検討 DB製品のCDC DB製品ごとに機能として提供しているCDC。 SQL Databaseにも機能はあるが、Debeziumなどと連携が必要。サードパーティーのCDC DebeziumなどのOSSが存在する。やりたいことに対してtoo muchかつ、障害発生時の対応が難しい。定期処理の自作定期的にテーブルをくるくるしてService Busにメッセージを送信する機能を自作。そこまで難しくなく、カスタマイズもしやすい。 ※CDC: Change Data Capture…DBの変更更新を検知する方式 REST Event Consumer TxOut Box Topic Event Consumer Event Consumer トランザクションアウトボックスは自作を採用 ① モジュールを疎結合に保つ仕組み ② モジュール間呼び出しIF ③ 非同期処理方式の用意こちらを採用 Sub Sub

本日お話したことのまとめモジュラーモノリス標準化今回のモジュラーモノリス標準化では下記を実施。 1. モジュールを疎結合に保つ仕組み • SpringModulith機能でパッケージ境界を規定 • ツールなどを用いて正しいテーブルを参照しているかチェック 2. モジュール間呼び出しIFの考慮 • モジュラーモノリスからサービス分割した際に、モジュール呼出からサービス呼出に切替 3. 非同期処理方式の用意 • イベント処理,コマンド処理の利用 • トランザクションアウトボックスパターンの利用 ⇒ これらのポイントを抑えることで、サービス分割を考慮したモジュラーモノリスを実現

最後に

NRIではブログ発信や交流会開催もしてます！最後に ◼NRIでは atlax blogs を通じて様々な情報を発信しております！去年のJJUG CCC 2024 Fallの参加レポートなども公開させていただきました。 ◼また、定期的に Netadashi Meetup という交流会も実施しております。直近の開催は未定ですが、開催時は是非気軽に足を運んでいただければと思います！ JJUG CCC 2024 Fall で発表してきました！ - atlax blogs Netadashi Meetup - connpass

社内での開発コミュニティ活動とモジュラーモノリス標準化事例のご紹介/xPalette and ...

社内での開発コミュニティ活動とモジュラーモノリス標準化事例のご紹介/xPalette and Introduction of Modular monolith standardization

Other Decks in Programming

Featured

Transcript