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 镜像拉取

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

4.2 基本命令示例

4.2.1 查看 Prisma 版本

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

4.2.2 初始化 Prisma 项目

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

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

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

4.2.3 执行数据库迁移

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

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 文件：

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

五、配置参数

5.1 环境变量

六、部署示例

6.1 Docker Run 示例

示例 1：生成 Prisma 客户端

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

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

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 与数据库服务：

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:

使用方法：

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

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

七、注意事项

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