如何在Vercel CLI中执行alembic upgrade head命令？

前提准备 #

• 本地已安装Vercel CLI（未安装可执行 npm install -g vercel）
• 本地项目目录与Vercel部署代码一致（已包含Alembic版本文件）

步骤1：登录并关联项目 #

1. 终端执行 vercel login 完成账号登录
2. 进入本地项目根目录，执行 vercel link，按提示选择对应Vercel项目完成关联

步骤2：同步环境变量 #

迁移依赖数据库连接等环境变量，执行以下命令将Vercel远程环境变量拉取到本地：

vercel env pull .env.local

确保Alembic配置从环境变量读取数据库连接，比如在env.py中添加：

import os
from dotenv import load_dotenv

load_dotenv()
config.set_main_option("sqlalchemy.url", os.getenv("DATABASE_URL"))

步骤3：本地执行迁移 #

1. 激活Python虚拟环境（若使用），安装项目依赖：

pip install -r requirements.txt

2. 执行迁移命令：

alembic upgrade head

此命令会直接连接Vercel项目使用的数据库，完成版本升级

可选：在Vercel远程环境执行迁移 #

（不推荐，Serverless环境可能存在超时限制）

1. 在package.json中添加迁移脚本：

{
  "scripts": {
    "migrate": "alembic upgrade head"
  }
}

2. 执行远程命令：

vercel run migrate

需确保Vercel部署环境已通过requirements.txt或Pipfile配置安装好Python及所有依赖

注意事项 #

• 确认DATABASE_URL指向Vercel项目的目标数据库，避免误操作本地数据库
• 迁移前建议备份数据库，防止数据丢失

内容的提问来源于stack exchange，提问作者Shiva Panda