公開スタンド
公開スタンドは、運用者の既存の Caddy エッジの背後で、クイックスタートスタックを使います。運用者が発行した資格情報による、評価用の導入です。リポジトリの再導入スクリプトは、デフォルトで https://yabanin.ai を対象とします。このページが説明するのは、その導入の契約であり、ライブの可用性チェックではありません。
アクセス
運用者から、管理アカウントと組織のゲートウェイキーを取得します。ローカルデモの固定資格情報は、ここでは適用されません。
| 公開面 | 公開パス | バックエンド |
|---|---|---|
| Web サイトとドキュメント | /、/docs | 静的な Docusaurus ビルド |
| ゲートウェイ | /gw/healthz、/gw/v1/... | ループバックのポート 8082 上のゲートウェイ。エッジが /gw を取り除きます |
| 管理ログインと API | /auth/...、/api/... | ループバックのポート 8086 上の管理 |
別に提供されるダッシュボードは、/stand を使うことがあります。そのアセットとエッジの経路は、クイックスタートの再導入スクリプトの外で管理されます。運用者が提供するダッシュボード URL を使ってください。共有 VPS の Caddy 設定は、deploy/caddy/Caddyfile.tmpl にある 3 ドメインのテンプレートではありません。
OpenAI 互換クライアントのベース URL として https://yabanin.ai/gw/v1 を、ゲートウェイキーとともに使います。/gw/v1/models が返すモデルを使ってください。再導入のスモークテストは、シード済みの mock-model を期待します。モック応答が検証するのはリクエストの経路であり、実プロバイダへの接続ではありません。実在の上流を設定するには、BYOK と 組織セットアップ に従います。
既存スタンドの再導入
Docker が動作しており、既存のスタンドホストへ SSH できる状態で、リポジトリのルートから実行します。
scripts/deploy-public-stand.sh --host operator@stand.example.com
スクリプトは、linux/amd64 向けに yabanin-quickstart:local をビルドし、現在インストールされているイメージに yabanin-quickstart:previous のタグを付け、新しいイメージを転送し、クイックスタートの Compose/ブートストラップのファイルとスクリプトだけを同期します。その後、リモートで docker compose --profile mock up -d --wait を実行します。
リモートの deploy/quickstart/.env と .stand-key は保持されます。イメージは、未コミットの変更を含む現在の作業ツリーから作られます。スクリプトは、コミットラベル(該当する場合は -dirty 付き)を、リモートの .deployed-version ファイルに記録します。新しい VPS、DNS、TLS、ダッシュボードのビルド、データベースバックアップはプロビジョニングしません。
| オプション | 意味 |
|---|---|
--host USER@HOST | SSH の宛先を上書きする |
--skip-build | 既存のローカルイメージを転送する。すでに存在している必要があります |
--skip-smoke | 導入後のチェックをスキップする |
--yes | スクリプトが受け付けます。現時点では確認プロンプトはありません |
YABANIN_STAND_DIR | リモートのソースディレクトリ。デフォルトは /opt/yabanin-src |
YABANIN_STAND_URL | 公開ベース URL。デフォルトは https://yabanin.ai |
YABANIN_STAND_HOST | --host がないときの SSH 宛先。明示的に設定します |
スモークチェックの対象は、ローカル/公開ゲートウェイの健全性、認証済みのモデル一覧、短いモックのチャット補完、管理ログインページです。スクリプトは SSH 経由で .stand-key を読みますが、表示はしません。これらのチェックは、ユーザーの BYOK プロバイダや、すべてのダッシュボードワークフローを検証しません。
イメージのロールバック
スタンドホスト上で、以前のイメージが現在のデータベーススキーマと互換であることを確認したあと、次を実行します。
docker tag yabanin-quickstart:previous yabanin-quickstart:local
cd /opt/yabanin-src/deploy/quickstart
docker compose --profile mock up -d --wait
ロールバックされるのはイメージだけです。同期された Compose ファイル、記録されたバージョンラベル、データベースマイグレーションは戻されません。イメージのロールバックだけでは足りない変更を導入するときは、データベースバックアップと以前の設定を残してください。初回の導入には、:previous イメージがないことがあります。
Web サイトの導入は別である
scripts/deploy-site.sh は web/site をビルドし、VPS の webroot をバックアップし、rsync --delete で内容をその場で置き換えます。ビルドに含まれないファイルは削除されます。そこに置かれた、手動でアップロードした Overview HTML やダッシュボードのアセットも含みます。公開前に、ビルド内容の全体を確認してください。webroot ディレクトリを入れ替えないでください。Caddy のバインドマウントは、その inode をたどります。
API、管理、ダッシュ ボードを別ドメインにし、明示的な永続ボリューム、アラート、ステータス生成、バックアップを備えた新しい導入には、本番 Compose ランブック を使います。