用途:在 Quarkus 应用中添加或审查 Mongock MongoDB 数据迁移,适用于 Quarkus MongoDB client 与 Panache Mongo。
主要能力:覆盖 Quarkiverse quarkus-mongock 扩展与 Quarkus MongoDB 客户端设置;quarkus.mongock.* 配置(含 migrate-at-start);代码优先的 @ChangeUnit 迁移,配合 @Execution 与回滚钩子;锁、幂等性、事务限制与默认客户端约束;使用 Dev Services 或 Testcontainers MongoDB 的 Quarkus 测试;与 @415-frameworks-quarkus-mongodb 协同。
使用方式:先阅读参考文件(含反模式与并行变更说明),检查 pom.xml、MongoDB 配置与既有持久化模式;确认 Quarkiverse Mongock 版本与当前 Quarkus 平台兼容性,再配置连接、迁移扫描与启动或显式 MongockFactory 执行;实现或重构 @ChangeUnit 类,保证幂等、显式排序、回滚钩子与安全的锁/事务设置;最后运行构建与测试并汇报结果。
约束:应用变更前必须运行 ./mvnw compile 或 mvn compile,编译失败立即停止;变更后运行 ./mvnw clean verify 或 mvn clean verify。添加 quarkus-mongock 前须核对最新 Quarkiverse Mongock 发布与 Quarkus 扩展目录兼容性,若扩展面向明显更旧的 Quarkus 版本,应停止并记录不兼容。若应用使用多个 MongoDB 客户端,须先确认 Quarkiverse Mongock 对默认客户端迁移设计的支持。
适用场景:在 Quarkus 中添加 Mongock 迁移、配置 quarkus-mongock、审查 MongoDB 数据迁移、创建 change unit、检查迁移顺序。
限制:具体版本号、配置示例与详细规则需查阅上述参考文件;资料未提供完整代码示例与价格信息。