跳至主要内容

使用 Prisma Migrate 部署数据库更改

要将待处理的迁移应用到 staging、测试或生产环境,请将 migrate deploy 命令作为 CI/CD 管道的一部分运行

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 命令,您需要访问通常添加到 devDependencies 中的 prisma 依赖项。一些平台,例如 Vercel,会在构建期间删除开发依赖项,从而阻止您调用该命令。可以通过将 prisma 变为生产依赖项来解决此问题,方法是将其移动到 package.json 中的 dependencies 中。有关 migrate deploy 命令的更多信息,请参阅

使用 GitHub Actions 部署数据库更改

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

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

deploy.yml
name: Deploy
on:
push:
paths:
- prisma/migrations/**
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 }}

高亮显示的行表示此操作仅在 prisma/migrations 目录发生更改时运行,因此 npx prisma migrate deploy 将仅在迁移更新时运行。

确保您已在仓库中将 DATABASE_URL 变量设置为Secret,连接字符串周围没有引号。