跳到主要内容

使用 Prisma Migrate 部署数据库更改

要在预发布、测试或生产环境中应用待处理的迁移,请将 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 变量设置为存储库中的秘密,连接字符串不带引号。

© . All rights reserved.