コード管理のアクションをブラウザでプレビューできるようになりました！

ベースマキナの更新情報をお届けします。今回は、設定のコード管理で使うCLI（@basemachina/cli）のv1.10.0で、bm preview actionを追加しました。設定ファイルに書いたアクションを、bm syncで反映する前に、ブラウザの実行画面から試せます。

ブラウザの実行画面でアクションを試す

bm preview actionをオプションなしで実行すると、ブラウザでベースマキナの画面が開き、設定ファイルのアクションが一覧で表示されます。試したいアクションを選び、画面で引数を入力して実行するだけです。

# 設定ファイルのアクションを一覧で開く
bm preview action

# id が「fetch-users」のアクションの実行画面を直接開く
bm preview action fetch-users

アクションは保存せずに開発環境で実行するため、開発環境のアクションやバージョンはそのまま保たれます。

設定ファイルを保存し直すと、画面の内容が自動で読み込み直されます。エディターやAIエージェントでSQLやパラメーターを直し、保存してブラウザで実行し直す、という繰り返しを、bm syncを挟まずに回せます。パラメーターを変えた場合は、実行画面の入力欄も新しい定義に合わせて切り替わります。

レビュー設定を指定したアクション

reviewSettingIdを指定したアクションでも、bm preview actionはレビューを経由せずそのまま実行します。書き込みを伴うアクションなら、開発環境のデータはその場で変わります。ブラウザでは、実行画面に警告が表示され、実行ボタンが「レビューを経由せずに実行」になるので、実行前に気づけます。

ターミナルで実行する

ブラウザを開かずにターミナルで実行したい場合は、--terminalをつけます。結果は標準出力に出ます。引数は--argsにJSONで渡します。

bm preview action fetch-users --terminal --args '{"userId":"1"}'

ターミナルでの実行には、次の制約があります。

• アクションのIDの指定が必須です
• レビュー設定を指定したアクションは、--forceをつけた場合だけ実行します
• ファイル型のパラメーターを持つアクションは実行できません。ブラウザで実行してください

bm beta preview actionをお使いの場合

v1.7.0から提供していたbm beta preview actionは、v1.10.0以降はアクションを実行せず、bm preview actionを使うよう案内を表示して終了します。今後のバージョンで削除される予定です。

詳細はドキュメントの「bm preview action」をご参照ください。