メインコンテンツへ移動

CLI

CLI は、デプロイコマンド、設定フラグ、スターターファイルを削除して簡素化されました。データベーススキーマのアップグレードを支援する新しい移行コマンドも追加されました。

追加
追加への直接リンク

mastra migrate コマンド
mastra-migrate-commandへの直接リンク

新しい mastra migrate コマンドは、Mastra のバージョンをアップグレードする際にデータベース移行を実行します。データに互換性がない可能性のある旧バージョンからアップグレードする場合に、特に役立ちます。

npx mastra migrate

このコマンドはプロジェクトをバンドルし、設定済みの Storage に接続してから、必要な移行を実行します。現在は、一意制約の作成を妨げる可能性がある重複した Span エントリの移行に対応しています。

この移行が必要になる条件については、Storage 移行ガイドを参照してください。

削除
削除への直接リンク

mastra deploy コマンド
mastra-deploy-commandへの直接リンク

mastra deploy コマンドが CLI から削除されました。この変更では、ベンダー固有のデプロイロジックを削除して CLI を簡素化しています。

移行するには、任意のデプロイプラットフォームを選択してください。

mastra build--env フラグ
--env-flag-from-mastra-buildへの直接リンク

mastra build コマンドから --env フラグが削除されました。この変更により、build コマンドが簡素化されます。

移行するには、mastra start --env <env> を使用し、カスタム環境でビルド出力を起動します。

- mastra build --env production
+ mastra build
+ mastra start --env production

mastra dev--port フラグ
--port-flag-from-mastra-devへの直接リンク

mastra dev コマンドから --port フラグが削除されました。ポートは Mastra インスタンスの設定で指定するようになりました。この変更により、ポート設定が一元化されます。

移行するには、CLI フラグの代わりに Mastra インスタンスの server.port を使用します。

const mastra = new Mastra({
server: {
port: 3001,
},
})

CLI の Telemetry オプション
CLI の Telemetry オプションへの直接リンク

--no-telemetry / -nt フラグを含む telemetry オプションが CLI コマンドから削除されました。Telemetry 設定は CLI から削除されています。この変更は、Telemetry 機能が Observability パッケージへ移行したことに伴うものです。

移行するには、CLI コマンドから Telemetry フラグを削除します。Tracing 機能には @mastra/observability を使用してください。