如何在Dockerfile中使用Prisma并自动执行迁移命令？

可以实现完全无需人工干预的自动Prisma迁移操作，绝大多数执行失败的原因是命令执行阶段配置错误。

常见误区：将prisma migrate命令放在Docker镜像构建（RUN指令）阶段执行，该阶段无法访问运行时的数据库实例、也无法获取运行时注入的数据库连接环境变量，必然会执行失败。

核心实现逻辑 #

• 将无需连接数据库的prisma generate放在镜像构建阶段执行，利用构建缓存提升效率
• 将需要连接数据库的prisma migrate deploy放在容器启动阶段执行，触发时已经可以拿到运行时环境变量、连接到就绪的数据库

具体配置示例 #

1. Dockerfile配置 #

FROM node:18-alpine
WORKDIR /app

# 拷贝依赖声明和Prisma Schema文件
COPY package*.json ./
COPY prisma ./prisma/

# 安装依赖同时执行prisma generate，仅依赖本地Schema无需数据库连接
RUN npm ci --only=production
RUN npx prisma generate

# 拷贝项目剩余代码
COPY . .

# TS项目可增加构建步骤
# RUN npm run build

# 指定启动入口为自定义启动脚本
CMD ["./start.sh"]

2. 编写容器启动脚本start.sh #

在项目根目录创建start.sh文件，内容如下：

#!/bin/sh
# 执行生产环境无交互迁移
npx prisma migrate deploy
# 迁移完成后启动应用
node dist/index.js

执行以下命令给脚本增加执行权限：
chmod +x start.sh

注意事项 #

• 自动化迁移场景必须使用prisma migrate deploy命令，禁止使用开发环境的prisma migrate dev，后者会触发交互提示无法自动执行
• 如果使用Docker Compose部署，建议为数据库服务增加健康检查，确保数据库完全就绪后再启动Node服务，避免因数据库未就绪导致迁移失败
• 多副本部署场景下，建议单独配置一个一次性Job执行迁移操作，避免多个实例同时执行迁移出现冲突

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