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

Documentation Index

Fetch the complete documentation index at: https://docs.jitera.ai/llms.txt

Use this file to discover all available pages before exploring further.

すべてのデータストア、キャッシュ、メッセージブローカーはHelmチャートにバンドルされており、デフォルトでクラスター内にデプロイされます。初期デプロイに外部セットアップは不要です。 本番環境の高可用性デプロイメントでは、これらのサービスをマネージドサービス(例:Amazon RDS、Azure Database for PostgreSQL、ElastiCache、Azure Cache for Redis)に外部化できます。コンポーネントの詳細についてはアーキテクチャ概要を参照してください。
Jiteraは異なるサービス用に2つの別々のPostgreSQLインスタンスを使用します:
データベースサービス用途バージョン
PostgreSQLAutomation(Rails)ユーザー、プロジェクト、権限、ビジネスロジック14.x
PGVectorUltron(Node.js)AIエンベディング、ベクトル類似検索16.x
これらは異なるメジャーバージョンの別々のインスタンスであり、それぞれ独立してプロビジョニングする必要があります。

PostgreSQL(Automation)

Automationサービス(Ruby on Rails)が使用するプライマリリレーショナルデータベース。ユーザー、プロジェクト、権限、ビジネスロジックを管理します。
属性
使用サービスAutomation(Rails)、Hasura
検証済みバージョン14
サポートバージョン14.x(最新までのすべてのパッチバージョン)
必要な拡張機能:
  • btree_gist — GiSTインデックス演算子クラス
  • citext — 大文字小文字を区別しない文字列型
  • cube — 多次元キューブデータ型
  • pg_stat_statements — クエリ実行統計
  • pg_trgm — トライグラムテキスト検索
  • pgcrypto — 暗号化関数
  • uuid-ossp — UUID生成
  • vector — ベクトル類似検索(pgvector)
これらの拡張機能はデプロイ時に自動的にインストールされます。マネージドサービスを使用する場合は、これらの拡張機能のインストールが許可されていることを確認してください。プロバイダー別の手順については、AWS EKSまたはAzure AKSを参照してください。
データベースを事前に作成しないでください。 Helmマイグレーションフックがdb:createで作成します。事前に作成するとdb:createが失敗し、後続のすべてのマイグレーション(db:migrate)がサイレントに中止され、スキーマが不完全になります。

PGVector(Ultron)

Ultronサービス(Node.js/NestJS)が使用する、AIエンベディングとベクトル類似検索専用の独立したPostgreSQLインスタンス。
属性
使用サービスUltron
検証済みバージョンPostgreSQL 16(pgvector付き)
サポートバージョン16.x(最新までのすべてのパッチバージョン)
必要な拡張機能:
  • btree_gist — GiSTインデックス演算子クラス
  • citext — 大文字小文字を区別しない文字列型
  • cube — 多次元キューブデータ型
  • pg_stat_statements — クエリ実行統計
  • pg_trgm — トライグラムテキスト検索
  • pgcrypto — 暗号化関数
  • uuid-ossp — UUID生成
  • vector — ベクトル類似検索(pgvector)
これらの拡張機能はデプロイ時に自動的にインストールされます。マネージドサービスを使用する場合は、これらの拡張機能のインストールが許可されていることを確認してください。プロバイダー別の手順については、AWS EKSまたはAzure AKSを参照してください。
データベースを事前に作成する必要があります。 helm installを実行する前にPGVectorインスタンス上にデータベースを作成してください。Helmマイグレーションフックは PostgreSQL(Automation)データベースのみを作成し、PGVector(Ultron)インスタンス上のデータベースは作成しません。
TLS制限: 外部PGVectorでのTLS強制は現在のHelmチャートではサポートされていません。マネージドデータベースインスタンスでTLS強制を無効にする必要があります:
  • AWS RDS: rds.force_sslパラメータを0に設定
  • Azure Database: require_secure_transportOFFに設定
Helm valuesではsslMode: disableを使用してください。接続はVPC/VNetプライベートサブネット内に留まります。

MongoDB

生成コードアーティファクト、デザインインポート、柔軟なスキーマデータ用のドキュメントデータベース。
属性
使用サービスAutomation
検証済みバージョン5.0
サポートバージョン5.0.x
mongodb_uriにはURIパスにデータベース名を含める必要があります(例:/jitera)。省略すると、接続はデフォルトでtestデータベース(MongoDB)またはadminデータベース(DocumentDB)を使用し、インデックス作成やデータ書き込みなどの操作が誤ったデータベースに対して実行されます。MongoDB接続文字列 — defaultauthdbを参照してください。
TLS制限(Amazon DocumentDB): 外部MongoDBとしてDocumentDBを使用する場合、DocumentDBクラスターのTLSを無効にする必要があります。Helmチャートのマイグレーションジョブは、DocumentDBのTLS証明書チェーンを検証できず、マイグレーションがサイレントに失敗します。tls=disabledのクラスターパラメータグループを作成し、mongodb_uritls=true含めないでください。接続はVPCプライベートサブネット内に留まります。

Redis

キャッシュ、セッション、ジョブキュー用のインメモリデータストア。
属性
使用サービスAutomation
検証済みバージョン6.2(スタンドアロン、認証なし)
サポートバージョン6.2.x
externalRedis.usernameフィールドは空でも明示的に設定する必要があります。省略すると、チャートが接続URIにプレースホルダー文字列を挿入し、URI::InvalidURIErrorクラッシュを引き起こします。ElastiCacheまたはAzure Cache for Redisの場合はusername: ""を設定してください。

RabbitMQ

非同期メッセージ処理用のメッセージブローカー。
属性
使用サービスAutomation
検証済みバージョン3.13(AWS Amazon MQ)
サポートバージョン3.13.x
Jiteraの Helm チャートは、デフォルトでクラスター内の Bitnami RabbitMQ サブチャートを使用し、バージョンは 3.8.35 が同梱されています。上記の検証済みバージョンは、外部のマネージドブローカーを使用する場合のものです — AWS Amazon MQ は現在 RabbitMQ 3.13 のみを提供しており、このバージョンを Jitera のセルフホストステージング環境で検証しています。
externalRabbitmq.hostはホスト名のみを含める必要があります — プロトコル(amqps://)やポート(:5671)を含めないでください。チャートがポートを別途付加します。ホストフィールドにポートを含めると、接続URLでポートが重複します。

関連ドキュメント

アーキテクチャ概要

コンポーネントの説明とサービス依存関係

Helm Values

Helmチャート設定の完全なリファレンス

デプロイ要件

必須およびオプションのデプロイ要件