ローカル開発

ローカル開発の共通エントリーポイントとして mise を使用します。

セットアップ

mise install
mise run setup

mise run setup は dev/ 以下のローカルファイル、開発用トークン、age 鍵ファイルを準備し、必要に応じてコントローラーリポジトリを初期化します。既存のローカルファイルは上書きしません。

コントローラー、エージェント、Web UI を起動します：

mise run dev

ログの追跡またはスタックの停止：

mise run dev:logs
mise run dev:down

デフォルトでは、ドキュメントはアプリスタックと同時に起動しません。

mise run dev:docs # :5174 でドキュメントのみ起動
mise run dev:all  # アプリとドキュメントを起動

コミット前に標準のローカルチェックを実行します：

mise run check

必要に応じて時間のかかるバックエンドチェックを実行します：

mise run check:full

proto/** の変更後、追跡対象の Protobuf 出力と API ドキュメントを再生成します：

mise run gen

gen/go/、web/src/lib/gen/、site/content/docs/developer-guide/api/ の生成ファイルをコミットします。

実際のコントローラーとエージェントのフィクスチャスタックに対して、すべてのローカル E2E テストを実行します：

mise run e2e

最終更新日 13, 2026 • alexma233