デプロイ

vf deploy は、ローカルゲームプロジェクトを VifuHub で開けるプレイ可能なリリースにします。

MVP のデプロイは、まず自分と共有相手がすぐに遊べるリリースを作ります。

基本コマンド

ゲームのディレクトリで実行します。

vf deploy

別のディレクトリを指定する場合:

vf deploy ./my-game

--game-dir は古いエイリアスです。新しいドキュメントとチュートリアルでは位置引数のディレクトリを使います。

何が起きるか

1. ゲームディレクトリを解決します。
2. VifuHub 向けのプロジェクト設定がなければ、設定フローを開始します。
3. プロジェクト設定を検証します。
4. build.command があれば実行し、なければ静的 Web のビルド処理を使います。
5. build.output の HTML 入口と成果物ポリシーを検証します。
6. 検証に通り、成果物が変わっている場合だけアップロードします。
7. 同じログインユーザーとデプロイ名に対応するゲームを更新します。
8. --no-share がなければ、プレイ可能な URL を作ります。

サーバー ID は不要です。同じユーザーが同じプロジェクト名またはデプロイ名で再実行すると、同じゲームが更新されます。

初回デプロイの設定

プロジェクト設定がまだない場合、vf deploy はビルド前にプロジェクト詳細を確認します。設定フロー、CI での挙動、よくあるプロジェクト形態は デプロイ設定 を参照してください。

よく使うオプション

vf deploy --dry-run
vf deploy --yes
vf deploy --no-setup
vf deploy --no-build
vf deploy --no-share
vf deploy --name my-stable-game-name

• --dry-run はビルド、アップロード、共有、ファイル変更を行いません。
• --yes は検出された設定の既定値を使います。CI 向けです。
• --no-setup はプロジェクト設定がない場合に失敗させます。
• --no-build は既存の build.output をそのまま検証してアップロードします。
• --name は同じ所有者の更新先を安定させたいときに使います。
• --game-id は復旧や明示的な上書き用です。通常は不要です。

デプロイ管理

デプロイ済みゲームは vf games list、vf games share、vf games submit、vf games delete で管理します。詳しくは デプロイ管理 を参照してください。

既存ゲームを持ち込む

対応しているブラウザープロジェクトなら、プロジェクトフォルダーから始められます。

cd path/to/your-game
vf deploy

VifuHub 向けのプロジェクト設定がまだない場合、VifuHub CLI が入口とビルド構成を明確に検出できれば、確認後に作成します。検出できない場合は、足りないファイルや設定をエラーに表示します。

公開前チェック

vf deploy がプロジェクト設定とビルド出力を自動で確認します。デプロイ前に次を確認してください。

• main.url がビルド出力内の HTML 入口を指している。
• build.output が実際の静的ファイルを含んでいる。
• AI は hub.ai.generateText(...) または hub.ai.chat(...) 経由で呼んでいる。
• 保存、リソース、ホスト機能は @vifu/hub 経由で使っている。
• デプロイ成果物に CDN JavaScript、リモート WASM、外部 AI/API への直接呼び出しがない。

詳しくは デプロイポリシー を参照してください。