Dev Machines

ビルドとテストのための隔離された開発環境。Proyecta Cloud が提供するフル Linux 環境。

Proyecta は、各プロジェクトに専用の 開発マシン（ランタイム）をプロビジョニングします。これは、開発中にアプリが動作する完全な Linux 環境を備えた隔離コンテナです。

Dev Machine の仕組み

プロジェクトを開くと、Proyecta は以下を実行します：

クラウド上に隔離コンテナ（Pod）を作成する
GitHub からコードをクローンする
依存関係をインストールして環境をセットアップする
アプリの development server を起動する
Builder にライブプレビューを表示する

プロビジョニングの進行状況は、ツールバー下部の Runtime Status Bar で確認できます。

プロビジョニングのステップ

起動中、ステータスバーには以下のステップが表示されます：

ステップ	説明
Creating pod	隔離コンテナを起動中
Health check	コンテナが正常に動作しているか確認中
Git init	リポジトリをクローン中
Environment setup	依存関係をインストール中（npm、pip など）
Starting services	アプリとインフラを起動中
Ready	Dev Machine が完全にオンライン状態

Dev Machine に問題が発生した場合の対処法

プレビューが読み込まれない、またはマシンがフリーズしているように見える場合：

Runtime Status Bar でエラーメッセージを確認する
Terminal を使ってログを調べる
それでも解決しない場合は、AI に問題のデバッグを依頼する

インフラサービス

Dev Machine には、データベースやその他のサービス用のサイドカーコンテナを含めることができます：

PostgreSQL — リレーショナルデータベース（ポート 5432）
PostGIS — 地理空間拡張機能付き PostgreSQL（ポート 5432）
Redis — インメモリキャッシュ（ポート 6379）
MongoDB — ドキュメントデータベース（ポート 27017）
MySQL — リレーショナルデータベース（ポート 3306）
MailHog — Web UI 付きメールテストサーバー（SMTP ポート 1025、UI ポート 8025）

実行中のサービスとその状態は Services パネルで確認できます。

ライフサイクルの状態

Dev Machine は以下のライフサイクル状態を経由します：

状態	説明
Pending	作成待ち
Initializing	環境をセットアップ中
Running	アクティブかつ正常な状態
Suspended	リソース節約のために一時停止中（すぐに再開可能）
Archived	コールドストレージに保存済み（復元に時間がかかる）
Restoring	アーカイブストレージから復元中
Failed	プロビジョニングまたは操作が失敗 — マシンは再プロビジョニング可能
Terminated	永続的に停止済み

マシンは非アクティブ状態が 60 分続くと自動的に Suspended になり、Suspended 状態が 24 時間続くと Archived になります。

よくある質問

Dev Machine がダウンした場合、公開中のアプリはどうなりますか？

アプリの backend（Convex のサーバーレス関数とデータベース）は Convex 独自のクラウドインフラ上で動作しており、Dev Machine の状態に関わらず利用可能な状態を維持します。ただし、アプリの frontend ファイルは Dev Machine から配信されるため、マシンが Suspended または Archived の状態になると、マシンが再開するまで訪問者には 503 エラーが表示されます。常に公開アクセスを維持したいアプリの場合はこの点にご注意ください。マシンを再開するとサイトは復元されます。

より高速な Dev Machine を使用できますか？

現在、すべての Dev Machine は同じリソース配分で動作しています。大規模なプロジェクトでより多くのキャパシティが必要な場合は、サポートまでお問い合わせください。

Dev Machine に直接アクセスできますか？

はい。組み込みの Terminal を使用すると、開発環境へのフルシェルアクセスが可能です。