Prisma2 Docker 镜像文档

一、镜像概述

Prisma2 Docker 镜像为 Prisma 2 ORM 工具提供了独立的运行环境，基于 Alpine Linux 构建，集成了完整的 Prisma CLI 工具链。该镜像旨在简化 Prisma 项目的开发、构建与部署流程，提供一致的命令行环境，支持数据库模式定义、迁移管理、客户端生成等核心功能。

二、核心功能与特性

2.1 核心功能

完整 Prisma CLI：内置最新版 Prisma 2 CLI，支持 prisma init、prisma migrate、prisma generate 等全部命令。
多数据库支持：兼容 PostgreSQL、MySQL、SQLite、SQL Server 等主流数据库。
轻量级基础：基于 Alpine Linux，镜像体积小（约 80MB），启动速度快。
环境隔离：提供独立的 Prisma 运行环境，避免本地依赖冲突。

2.2 关键特性

多阶段构建支持：可作为构建阶段生成 Prisma 客户端，产物用于生产环境。
灵活配置：通过环境变量或挂载文件自定义 schema 路径、数据库连接等。
跨平台兼容：支持 Linux/amd64、Linux/arm64 等架构。

三、使用场景与适用范围

3.1 开发环境

快速初始化 Prisma 项目，无需本地安装 Node.js 或 Prisma CLI。
在隔离环境中调试 schema 定义、迁移脚本。

3.2 CI/CD 流程

集成到 CI 管道，自动执行数据库迁移（prisma migrate deploy）。
生成 Prisma 客户端并打包到应用镜像中。

3.3 生产环境辅助

作为临时容器执行生产环境数据库迁移。
生成优化后的 Prisma 客户端（prisma generate --no-engine），供应用引用。

四、使用方法

4.1 镜像拉取

bash
docker pull prismagraphql/prisma2:latest  # 拉取最新版
# 或指定版本（推荐生产环境使用固定版本）
docker pull prismagraphql/prisma2:2.30.3

4.2 基本命令示例

4.2.1 查看 Prisma 版本

bash
docker run --rm prismagraphql/prisma2:latest prisma --version

4.2.2 初始化 Prisma 项目

挂载本地目录到容器内，在当前目录生成 Prisma 基础文件：

bash
docker run --rm -v $(pwd):/app prismagraphql/prisma2:latest prisma init

执行后，本地目录将生成 prisma/schema.prisma 和 .env 文件。

4.2.3 执行数据库迁移

需传递数据库连接信息（DATABASE_URL），并挂载项目目录：

bash
docker run --rm \
  -v $(pwd):/app \
  -e DATABASE_URL="postgresql://user:password@host:port/dbname?schema=public" \
  prismagraphql/prisma2:latest \
  prisma migrate dev --name init

4.3 挂载项目文件

通过 -v 参数将本地 Prisma 项目目录挂载到容器的 /app 目录（默认工作目录），确保容器内可访问 schema.prisma 和 .env 文件：

bash
docker run --rm -v /path/to/your/project:/app prismagraphql/prisma2:latest [command]

五、配置参数

5.1 环境变量

变量名	描述	默认值	必要性
`DATABASE_URL`	数据库连接 URL（如 `postgresql://...`）	无	必需
`PRISMA_SCHEMA_PATH`	Prisma schema 文件路径	`/app/prisma/schema.prisma`	可选
`PRISMA_GENERATE_OUTPUT`	客户端生成目录路径	`/app/node_modules/@prisma/client`	可选
`NODE_ENV`	运行环境（`development`/`production`）	`development`	可选

六、部署示例

6.1 Docker Run 示例

示例 1：生成 Prisma 客户端

bash
docker run --rm \
  -v $(pwd):/app \
  -e DATABASE_URL="mysql://user:pass@mysql:3306/mydb" \
  prismagraphql/prisma2:latest \
  prisma generate

示例 2：生产环境数据库迁移

bash
docker run --rm \
  -e DATABASE_URL="postgresql://prod_user:prod_pass@prod-db:5432/prod_db" \
  -v $(pwd)/prisma:/app/prisma \  # 仅挂载 schema 和迁移文件
  prismagraphql/prisma2:latest \
  prisma migrate deploy

6.2 Docker Compose 示例

创建 docker-compose.yml，集成 Prisma 与数据库服务：

yaml
version: '3.8'

services:
  prisma:
    image: prismagraphql/prisma2:2.30.3
    volumes:
      - ./:/app  # 挂载项目目录
    environment:
      - DATABASE_URL=postgresql://postgres:postgres@db:5432/mydb?schema=public
    depends_on:
      - db

  db:
    image: postgres:14
    environment:
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=postgres
      - POSTGRES_DB=mydb
    ports:
      - "5432:5432"
    volumes:
      - postgres_data:/var/lib/postgresql/data

volumes:
  postgres_data:

使用方法：

bash
# 启动数据库和 Prisma 服务
docker-compose up -d

# 进入 Prisma 容器执行命令
docker-compose exec prisma prisma migrate dev --name init

七、注意事项

文件权限：挂载本地目录时，确保宿主目录权限允许容器读写（可通过 chmod 755 /path/to/project 调整）。
生产环境建议：生产环境中，建议通过多阶段构建从镜像中提取生成的 @prisma/client 到应用镜像，避免在生产容器中保留 Prisma CLI。
版本锁定：生产环境务必使用固定版本标签（如 2.30.3），而非 latest，避免版本变更导致兼容性问题。
敏感信息：DATABASE_URL 包含数据库凭证，生产环境中建议通过 Docker Secrets 或环境变量管理工具传递，避免明文暴露。