mcpField
5
516-frameworks-micronaut-mongodb-migrations-mongock

516-frameworks-micronaut-mongodb-migrations-mongock

github.com/jabrenaデータ・データベース456197 回インストール1 日前に更新
リポジトリ

516-frameworks-micronaut-mongodb-migrations-mongock について

Micronaut と Micronaut Data MongoDB プロジェクト向けに、Mongock のマイグレーション手順を示すスキルです。Runner とドライバーの選択、Bean の接続、実行制御を扱い、ビルドと統合テストで検証します。

主な機能

  1. 01Runner とドライバーの選択
  2. 02Micronaut Bean の接続
  3. 03コードベースの @ChangeUnit マイグレーション
  4. 04ロールバックフックと順序設定
  5. 05Testcontainers の統合テスト

活用シーン

  1. 01Micronaut への Mongock マイグレーション追加
  2. 02MongoDB データマイグレーションのレビュー
  3. 03起動時またはジョブ実行の選択

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/jabrena/plinth --skill 516-frameworks-micronaut-mongodb-migrations-mongock

インストール後、Claude Code で/516-frameworks-micronaut-mongodb-migrations-mongockを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
516-frameworks-micronaut-mongodb-migrations-mongock-parallel-change.md
516-frameworks-micronaut-mongodb-migrations-mongock-antipatterns.md
516-frameworks-micronaut-mongodb-migrations-mongock.md

詳細

Micronaut - MongoDB マイグレーション（Mongock）

Micronaut および Micronaut Data MongoDB 向けの Mongock マイグレーションガイドラインを適用します。

このスキルで扱う内容

  • Micronaut プロジェクト向けの Mongock ランナー／ドライバーの選択
  • MongoDB クライアントへのアクセスと、制御されたマイグレーション実行のための Micronaut Bean の配線
  • @Execution とロールバックフックを使用した、コードファーストの @ChangeUnit マイグレーション
  • ロック、冪等性、トランザクションの制限、起動時実行と実行時実行のトレードオフ
  • @MicronautTest と Testcontainers MongoDB を使用した統合テスト
  • @515-frameworks-micronaut-mongodb との連携

範囲： リファレンスのルールと良い例・悪い例に基づく推奨事項を適用します。

制約

Mongock または MongoDB のマイグレーションを変更する前にコンパイルし、変更後に検証してください。

  • 必須：変更を適用する前に ./mvnw compile または mvn compile を実行します
  • 安全性：コンパイルに失敗した場合は、直ちに中止します
  • 検証：改善の適用後に ./mvnw clean verify または mvn clean verify を実行します
  • 適用前：詳細なルールと良い例・悪い例のパターンについて、リファレンスを読みます
  • エッジケース：Micronaut 固有の Mongock ランナーが利用できない、または互換性がない場合は、明示的なスタンドアロンのランナー Bean／ジョブを使用し、そのトレードオフを記載します

このスキルを使用する場面

  • Micronaut に Mongock マイグレーションを追加する
  • Micronaut の MongoDB データマイグレーションをレビューする
  • Micronaut Data MongoDB で Mongock の変更単位を設定する
  • Micronaut MongoDB 向けの Mongock 変更単位を作成する
  • Micronaut サービスにおける Mongock マイグレーションの順序をレビューする

ワークフロー

  1. リファレンスを読み、MongoDB の設定を確認する

references/516-frameworks-micronaut-mongodb-migrations-mongock.md、references/516-frameworks-micronaut-mongodb-migrations-mongock-antipatterns.md、references/516-frameworks-micronaut-mongodb-migrations-mongock-parallel-change.md を読んでから、pom.xml、Micronaut の MongoDB 設定、および既存の @515-frameworks-micronaut-mongodb 永続化パターンを確認します。

  1. ランナー、ドライバー、実行ポリシーを選択する

互換性のある Mongock の座標を選択し、Micronaut Bean を通じてランナーを配線し、マイグレーションのスキャン対象パッケージを設定して、起動時実行と制御されたジョブ実行のどちらにするかを決定します。

  1. フレームワークに沿ったマイグレーションを適用する

冪等な操作、明示的な順序、ロールバックフック、安全なロック／トランザクション設定を備えた @ChangeUnit クラスを実装またはリファクタリングします。

  1. 検証を実行し、結果を報告する

実行可能な場合は、Testcontainers MongoDB を使った @MicronautTest を含め、ビルドとテストを実行し、結果と今後のリスクを要約します。

リファレンス

詳細なガイダンス、例、制約については、以下を参照してください。

コメント

Markdown 対応