如何在 Docker 中使用 Prisma

10 分鐘

本指南將引導您在 Docker 環境中設定 Prisma ORM 應用程式。您將學習如何設定 Node.js 專案、整合 Prisma 以進行資料庫管理，以及使用 Docker Compose 協調應用程式。完成後，您將擁有一個在 Docker 容器中運作的完整 Prisma 應用程式。

先決條件

Docker 和 Docker Compose 已安裝
Node.js 版本：Prisma 6 需要相容的 Node.js 版本。

開始之前，請確保本機沒有 PostgreSQL 服務正在執行，並且以下連接埠處於空閒狀態以避免衝突：5432 (PostgreSQL)、3000 (應用程式伺服器) 或 5555 (Prisma Studio 伺服器)。

若要停止現有的 PostgreSQL 服務，請使用

sudo systemctl stop postgresql  # Linux
brew services stop postgresql   # macOS
net stop postgresql             # Windows (Run as Administrator)

若要停止所有正在運行的 Docker 容器並釋放連接埠

docker ps -q | xargs docker stop

1. 設定您的 Node.js 和 Prisma 應用程式

讓我們從建立一個使用 Prisma ORM 和 Express.js 的簡單 Node.js 應用程式開始。

1.1. 初始化您的專案

首先，建立一個新的專案目錄並初始化一個 Node.js 專案

mkdir docker-test
cd docker-test
npm init -y 

這將產生一個 package.json 檔案

package.json

{
  "name": "docker-test",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {},
  "keywords": [],
  "author": "",
  "license": "ISC"
}

1.2. 安裝必要的依賴項

接下來，安裝 Prisma CLI 作為開發依賴項，並安裝 Express.js 作為伺服器

npm install prisma --save-dev
npm install express

1.3. 設定 Prisma ORM

現在，初始化 Prisma 以產生必要的文件

npx prisma init

這會建立

一個 prisma 資料夾，其中包含 schema.prisma，您將在其中定義您的資料庫 schema。
專案根目錄中的一個 .env 檔案，用於儲存環境變數。

將 User 模型新增至位於 prisma/schema.prisma 資料夾中的 schema.prisma 檔案

prisma/schema.prisma

datasource db {
  provider = "postgresql"
  url      = env("DATABASE_URL")
}

generator client {
  provider = "prisma-client-js"
  output = "../generated/prisma_client"
}

model User {
  id        Int      @id @default(autoincrement())
  createdAt DateTime @default(now())
  email     String   @unique
  name      String?
}

注意

在 schema.prisma 檔案中，我們指定一個自訂 output 路徑，Prisma 將在其中產生其類型。這確保 Prisma 的類型在不同的套件管理器中都能正確解析，並且應用程式可以在容器內一致地存取，而不會有任何權限問題。在本指南中，類型將在 ./generated/prisma_client 目錄中產生。

1.4. 建立 Express.js 伺服器

有了 Prisma schema，讓我們建立一個 Express.js 伺服器來與資料庫互動。首先建立一個 index.js 檔案

touch index.js

新增以下程式碼以設定基本的 Express 伺服器

index.js

const express = require("express");
const { PrismaClient } = require("./generated/prisma_client");

const app = express();
const prisma = new PrismaClient();
app.use(express.json());

// Get all users
app.get("/", async (req, res) => {
  const userCount = await prisma.user.count();
  res.json(
    userCount == 0
      ? "No users have been added yet."
      : "Sonme users have been added to the database."
  );
});

const PORT = 3000;

app.listen(PORT, () => {
  console.log(`Server is running on https://127.0.0.1:${PORT}`);
});

更新 package.json 指令碼，以包含用於執行伺服器和部署遷移的命令

package.json

"scripts": {
  "test": "echo \"Error: no test specified\" && exit 1",
  "dev": "node index.js",
  "db:deploy": "npx prisma migrate deploy && npx prisma generate"
}

現在應用程式已設定完成，讓我們繼續使用 Docker Compose 設定 PostgreSQL 資料庫。

2. 使用 Docker Compose 設定 PostgreSQL 資料庫

為了執行資料庫遷移，我們將使用 Docker Compose 建立一個獨立的 PostgreSQL 資料庫。

2.1. 為 PostgreSQL 建立 Docker Compose 檔案

在根目錄中建立一個 docker-compose.postgres.yml 檔案

docker-compose.postgres.yml

version: '3.7'

services:
  postgres:
    image: postgres:15
    restart: always
    environment:
      - POSTGRES_DB=postgres
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=prisma
    ports:
      - "5432:5432"
    networks:
      - prisma-network
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U prisma -d postgres"]
      interval: 5s
      timeout: 2s
      retries: 20
    volumes:
      - postgres_data:/var/lib/postgresql/data
    command: postgres -c listen_addresses='*'
    logging:
      options:
        max-size: "10m"
        max-file: "3"

networks:
  prisma-network:

volumes:
  postgres_data:

2.2. 啟動 PostgreSQL 容器

執行以下命令以啟動資料庫

docker compose -f docker-compose.postgres.yml up -d

2.3. 執行資料庫遷移

在資料庫運行後，使用以下資料庫連線 URL 更新 .env 檔案

.env

DATABASE_URL="postgresql://postgres:prisma@localhost:5432/postgres?schema=public"

執行遷移以建立資料庫 schema

npx prisma migrate dev --name init

這應該會在 prisma 資料夾中產生一個 migrations 資料夾。

2.4. 測試應用程式

啟動伺服器並驗證其運作

npm run dev

造訪 https://127.0.0.1:3000 以查看訊息

No users have been added yet.

停止本機伺服器。

2.5. 清理獨立資料庫

測試完成後，移除獨立的 PostgreSQL 容器

docker compose -f docker-compose.postgres.yml down --remove-orphans

此命令將會

停止正在運行的容器。
移除容器。
移除 Docker Compose 建立的預設網路。
移除相關聯的磁碟區 (如果未明確命名)。

現在我們已經在本機測試了應用程式，讓我們使用 Docker 將其容器化。

3. 使用 Docker Compose 一起運行應用程式和資料庫

我們現在將使用 Docker 將應用程式容器化，確保它可以在任何環境中運行。

為此，在專案根目錄中建立一個 Dockerfile

touch Dockerfile

在下一步中，您需要為基礎映像選擇兩個選項之一：node:alpine (輕量級) 或 node:slim (穩定)。Prisma ORM 完全支援這兩個選項，但可能需要不同的配置。

3.1. 選項 1：使用 Linux Alpine (`node:alpine`) 作為基礎映像

node:alpine映像基於 Alpine Linux，這是一個使用 musl C 標準函式庫的輕量級 Linux 發行版。如果您想保持容器小巧高效，它是完美的選擇。Prisma 開箱即用地支援 amd64 上的 Alpine，並且自 prisma@4.10.0 起支援 arm64 上的 Alpine。

將以下內容新增至 Dockerfile

Dockerfile

FROM node:lts-alpine3.17

WORKDIR /usr/src/app

COPY package.json package-lock.json ./

RUN npm ci

COPY . .

CMD ["sh", "-c", "npm run db:deploy && npm run dev"]

注意

在 Linux Alpine 上運行時，Prisma 會下載針對 musl C 標準函式庫編譯的引擎。請勿在 Alpine 上安裝 glibc (例如，透過 libc6-compat 套件)，因為這會阻止 Prisma 成功運行。

相關的 Docker 映像

node:lts-alpine
node:16-alpine
node:14-alpine

3.1. 選項 2：使用 Linux Debian (`node:slim`) 作為基礎映像

node:slim 映像基於 Linux Debian，這是一個穩定且廣泛支援的發行版，它使用 glibc C 標準函式庫。它在 amd64 和 arm64 上大多開箱即用，如果您在 Alpine 上遇到相容性問題，或者需要更適合生產環境的環境，它是個不錯的選擇。但是，此映像的一些舊版本可能未安裝 libssl，因此有時需要手動安裝。

將以下內容新增至 Dockerfile

Dockerfile

FROM node:slim

RUN apt-get update -y \
&& apt-get install -y openssl

WORKDIR /usr/src/app

COPY package.json package-lock.json ./

COPY . .

RUN npm ci

CMD ["sh", "-c", "npm run db:deploy && npm run dev"]

相關的 Docker 映像

node:lts-slim
node:bullseye-slim
node:buster-slim
node:stretch-slim

3.2. 建立和配置 Docker Compose 檔案

現在 Dockerfile 已準備就緒，我們將使用 Docker Compose 來一起管理應用程式和資料庫。這使得啟動、停止和管理整個設定變得容易。

在您的專案資料夾中建立一個 docker-compose.yml 檔案

touch docker-compose.yml

將以下配置新增至檔案

docker-compose.yml

version: '3.7'

services:
  postgres_db:
    image: postgres:15
    hostname: postgres_db
    container_name: postgres_db
    restart: always
    environment:
      POSTGRES_DB: postgres
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: prisma
    ports:
      - '5432:5432'
    networks:
      - prisma-network
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U postgres -d postgres"]
      interval: 5s
      timeout: 2s
      retries: 20

  server:
    build: 
      context: .  
      dockerfile: Dockerfile
    ports:
      - '3000:3000'
    stdin_open: true
    tty: true  # Keeps the container running for debugging
    depends_on:
      postgres_db:
        condition: service_healthy
    env_file:
      - .env.prod
    networks:
      - prisma-network
networks:
  prisma-network:
    name: prisma-network

3.3. 為容器配置環境變數

在運行應用程式之前，我們需要配置環境變數。建立一個 .env.prod 檔案

touch .env.prod

將以下資料庫連線 URL 新增至 .env.prod 檔案

.env.prod

DATABASE_URL="postgresql://postgres:prisma@postgres_db:5432/postgres?schema=public"

3.4. 建構並運行應用程式

一切設定完成後，現在是時候使用 Docker Compose 建構並運行應用程式了。執行以下命令

docker compose -f docker-compose.yml up --build -d

造訪 https://127.0.0.1:3000 以查看您的應用程式運行並顯示訊息

No users have been added yet.

3.5. 獎勵：新增 Prisma Studio 以進行資料庫管理

Prisma Studio 提供圖形使用者介面 (GUI)，可讓您直接在瀏覽器中檢視和管理資料庫。它是除錯和管理開發期間資料的絕佳工具。

若要將 Prisma Studio 新增至您的 Docker 設定，請更新 docker-compose.yml 檔案

docker-compose.yml

version: '3.7'

services:
  postgres_db:
    image: postgres:15
    hostname: postgres_db
    container_name: postgres_db
    restart: always
    environment:
      POSTGRES_DB: postgres
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: prisma
    ports:
      - '5432:5432'
    networks:
      - prisma-network
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U postgres -d postgres"]
      interval: 5s
      timeout: 2s
      retries: 20

  server:
    build: 
      context: .  
      dockerfile: Dockerfile
    ports:
      - '3000:3000'
    stdin_open: true
    tty: true  # Keeps the container running for debugging
    depends_on:
      postgres_db:
        condition: service_healthy
    env_file:
      - .env.prod
    networks:
      - prisma-network
  prisma-studio:
    image: node:lts-alpine3.17
    working_dir: /usr/src/app
    volumes:
      - .:/usr/src/app
    command: npx prisma studio --port 5555 --browser none
    ports:
      - "5555:5555"
    env_file:
      - .env.prod
    networks:
      - prisma-network
    depends_on:
      postgres_db:
        condition: service_healthy
      server:
        condition: service_started
networks:
  prisma-network:
    name: prisma-network

這將在 https://127.0.0.1:5555 啟動 Prisma Studio，同時在 https://127.0.0.1:3000 啟動主要應用程式。您可以使用 Prisma Studio 以 GUI 管理您的資料庫。

執行以下命令以啟動所有項目

docker compose -f docker-compose.yml up --build -d

透過遵循本指南，您已成功使用 Docker Compose 將 Prisma 應用程式和資料庫容器化。

先決條件​

1. 設定您的 Node.js 和 Prisma 應用程式​

1.1. 初始化您的專案​

1.2. 安裝必要的依賴項​

1.3. 設定 Prisma ORM​

1.4. 建立 Express.js 伺服器​

2. 使用 Docker Compose 設定 PostgreSQL 資料庫​

2.1. 為 PostgreSQL 建立 Docker Compose 檔案​

2.2. 啟動 PostgreSQL 容器​

2.3. 執行資料庫遷移​

2.4. 測試應用程式​

2.5. 清理獨立資料庫​

3. 使用 Docker Compose 一起運行應用程式和資料庫​

3.1. 選項 1：使用 Linux Alpine (node:alpine) 作為基礎映像​

3.1. 選項 2：使用 Linux Debian (node:slim) 作為基礎映像​

3.2. 建立和配置 Docker Compose 檔案​

3.3. 為容器配置環境變數​

3.4. 建構並運行應用程式​

3.5. 獎勵：新增 Prisma Studio 以進行資料庫管理​