マシン

マシンは SnapVM のワークスペースです。ランタイム、永続ストレージ、エージェント、ゲートウェイルーティングが 1 つのコンソール上のオブジェクトとして扱われます。

マシン名

マシン名は URL で使いやすい形式にします。小文字英数字とハイフンを使い、コンソールから作成する場合は 30 文字以内に収めます。

良い名前は安定していてプロジェクトに紐づいています。

• frontend-lab
• agent-host
• api-review
• workshop-01

長く使うマシンには、一時的な作業名を付けないようにします。

状態

状態	意味
creating	ランタイムをプロビジョニングし、エージェントを準備中
started	マシンが起動中で、ターミナルまたは HTTP 通信を受け付ける状態
stopped	ハイバネーションまたは停止中で、永続状態は残っている
destroying	ランタイムリソースを削除中
destroyed	マシンが完全に削除済み

デプロイによっては starting、stopping、suspended、failed などプロバイダ固有の状態も表示されます。遷移中の状態は一時的なものとして扱い、失敗状態はオペレーターやサポート確認が必要な状態として扱います。

ランタイム種別

デプロイによって、SnapVM は複数の起動種別を扱えます。

• 軽量な永続クラウドコンテナとしての Sprites
• Fly.io ベースの Fly Machines
• 既存ホストを登録する External machines

ユーザー視点の流れは共通です。マシンを作成または登録し、エージェントに到達できるまで待ち、ターミナルまたはアプリケーション URL を開きます。

ゲートウェイ URL

各マシンは HTTPS URL で公開できます。一般的なデプロイでは次の形式です。

https://<machine-name>.snapvm.app

ゲートウェイは、マシン内で設定された HTTP ポートへリクエストをルーティングします。ドメイン、デフォルトポート、認証動作が異なる場合はデプロイ設定を確認してください。

削除

マシン削除は永続的です。削除前に、マシン上のファイル、リポジトリ、生成物、ローカルデータベースを別の場所へ移しているか確認してください。

状態を残したままアクティブなコンピュートを止めたい場合は、削除ではなく停止またはハイバネーションを使います。