@ gate-forge/ pack- alembic (英语)
(原始内容存档于2018-10-21) (英语). Opt-in Alembic 迁移义务. 没有仓库 alembic 键入 .gateforge.yml 行为完全如前;没有增加移徙义务.
当启用时, Gateforge 只使用 Python AST 解析迁移脚本, 然后运行 upgrade → downgrade base → upgrade 对抗引擎创建 gf_tmp_<id> 数据库并删除。 信任的管理员 URL 仅来自此配置,从未来自测试环境. 套用债权不能履行这些义务.
alembic:
chains:
- name: invoices
migrations: migrations/versions
models:
- models.py
# Optional; defaults shown:
alembicIni: alembic.ini
modelsModule: models
metadata: Base.metadata
scratch:
adminUrl: postgresql://gateforge:[email protected]:5432/postgres
# Optional: seed existing rows, verify counts/fingerprints, and declare renames.
seed:
path: tests/seed.sql
tables:
- name: invoices
columns: [id, number]
copies:
- from: legacy_number
to: number
# Optional owner-approved irreversible revisions.
irreversible: []
# Optional; validates against target branch merge result.
merge:
targetRef: origin/main
gateforge init 当 alembic.ini 已存在;无法启用组合。 将块添加到 .gateforge.yml,提供一次性的 Postgres 服务和可信任的管理员 URL,然后运行 gateforge check。 。 。 .
迁移跑者需要Alembic、SQLAlchemy和一个PostgreSQL驱动程序(psycopg 或者说 psycopg2)在其Python环境中. 它不导入工程的 env.py。跑步者会绘制表格、列、约束、索引、图表和序列,但不包括 alembic_version与 seed,它比较行数 并声明纵列指纹 整个迁移。 在一个临时的 Git 工作树中测试一个配置的合并目标 .
原因代码( 所有添加剂): MIGRATION_MISSING, (中文(简体) ), MIGRATION_LINEAGE_BROKEN, (中文(简体) ), MIGRATION_DOWNGRADE_NOOP, (中文(简体) ), MIGRATION_DRIFT, (中文(简体) ), MIGRATION_ROUNDTRIP_FAILED, (中文(简体) ), MIGRATION_DATA_LOST, (中文(简体) ), MIGRATION_CONFLICT, (中文(简体) ), MIGRATION_SCRATCH_UNSAFE。 。 。 .
失败矩阵
test/scanner.test.ts 覆盖了没有数据库的静态病例:重复的修改代号,折叠的父母,和多头,都只用 Python AST 读取.
test/postgres.e2e.test.ts 覆盖一次性 PostgreSQL 实例上的引擎运行案例。 它被跳过,有印刷的原因,除非 GATEFORGE_ALEMBIC_TEST_ADMIN_URL 设置为丢弃实例的管理员 URL(例如 CI) postgres 服务集装箱). GATEFORGE_ALEMBIC_TEST_PYTHON 可选择选择一个已经拥有 Alembic, SQLAlchemy 和 PostgreSQL 驱动程序; 它默认为 python3。 。 。 .
| 大小写 | 原因代码 |
|---|---|
| 模式改变,没有在同一变化中迁移 | MIGRATION_MISSING |
downgrade() 空或不完整 | MIGRATION_DOWNGRADE_NOOP |
| 迁移链与模型不符 | MIGRATION_DRIFT |
| 种子装入后的破坏性重命名 | MIGRATION_DATA_LOST |
| 两个分支更改同一个表格,合并结果保留两个头 | MIGRATION_CONFLICT |
| 合并修订断开合并结果上的种子行 | MIGRATION_DATA_LOST |
| 在抓取数据库创建后立即注入失败 | MIGRATION_ROUNDTRIP_FAILED,数据库已删除 |
套房还声称,只有 gf_tmp_<id> 在运行中记录的名称被删除:一个类似命名的现有数据库和所配置的应用程序数据库都以其数据存活.
packages/cli/test/alembic-first-run.test.ts 证明设置流程结束为结束: 复制 examples/alembic 进入新仓库, 运行 gateforge init,然后运行 check 财务报告和审定财务报表 next。如果没有块块,运行将完全不产生任何义务;通过它,引擎在可支配数据库上见证链条,而诚实的例子不会产生迁移结果。 之后编辑模型 check 财务报告和审定财务报表 next 报告 MIGRATION_DRIFT。它被跳过,带有印刷原因,除非 GATEFORGE_ALEMBIC_TEST_ADMIN_URL 已经设定,它需要 python3 来搭载 Alembic, SQLAlchemy, 和一个 PostgreSQL 驱动程序, 因为引擎运行 python3 就像生产一样.