团队协作

迁移

从更早的 OnGrid 系安装迁移到当前 OpsKeeper。权威指南是 docs/migration/opskeeper-user-transition.md。

开始之前

阅读 docs/PROVENANCE.md 中的兼容性映射。
阅读 docs/BRAND_GOVERNANCE.md 中的命名政策。
运行任何迁移前先备份现有 PostgreSQL 数据库。

第 1 步 · 从源系统导出快照

自服务迁移工具是 opskeeper-migrate（cmd/opskeeper-migrate）。支持 9 类实体，写入幂等、可回滚、有限速、多租户隔离。

export

go build -o opskeeper-migrate ./cmd/opskeeper-migrate

opskeeper-migrate export \
  --source "$OPSKEEPER_OLD_URL" \
  --output ./snapshot.json

第 2 步 · 导入 OpsKeeper

import

opskeeper-migrate import \
  --source ./snapshot.json \
  --target "$OPSKEEPER_NEW_URL" \
  --tenant-mapping "$TENANT_MAP"

第 3 步 · 校验源与目标

verify 子命令按实体对比导出快照与目标系统并报告偏差（可输出 HTML 报告）。切流之前应零偏差。

verify

opskeeper-migrate verify \
  --source ./snapshot.json \
  --target "$OPSKEEPER_NEW_URL" \
  --tenant-mapping "$TENANT_MAP" \
  --report ./verify-report.html

回滚

每次导入都会留档。用导入时生成的 rollback snapshot 撤销一次迁移：

rollback

opskeeper-migrate rollback \
  --rollback-snapshot ./rollback-20260911.json \
  --target "$OPSKEEPER_NEW_URL"

随时可用 opskeeper-migrate list-entities 列出支持的实体类型。

求助

在 github.com/vincent-wuhan/opskeeper/issues 上开一个带 migration 标签的 issue，并附上 opskeeper-migrate --help 的输出。