メインコンテンツまでスキップ

公開スタンド

公開スタンドは、運用者の既存の 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@HOSTSSH の宛先を上書きする
--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 ランブック を使います。