Lizard で VitePress をデプロイする

Lizard は VitePress のドキュメントサイトをビルドし、生成された HTML を nginx を通じてポート 80 で配信できます。npm スクリプトと出力ディレクトリを docs ルートに合わせてください: vitepress build docs は docs/.vitepress/dist を書き出し、vitepress build は .vitepress/dist を書き出します。

この手順で使用する設定とファイルを含む、完全なソース例から始めてください。

ビルドスクリプトを設定する

docs/ 内の Markdown ファイルでは、package.json に次のスクリプトを保持します:

{
  "scripts": {
    "docs:dev": "vitepress dev docs",
    "docs:build": "vitepress build docs",
    "docs:preview": "vitepress preview docs"
  }
}

設定	このガイドでの値
ビルド	`npm run docs:build`
Docs root	`docs/`
Output	`docs/.vitepress/dist/`
Production server	nginx
サービスポート	`80`

検出機能は vitepress build を含むスクリプトを見つけ、その root 引数を使用します。そのスクリプトは直接的で曖昧さのないものにしてください。シェルラッパー、複数の一致するスクリプト、またはカスタムの outDir では、明示的なビルド設定または Dockerfile が必要です。

サイトをローカルで確認する

npm ci
npm run docs:build
npm run docs:preview

内部の Markdown ページとアセットを確認してください。cleanUrls: true では、VitePress は拡張子のないルートへリンクします。本番サーバーは、それらの URL を生成された HTML ファイルに解決する必要があります。base は実際のパスプレフィックスに設定するか、ドメインルートの場合は / に設定してください。VitePress deployment を参照してください。

デプロイする

CLI setup の後、docs/ の中からではなく、package.json を含むディレクトリから実行します:

lizard init --name vitepress-docs
lizard add --service web
lizard up --service web --port 80
lizard logs --build --service web --json
lizard ps --json

VitePress の設定、Markdown、ソースアセット、package manifest、lockfile を含めてください。ローカル依存関係、生成済み出力、キャッシュ、シークレットは除外します。サービスの開始コマンドとして vitepress dev または vitepress preview は設定しないでください。

クリーンルートと HTTP ステータスを確認する

新しい VitePress ビルドは、拡張子のないルートを生成された .html ファイルに解決し、存在しない URL には HTTP 404 を返します。この検出経路を使うため、コマンドオーバーライドは未設定のままにしてください。標準出力にはカスタム Dockerfile は不要です。カスタムルーティングについては、静的ルートと404エラーを参照してください。

クリーン URL に直接アクセスして再読み込みしてください。存在しないパスをリクエストし、HTTP 404 を確認します。古いイメージが存在しないパスに対してホームページを返す場合は、現在のルーティングルールを反映するためにサービスを再ビルドしてください。

ビルドで Missing script: build と報告される場合は、選択したパスが VitePress detector を使用していること、およびサービスコマンドのオーバーライドがそれを置き換えていないことを確認してください。ビルドが成功しても nginx がドキュメントを配信しない場合は、スクリプトの docs root とコピーされた出力ディレクトリを比較してください。コンテンツまたは設定を変更した後は再ビルドしてください。

2026 年 9 月 9 日のデプロイ確認とその制限については、テスト済みバージョンとクラウド結果を参照してください。

Docusaurus Hugo