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

オンプレミスインストールガイド

このドキュメントでは、EKB 製品のオンプレミス インストールと展開を成功させるために必要な、展開前の前提条件、検証手順、および考慮事項について概要を説明します。これは、導入を進める前に、クライアントの環境が適切に構成され、必要な要件をすべて満たしていることを確認するための包括的なチェックリストとして機能することを目的としています。

前提条件​

アクセス要件​

  • サーバーアクセス:
    • sudo 権限による展開サーバーへのアクセスを確認します。
    • 必要なすべてのネットワーク ルートが安全な VPN または専用ネットワーク構成を介して確立されていることを確認します。
  • ユーザー権限:
    • 導入チームに必要なアクセス権が付与されていることを確認します。
    • 必要な 2 要素認証 (2FA) またはセキュリティ トークンが設定されていることを検証します。

システム要件​

オペレーティング システム:
           Ubuntu 22 または RHEL 8.10

ハードウェア仕様:
      各展開層について、ハードウェアが次の条件を満たすかそれを超えていることを確認してください。

| Tier | Cores | RAM (GB) | SSD PLACEHOLDER_0 SMALL | 16 | 64 | 1TB PLACEHOLDER_1 MEDIUM | 32 | 128 | 2TB PLACEHOLDER_2 LARGE | Custom | Custom | Custom |

  • GPU (EKB プラットフォームと同じマシンに LLM を展開する場合に必要です。)
  • 小規模: 単一 VM 16 コア、64GB RAM、1 TB で最大 500 (同時 100) ユーザーをサポート可能
    • これらのマシンの SSD の費用は月額約 600 ドルです。これは最小サイズの展開です。
  • MEDIUM ～ 2000 (同時 500) ユーザーは、32 コア、128 GB RAM、2 TB の大型マシンでサポート可能
    • これらのマシンの SSD は月額約 $1,200 です
  • 大規模: ~10000 (同時 1000+) ユーザーをコンテナ全体にデプロイして、インフラストラクチャが
    • ニーズに合わせて拡張できます。通常、月額最低 \2,000 の費用がかかります。
    • 追加のアクティブ ユーザー 1,000 人ごとに月額 ¥2,000 を計算することを提案します。これは完全に

分散展開。

導入ツールとソフトウェアの依存関係​

  • 展開スクリプト:
    • 検証され、バージョン管理された Bash 導入スクリプト。
  • 依存関係管理ツール:
    • パイソン3
    • Git (現在のバージョン)
    • Docker (v27.1.1) または Podman
  • 追加ツール (オプション):
    • クライアントの監視要件に応じたロギングおよび監視ツール (ELK Stack、Prometheus、Grafana など)。

認証情報とキー​

  • サーバー認証情報:
    • すべてのサーバー アクセス資格情報が最新であり、安全に保管されていることを確認します。
  • アプリケーション API キーとライセンス:
    • すべてのアプリケーション固有の API キーとライセンス (OpenAI、SERP、Sentry など) が利用可能で有効であることを確認します。

導入前チェックリスト​

ハードウェアとシステムの検証​

クライアントのハードウェアおよびシステム構成が仕様と一致していることを確認します。

# Check CPU Information

lscpu                         # Works on both Ubuntu and RHEL

cat /proc/cpuinfo             # More detailed CPU information


# Check Memory Usage

free -h                       # Human-readable format for memory usage

cat /proc/meminfo             # Detailed memory information


# Check Storage Usage

df -h                         # Displays disk usage

lsblk                         # Lists block devices and partitions

3.2 ソフトウェアと依存関係の検証​

必要なソフトウェア コンポーネントがすべてインストールされ、正しくバージョン管理されていることを確認します。

# Check Docker Version

docker --version              # Applicable for both Ubuntu and RHEL


# Check Docker Compose Version

docker compose version        # For modern Docker setups

docker-compose --version      # For older installations

```

# Pythonのバージョンを確認する

python3 --version # Python 3 の優先チェック

python --version # python3 が利用できない場合の代替手段

# Gitのバージョンを確認する

git --version # Ubuntu と RHEL の両方に有効

3.3 Network and Connectivity Check​

Ensure the network is correctly configured and that there is adequate internet connectivity for external dependencies or updates:


ping -c 4 google.com # Google に ping を実行してネットワーク接続を確認します

カール - https://www.google.com | head -n 1 #curl を使用した代替チェック
「」

#### **3.4 追加の検証**

**サービスとポート**

| Service | Path | Parameter | Internal ports | External ports __PLACEHOLDER_5__ Frontend | / | FRONTEND_SUFFIX | 3000 | — __PLACEHOLDER_6__ Nginx | / | — | — | 80, 443 __PLACEHOLDER_7__ Backend | /backend | BACKEND_SUFFIX | 8001 | — __PLACEHOLDER_8__ Automator | /automator | AUTOMATOR_SUFFIX | 8002 | — __PLACEHOLDER_9__ Redis | — | — | 6379 | — __PLACEHOLDER_10__ RabbitMQ | — | — | 5672, 15672 | — __PLACEHOLDER_11__ Supabase Kong API Gateway | /supabase | SUPABASE_SUFFIX | 8000, 8443 | 8000, 8443 (admin only) __PLACEHOLDER_12__ Supabase Postgres | — | — | 6543 | — __PLACEHOLDER_13__ PostgreSQL (automator) | — | — | 5433 | — __PLACEHOLDER_14__ Redis (automator) | — | — | 6380 | — __PLACEHOLDER_15__ Ollama | — | — | 11434 | — (only if deploying Ollama locally) |

**プロトコルのサポート**

| Service | HTTP | HTTPS | WebSocket __PLACEHOLDER_16__ Frontend | ✓ | ✓ | — __PLACEHOLDER_17__ Nginx | ✓ | ✓ | — __PLACEHOLDER_18__ Backend | ✓ | ✓ | — __PLACEHOLDER_19__ Automator | ✓ | ✓ | — __PLACEHOLDER_20__ Redis | ✓ | ✓ | — __PLACEHOLDER_21__ RabbitMQ | ✓ | ✓ | — __PLACEHOLDER_22__ Supabase Kong API Gateway | ✓ | ✓ | ✓ __PLACEHOLDER_23__ Supabase Postgres | ✓ | ✓ | — __PLACEHOLDER_24__ PostgreSQL (automator) | ✓ | ✓ | — __PLACEHOLDER_25__ Redis (automator) | ✓ | ✓ | — __PLACEHOLDER_26__ Ollama | ✓ | ✓ | — |

> **注意:** すべての内部マシンは相互に自由に通信できる必要があります。 SSL (HTTPS) 接続を使用することをお勧めします。 HTTP は PoC 中にサポートされます。

**ファイアウォールとセキュリティの設定:**

ファイアウォール ルールまたはセキュリティ グループが必要なトラフィックを許可していることを検証します。

## 一般的なアーキテクチャ

![general-arc.png](/img/platform-admin/general-arc.png)

### アーキテクチャ図 – オンプレミス

前述の前提条件となるリソース割り当てを備えた単一の仮想マシン ボックスの展開アーキテクチャ フロー

![general-arc.png](/img/platform-admin/arc-diagram.png)

### AWS クラウド展開の展開アーキテクチャ フロー

![AWS EKS Architecture for EKB](/img/on-premise/aws-eks-architecture.png)