TUEO オンプレミスデプロイマニュアル（国産化 / 信創）

納品エンジニアと運用チーム向けのデプロイマニュアル。TUEO はオンプレミスが基本方針です：お客様ごとに 1 セットの独立・単一サイト・分離構成。国産化を優先し、オフライン / エアギャップをデフォルトとし、ワンクリックで導入。データが企業の外に出ず、全工程で監査可能・ロールバック可能。

1. 国産化と信創への適合

TUEO は国産のソフトウェア・ハードウェア環境に全面的に適合し、信創対応マシン、国産 CPU アーキテクチャ、国産 GPU アクセラレータカード、信創オペレーティングシステム上でのデプロイ・稼働をサポートします。党政機関、公安、行政、エネルギー、金融などの重要業界が求める「安全・制御可能」のコンプライアンス要件を満たします：

• 国産 CPU アーキテクチャ：主要な国産 CPU（x86 と ARM エコシステム）をコントロールプレーンと計算ノードとしてサポート；
• 国産 GPU アクセラレータカード：国産 GPU によるモデル推論とベクトル検索の高速化をサポートし、完全な内網環境で稼働可能；
• 信創オペレーティングシステム：主要な国産 Linux ディストリビューションに適合し、そのソフトウェアソースとカーネルベースラインと互換；
• 信創での検証：公安、行政などの重要業界でデプロイ検証を完了しており、等保と分级保護の要件を満たします。

プラットフォームは汎用 x86 サーバーと標準 Linux ディストリビューションにも対応し、納品形態をカスタマイズできます：完全国産化スタック（信創対応マシン + 国産 GPU + 信創 OS）または汎用スタックのいずれでもワンクリックでデプロイ可能です。

2. デプロイ形態とアーキテクチャ

2.1 3 つの納品形態

2.2 階層アーキテクチャ

L3 製品とミドルウェア    identity · cohort · studio · capabilities · executor
                        + PG / Redis / MinIO / ナレッジベース / IM / モデルゲートウェイ
L2 運用プラットフォーム  TUEO Console（設定センター · ログ · ステータスウォール · デプロイオーケストレーション · バックアップ · 監査）
L1 基盤                 Harbor 内網イメージレジストリ · データベース高可用 · 証明書 · ゲートウェイ
L0 クラスタ基盤         k3s HA · 内網キャッシュ層 · イメージプロキシ
算力層                  マルチモデルコンピューティングサーバー —— 独立したコンピューティングノード、モデルを統一的にデプロイ・納管
L-1 OS ベースライン      国産 / 汎用オペレーティングシステム · カーネルベースライン · ソフトウェアソース高速化

マルチモデルコンピューティングサーバーは、デプロイアーキテクチャにおける独立したコンピューティングノードであり、モデルのデプロイに特化しています：

• 複数モデルを統一的にホスティング：大規模言語モデルの推論、ベクトル埋め込み、視覚 / 音声モデルを、同じコンピューティングノード上で必要に応じてデプロイ・スケジューリング可能；
• 国産 / 汎用アクセラレータカード：国産 GPU と汎用アクセラレータカードをサポートし、モデル推論とベクトル検索を完全に内網で完了；
• プラットフォームによる統一納管：モデルサービスは運用プラットフォームが登録・デプロイし、モデル鍵はサーバーから出ず、呼び出しは内網モデルゲートウェイが統一的にルーティング；
• 独立して拡張可能：業務規模に応じてコンピューティングノードを単独で拡張でき、コントロールプレーンと業務ノードに影響しません。

重要なポイント：基盤（データベース / キャッシュ / コンテナ基盤 / オブジェクトストレージ / モデルコンピューティング）も運用プラットフォームが統一的に管理する被管理オブジェクトであり、顧客が別途チームを手配して保守するサードパーティ基盤ではありません。プラットフォームは自らも被管理オブジェクトです（自己アップグレードはイメージの差し替えのみ、創世マニフェストが常に単一真値）。

3. デプロイ段階（ディレクトリがそのまま順序）

デプロイはリプレイ可能なスクリプト + サイトマニフェストを採用し、ベアメタルから本番環境を構築します。手作業の SSH は不要です：

デプロイ後、00 事前検証 のスクリプトは受入ヘルスチェックを兼ね、いつでも再実行できます。

4. サイトマニフェスト（宣言的設定）

お客様のサイトごとに 1 つの site/<name>.yaml を用意し、スクリプトがパラメータとして読み取ります。ハードコーディングはゼロです：

• サイト：名称、ドメインサフィックス、タイムゾーン；
• ネットワーク：Pod / サービスネットワークセグメント、ノードサブネット、ゲートウェイ、DNS、公網入口、帯域外管理網；
• ソース：オフライン bundle のパスまたはイメージ URL（エアギャップサイトはオフライン bundle を使用）；
• アクセス：踏み台サーバー、SSH 資格情報の参照（平文では保存しない）；
• ノード：ホスト名、内網 IP、ロール（コントロールプレーン / 計算 / マルチモデルコンピューティング）、ハードウェア仕様とハード制約；
• コンピューティング：アクセラレータカードの種類と数（国産 / 汎用どちらも可）、およびデプロイするモデル一覧とリソース予約。

5. オフラインとエアギャップデプロイ

エアギャップ（完全なネットワーク切断）はデフォルトの能力であり、オプションではありません：

• オフラインイメージ納品：オンライン環境でイメージをビルドしてパッケージ化 → サイト内で内網イメージレジストリにロード → クラスタが取得。ノードは docker 不要；
• オフライン bundle：コンテナ基盤、イメージ、システムパッケージをオフライン bundle にまとめ、エアギャップサイトに一度に持ち込み；
• 内網キャッシュ：イメージプロキシ + ソフトウェアソースキャッシュ。遅い公網（例：わずか 0.5 MB/s）でも、各依存関係は低速回線を 1 回だけ通過；
• オフライン更新：.tueoupdate 署名済み更新パッケージを署名検証後にインポートし、ディレクトリセグメントは能力プラットフォームへ、イメージセグメントは内網レジストリにインストール。未署名パッケージはすべて拒否；
• オフライン認可：署名付き License をネットワーク接続ゼロでアクティベートし、ソフトノードロックで複数デプロイへの複製を防止。

6. 運用マニュアル

デプロイ完了後、すべての運用は TUEO Console の 1 つの画面で完結します：

プラットフォームの自己アップグレード：コードを push すると自動ビルド → イメージ昇格 → イメージ差し替え → ヘルスチェックで収束。アップグレードはイメージタグのみを変更し、創世マニフェストを再レンダリングしません（データボリューム / マスターキー / ゲートウェイはすべて保持）。

7. セキュリティとコンプライアンス

• データが企業の外に出ない：すべてのコンポーネントを内網にデプロイし、モデルは顧客自社管理のゲートウェイまたはローカルモデルを利用でき、秘密鍵が顧客ネットワークの外に出ません；
• マルチテナントの物理分離：データベースの行レベルセキュリティ + サービス層の明示的なテナントフィルタによる二重防御；
• 監査記録：暗号学的ハッシュチェーン監査で改ざんを検出可能；機微な操作は二次確認 + 承認フロー；
• 多層防御：OIDC シングルサインオン、ロールの集約、資格情報ボールトの暗号化、ネットワーク遮断サンドボックス、コンテンツ安全ゲート；
• 信創コンプライアンス：サイト全体をオンプレミスでデプロイし、等保、分级保護、重要業界のコンプライアンス要件を満たします。

8. 納品チェックリスト

デプロイについてご不明な点がある場合、または信創環境での共同チューニングが必要な場合は、TUEO 納品チームにお問い合わせください。