spacetimedb-deploy

デプロイ、運用、本番環境の診断には、このスキルを使用します。

デプロイの基本パターン

• Maincloud への公開：

spacetime publish my-database --server maincloud

• Maincloud クライアントでは、URI として https://maincloud.spacetimedb.com を使用し、データベース名または ID を withDatabaseName/WithDatabaseName として指定します。
• 既存のデータベースを更新すると、モジュールがホットスワップされ、マイグレーションのチェックが実行されます。スキーマを変更するデプロイの前に、データベースのマイグレーションに関するガイダンスを読み込んでください。
• セルフホストの本番環境では、リバースプロキシの背後で SpacetimeDB を専用ユーザーとして実行してください。ホストを意図的に公開する場合を除き、公開ルートと管理ルートへのアクセスを制限してください。
• スタンドアロンモードはローカル開発に適しています。スタンドアロンでは SSL は直接サポートされません。
• ログは spacetime logs <database> --follow --level info で表示するか、所有者向けの HTTP ログエンドポイントから確認できます。
• PGWire では SpacetimeDB の認証トークンを PostgreSQL のパスワードとして使用します。これはシークレットとして扱い、ログに記録しないでください。

本番環境での注意事項

• キーのローテーションによりトークンが無効になったり、ID の継続性を計画していない場合に 401/403 が発生したりすることがあります。
• データベースの公開作成と管理を意図している場合を除き、/ に対する広範な Nginx プロキシルールを公開しないでください。
• セルフホスト環境の WebSocket では、リバースプロキシが /v1/database/<db>/subscribe に対する Upgrade と Connection: Upgrade ヘッダーをサポートしている必要があります。

リファレンス一覧

必要な情報	開く
Maincloud のデプロイ	references/how-to-deploy-maincloud.md
セルフホスト	references/how-to-deploy-self-hosting.md
キーのローテーション	references/how-to-self-hosted-key-rotation.md
ログ	references/how-to-logging.md
PGWire	references/how-to-pg-wire.md

ガイダンス

• 対象が Maincloud、ローカルのスタンドアロン環境、セルフホストの本番環境のどれなのかを明確にしてください。
• ユーザーが両方を必要としている場合を除き、CLI による公開手順とサーバーのインストール手順を混在させないでください。
• キーのローテーションと認証情報は機密情報として扱ってください。値を公開せず、必要な設定を説明する方法を優先してください。