メインコンテンツへスキップ

概要

このドキュメントでは、Kodusのインフラストラクチャを支えるアーキテクチャについて説明します。当システムはコンテナ化とネットワーク分割を活用した分散アーキテクチャで構築されており、最大限のスケーラビリティ、セキュリティ、保守性を確保しています。

ネットワークと主要コンポーネント

インフラストラクチャは、パブリックアクセスと内部サービストラフィックを分離するDockerネットワークに分割されています:
  • shared-network: 公開サービスとエッジルーティング
  • kodus-backend-services: サービス間内部通信
  • monitoring-network: メトリクスとオブザーバビリティトラフィック(オプション)

コンポーネント

1. Kodus Webアプリケーション

フロントエンドプラットフォームはNext.jsで構築されており、APIレイヤーとの直接通信によってシームレスなユーザー体験を提供します。

2. コアバックエンドサービス

2.0スタックでは、バックエンドの責務を専用サービスに分割しています:
  • API: ビジネスロジックとリクエスト処理を担う中央サービスレイヤー
  • Worker: キューとバックグラウンドジョブの非同期処理
  • Webhooks: GitプロバイダーWebhookの専用サービス

3. MCP Manager

MCP Managerはプロバイダーとインテグレーションをカタログ化し、Kodusに公開することで、チームがPlugins画面からMCPをインストールできるようにします。

4. データストア

Kodusは2つのデータベースを使用します:
  • Postgres: リレーショナルデータと埋め込みメタデータ
  • MongoDB: 柔軟なドキュメントストレージ

5. メッセージングとオブザーバビリティ

RabbitMQは2.0で必須であり、API、ワーカー、Webhooks間の信頼性の高い非同期通信を提供します。 PrometheusとGrafanaはオプションで、モニタリングと可視化に使用されます。

6. 補助サービス(Kodus Cloud)

Kodus Cloudには、セルフホスト型デプロイメントには不要なクローズドソースの補助サービス(課金、アナリティクス、チャットインテグレーション)が含まれています。

次のステップ

Kodusをローカルで実行する

ローカル開発とKodusのフルスタックを理解するのに最適です。

Kodusを本番環境にデプロイする

本番環境へのデプロイとKodusの全機能を体験するのに最適です。