<span id="known-issues" />

# 既知の問題

このページでは、注意が必要な挙動や、リリースによる確認が必要な挙動を記録しています。レビュー中のコード修正は、稼働中のサービスについての保証ではありません。

<span id="sandbox-pause-and-expiration" />

## サンドボックス の一時停止と有効期限

一時停止は、残りの有効期間を凍結することを意図しています。ノードの時計と別のクリーンアップ処理の競合により、一時停止された sandbox が元の期限後に終了することがあります。有効期限のない sandbox の node-agent 再起動と再開についても、ライフサイクル修正が必要です。

その修正が実環境テストを通過し、お使いのリージョンに届くまでは、長期的な状態保持を一時停止だけに頼らないでください。ファイルは `/data` 配下の Persistent Volumes に保存するか、アプリケーションの状態をデータベースまたはオブジェクトストレージに保存してください。ホストメモリはバックアップではありません。明示的な有効期間を設定し、タスク終了時には sandbox を解放してください。

<span id="redeploy-is-not-rollback" />

## 再デプロイはロールバックではありません

`lizard redeploy` は、選択したソースを現在の構成でもう一度ビルドします。以前のビルドを選択するわけではありません。ビルド失敗と起動失敗では影響が異なります。復旧手順を選ぶ前に、アクティブなサービスとそのログを確認してください。起動失敗時でも、すべてのランタイムが古いリリースの提供を維持するとは限りません。

<span id="dockerfile-precedence" />

## Dockerfile の優先順位

明示的な build コマンドまたは start コマンドは、リポジトリの Dockerfile より優先されます。`dockerfilePath` を選択する場合は、これらのオーバーライドをクリアしてください。設定更新それ自体がビルドを開始することがあるため、別の再デプロイを送る前にイベントを確認してください。[Dockerfile のトラブルシューティング](https://lizard.build/ja/docs/deploy/troubleshooting/incomplete-dockerfile)を参照してください。

<span id="templates-and-mcp" />

## テンプレートと MCP

現在の Sandboxes 作成 API は、組み込みの 2 つのテンプレートを受け付けます。カスタムテンプレートに `lizard push` を使う手順は、現在公開されている CLI と一致しません。

Lizard Skill は Lizard CLI を使用します。そのワークフローでは MCP トランスポートは公開されません。独自のリモート MCP サーバーをホストするには、別個のアプリケーションデプロイが必要です。[ガイド](https://lizard.build/ja/docs/guides/deploy-mcp-server)を参照してください。

<span id="service-port-changes-fixed-and-verified-on-2026-09-09" />

## サービスポートの変更: 2026-09-09 に修正済み・確認済み

9 月 7 日の確認では、準備完了のプロセスがあるにもかかわらず、アップロードサービスのポートを `3000` から `80` に変更した後に HTTP 503 が発生しました。本番修正により、選択したポートが実行中のサービスに適用され、アップロード時および再ビルド時にも明示的なポートが維持されるようになりました。実環境でのポート変更確認は 9 月 9 日に成功しました。デプロイ後は、サービス状態だけでなく公開 URL も確認してください。

<span id="upload-archives-and-failed-build-exit-codes-fixed" />

## アップロードアーカイブとビルド失敗時の終了コード: 修正済み

Lizard CLI 0.3.95 は、ソースアップロードから macOS の `._*` メタデータエントリを除外し、クラウドビルド失敗時に非ゼロの終了コードを返します。古い CLI バージョンは更新してください。`COPYFILE_DISABLE` はもう不要です。[フレームワークチェック](https://lizard.build/ja/docs/framework-guides/validation)では、現在の CLI を使った macOS からのアップロードをカバーしています。

ビルドの成功だけでは、アプリが動作する証明にはなりません。デプロイ後に公開 URL、ルート、フォーム、データ操作を確認してください。
