跳到主要内容

使用 Prisma Migrate 部署数据库变更

要将待处理的迁移应用到暂存、测试或生产环境,请在您的 CI/CD 管道中运行 migrate deploy 命令

npx prisma migrate deploy
信息

本指南不适用于 MongoDB
对于 MongoDB,使用 db push 而不是 migrate deploy

何时运行 prisma migrate deploy 确切取决于您的平台。例如,简化的 Heroku 工作流包括

  1. 确保 ./prisma/migration 文件夹在源代码控制中
  2. 发布阶段 期间运行 prisma migrate deploy

理想情况下,migrate deploy 应该是自动化 CI/CD 管道的一部分,我们通常不建议在本地运行此命令来将更改部署到生产数据库(例如,通过临时更改 DATABASE_URL 环境变量)。在本地存储生产数据库 URL 通常被认为是不好的做法。

请注意,为了运行 prisma migrate deploy 命令,您需要访问通常添加到 devDependenciesprisma 依赖项。某些平台(如 Vercel)会在构建期间剪除开发依赖项,从而阻止您调用该命令。这可以通过将 prisma 作为生产依赖项来解决,方法是将其移动到 package.json 中的 dependencies。有关 migrate deploy 命令的更多信息,请参阅

使用 GitHub Actions 部署数据库变更

作为 CI/CD 的一部分,您可以运行 prisma migrate deploy 作为管道的一部分,以将待处理的迁移应用到您的生产数据库。

这是一个示例操作,它将针对您的数据库运行迁移

deploy.yml
name: Deploy
on:
push:
paths:
- prisma/migrations/** # Only run this workflow when migrations are updated
branches:
- main

jobs:
deploy:
runs-on: ubuntu-latest
steps:
- name: Checkout repo
uses: actions/checkout@v3
- name: Setup Node
uses: actions/setup-node@v3
- name: Install dependencies
run: npm install
- name: Apply all pending migrations to the database
run: npx prisma migrate deploy
env:
DATABASE_URL: ${{ secrets.DATABASE_URL }}

确保您已将 DATABASE_URL 变量 设置为存储库中的 secret,连接字符串周围没有引号。