mcpField
4
416-frameworks-quarkus-mongodb-migrations-mongock

416-frameworks-quarkus-mongodb-migrations-mongock

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

416-frameworks-quarkus-mongodb-migrations-mongock について

MongoDB クライアントまたは Panache Mongo を使う Quarkus アプリ向けに、Mongock のマイグレーション手順を示すスキルです。拡張機能の互換性確認、変更前のコンパイル、変更後の検証を含む実装とレビューを支援します。

主な機能

  1. 01Quarkiverse 拡張機能の互換性確認
  2. 02コードベースの @ChangeUnit マイグレーション
  3. 03ロールバックフックと順序設定
  4. 04ロックと冪等性の指針
  5. 05Dev Services と Testcontainers のテスト

活用シーン

  1. 01Quarkus への Mongock マイグレーション追加
  2. 02MongoDB マイグレーション設定のレビュー
  3. 03マイグレーション順序と安全性の確認

インストール

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

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

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

同梱ファイル

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

references/
416-frameworks-quarkus-mongodb-migrations-mongock-antipatterns.md
416-frameworks-quarkus-mongodb-migrations-mongock-parallel-change.md
416-frameworks-quarkus-mongodb-migrations-mongock.md

詳細

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

Quarkus および Quarkus MongoDB クライアント／Panache Mongo に Mongock マイグレーションのガイドラインを適用します。

このスキルの対象範囲

  • Quarkiverse の quarkus-mongock 拡張機能と Quarkus MongoDB クライアントのセットアップ
  • migrate-at-start を含む quarkus.mongock.* の設定
  • @Execution とロールバックフックを使用する、コードファーストの @ChangeUnit マイグレーション
  • ロック、冪等性、トランザクションの制限、デフォルトクライアントの制約
  • Dev Services または Testcontainers MongoDB を使用する Quarkus テスト
  • @415-frameworks-quarkus-mongodb との連携

対象範囲： 参照ルールと適切／不適切な例に基づいて推奨事項を適用します。

制約事項

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

  • 必須：変更を適用する前に ./mvnw compile または mvn compile を実行します
  • 安全性：コンパイルに失敗した場合は、直ちに中止します
  • 検証：改善を適用した後、./mvnw clean verify または mvn clean verify を実行します
  • 適用前：詳細なルールと適切／不適切なパターンについて、参照資料を読みます
  • 拡張機能の互換性：quarkus-mongock を追加する前に、最新の Quarkiverse Mongock リリースと Quarkus 拡張機能カタログが、使用中の Quarkus プラットフォームと互換性があることを確認します。最新の拡張機能が大幅に古い Quarkus バージョンを対象としている場合は、変更を適用せずに中止し、互換性がないことを記録します。
  • 例外的なケース：アプリケーションで複数の MongoDB クライアントを使用している場合は、デフォルトクライアントを使うマイグレーション設計を適用する前に、Quarkiverse Mongock のサポート状況を確認します

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

  • Quarkus に Mongock マイグレーションを追加する
  • quarkus-mongock を設定する
  • Quarkus MongoDB のデータマイグレーションをレビューする
  • Quarkus MongoDB 用の Mongock 変更ユニットを作成する
  • Quarkus サービスにおける Mongock マイグレーションの順序をレビューする

ワークフロー

  1. 参照資料を読み、MongoDB のセットアップを調査する

references/416-frameworks-quarkus-mongodb-migrations-mongock.md、references/416-frameworks-quarkus-mongodb-migrations-mongock-antipatterns.md、references/416-frameworks-quarkus-mongodb-migrations-mongock-parallel-change.md を読み、pom.xml、Quarkus MongoDB の設定、既存の @415-frameworks-quarkus-mongodb 永続化パターンを調査します。

  1. 拡張機能の互換性と実行ポリシーを確認する

MongoDB 接続設定、マイグレーションのスキャン動作、起動時実行と明示的な MongockFactory 実行のどちらを使用するかを設定する前に、Quarkiverse quarkus-mongock のリリースと Quarkus 拡張機能カタログとの互換性を確認します。

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

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

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

可能な場合は、Dev Services または Testcontainers MongoDB を使用する Quarkus テストを含めて、ビルド／テストを実行し、結果と今後のリスクを要約します。

参照資料

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

コメント

Markdown 対応