マイクロサービス・アーキテクチャ

目次

• 概要
• 使用する時機
• クイックスタート
• リファレンスガイド
• ベストプラクティス

概要

マイクロサービス・アーキテクチャの設計、実装、保守に関する包括的なガイドです。サービスの分解、通信パターン、データ管理、デプロイ戦略、および分散システムの可観測性をカバーしています。

使用する時機

• 新しいマイクロサービス・アーキテクチャの設計
• モノリシックアプリケーションの分解
• サービス間通信の実装
• APIゲートウェイとサービスメッシュのセットアップ
• サービスディスカバリーの実装
• 分散トランザクションの管理
• サービス間のデータ一貫性設計
• 独立したサービスのスケーリング

クイックスタート

最小限の動作例：

Bounded Contexts:
┌─────────────────┐  ┌─────────────────┐  ┌─────────────────┐
│  Order Service  │  │  User Service   │  │ Payment Service │
│                 │  │                 │  │                 │
│ - Create Order  │  │ - User Profile  │  │ - Process Pay   │
│ - Order Status  │  │ - Auth          │  │ - Refund        │
│ - Order History │  │ - Preferences   │  │ - Transactions  │
└─────────────────┘  └─────────────────┘  └─────────────────┘

リファレンスガイド

references/ ディレクトリの詳細な実装：

ベストプラクティス

✅ すべきこと

• ビジネス機能を中心にサービスを設計する
• 可能な限り非同期通信を使用する
• レジリエンス向上のためにサーキットブレーカーを実装する
• APIゲートウェイを横断的関心事に使用する
• 分散トレーシングを実装する
• サービス間通信にサービスメッシュを使用する
• 障害を考慮した設計を行う（カオスエンジニアリング）
• すべてのサービスにヘルスチェックを実装する
• リクエスト追跡のための相関IDを使用する
• APIをバージョニングする
• 適切なモニタリングとアラーティングを実装する
• 疎結合のためにイベント駆動アーキテクチャを使用する
• べき等な操作を実装する
• サービスごとにデータベースを使用するパターンを採用する

❌ すべきでないこと

• サービス間でデータベースを共有する
• 過度に細粒度なサービスを作成する（ナノサービス）
• 分散トランザクション（2フェーズコミット）を使用する
• ネットワーク遅延と障害を無視する
• サービス間でドメインモデルを共有する
• すべてのサービスを1つのユニットとしてデプロイする
• サービスURLをハードコードする
• 認証・認可の実装を忘れる
• 長時間実行される操作に同期呼び出しを使用する
• 後方互換性を無視する
• モニタリングとログ出力をスキップする
• サービス間の循環依存を作成する