写点东西《使用 Docker 构建本地开发环境：运行带有 PostgreSQL 和 Minio S3 的 Next.js 全栈应用程序》

本文介绍: 作为从事全栈应用程序开发的开发人员，您需要拥有一个尽可能接近生产环境的本地开发环境。这将允许您在将应用程序部署到生产环境之前在本地测试和调试应用程序。几乎每个全栈应用程序都需要一个数据库和一个文件存储，因此，让我们构建一个基本的全栈应用程序，该应用程序可以保存和检索数据库中的数据，以及上传和下载文件存储中的文件。您可以在本地运行自己的 PostgreSQL 和 Minio S3 服务器，甚至可以使用 AWS RDS 和 S3 等云服务。但这需要一些时间来设置和配置。

作为从事全栈应用程序开发的开发人员，您需要拥有一个尽可能接近生产环境的本地开发环境。这将允许您在将应用程序部署到生产环境之前在本地测试和调试应用程序。

几乎每个全栈应用程序都需要一个数据库和一个文件存储，因此，让我们构建一个基本的全栈应用程序，该应用程序可以保存和检索数据库中的数据，以及上传和下载文件存储中的文件。

您可以在本地运行自己的 PostgreSQL 和 Minio S3 服务器，甚至可以使用 AWS RDS 和 S3 等云服务。但这需要一些时间来设置和配置。使用 docker-compose 可以非常轻松地为您的全栈应用程序设置本地开发环境。在本地对其进行测试后，您需要切换到生产环境所做的全部工作就是更改环境变量。

此外，您可以在尽可能接近生产环境的本地环境中端到端测试您的应用程序（例如，使用 Cypress）。预先配置的 docker-compose 文件将使设置 GitHub Actions 或 GitLab CI 等 CI/CD 管道变得容易。

一旦你拥有一个 docker-compose 文件，你和你团队就可以使用它在任何机器上用一个命令在几分钟内设置相同的本地开发环境。总体而言，它将为你节省大量时间，让你的生活更轻松。

在本文中，我们将研究如何使用 Docker-Compose 为一个完整的 Next.js 应用程序构建一个本地开发环境，该应用程序使用 Prisma ORM 连接到 PostgreSQL 作为数据库，并使用 Minio S3 作为文件存储。

npm create t3-app@latest

   ___ ___ ___   __ _____ ___   _____ ____    __   ___ ___
  / __| _  __| /  _   _| __| |_   _|__ /   /   | _  _ 
 | (__|   / _| / / | | | _|    | |  |_   / / |  _/  _/
  ___|_|____|_/‾‾__| |___|   |_| |___/ /_/‾‾__| |_|

◇  What will your project be called?
│  local-nextjs-postgres-s3
│
◇  Will you be using TypeScript or JavaScript?
│  TypeScript
│
◇  Will you be using Tailwind CSS for styling?
│  Yes
│
◇  Would you like to use tRPC?
│  No
│
◇  What authentication provider would you like to use?
│  None
│
◇  What database ORM would you like to use?
│  Prisma
│
◇   EXPERIMENTAL  Would you like to use Next.js App Router?
│  No
│
◇  Should we initialize a Git repository and stage the changes?
│  Yes
│
◇  Should we run 'npm install' for you?
│  Yes
│
◇  What import alias would you like to use?
│  ~/

为了减小图像大小，我们需要在 next.config.js 文件中添加 output: "standalone" 。

const config = {
  reactStrictMode: true,
  output: "standalone",
  // ...
};

我更喜欢为 docker 文件单独创建一个文件夹，因此我在项目的根目录中创建了一个名为 compose 的文件夹。我们需要向此文件夹中添加一个 .dockerignore 文件，以从 Docker 镜像中排除不必要的文件。 .dockerignore 文件应如下所示：

.env
Dockerfile
.dockerignore
.next
.git
.gitignore
node_modules
npm-debug.log
README.md

在 prisma/schema.prisma 文件中，我们需要

我想在具有不同操作系统和架构的机器上用于本地开发以及在 GitHub Actions 上用于 CI/CD 管道的 schema.prisma 文件相同。因此，在我的情况下， prisma/schema.prisma 文件如下所示：

generator client {
    provider      = "prisma-client-js"
    binaryTargets = ["native", "linux-musl-arm64-openssl-3.0.x", "linux-musl-openssl-3.0.x", "rhel-openssl-1.0.x"]
}

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

在 compose 文件夹中，创建一个名为 web.Dockerfile 的文件，内容如下：

FROM node:18-alpine

RUN mkdir app
COPY ../prisma  ./app
COPY ../package.json ../package-lock.json ./app
WORKDIR /app

RUN npm ci

CMD ["npm", "run", "dev"]

我们将使用 node:18-alpine 镜像作为基础镜像。这是一个轻量级镜像，包含 Node.js 18 和 npm。我们将复制 /prisma 文件夹、 package.json 和 package-lock.json 文件到 /app 文件夹，并运行 npm ci 来安装依赖项。

在 Docker 镜像中使用“clean install”（ npm ci ）而不是“install”（ npm i ）是一种好习惯。它将确保依赖项是从 package-lock.json 文件中安装的，而不是从 node_modules 缓存中安装的。这比“install”更快，这对于希望尽可能缩短构建时间的 CI/CD 管道尤为重要。

Docker compose 文件用于使用单个命令定义和运行多容器 Docker 应用程序 docker-compose up 。

如果您不想将机密存储在 docker-compose 文件中，则应使用 .env 文件并使用 ${VARIABLE_NAME} 语法来引用变量。有关 docker-compose 文件中的环境变量的更多信息，请参阅 Docker compose 文件参考。

在 compose 文件夹中，创建一个名为 docker-compose.yml 的文件，内容如下：

version: "3.9"
name: nextjs-postgres-s3minio
services:
  web:
    container_name: nextjs
    build:
      context: ../
      dockerfile: compose/web.Dockerfile
      args:
        NEXT_PUBLIC_CLIENTVAR: "clientvar"
    ports:
      - 3000:3000
    volumes:
      - ../:/app
    environment:
      - DATABASE_URL=postgresql://postgres:postgres@db:5432/myapp-db?schema=public
      - S3_ENDPOINT=minio
      - S3_PORT=9000
      - S3_ACCESS_KEY=minio
      - S3_SECRET_KEY=miniosecret
      - S3_BUCKET_NAME=s3bucket
    depends_on:
      - db
      - minio
  db:
    image: postgres:15.3
    container_name: postgres
    ports:
      - 5432:5432
    environment:
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: postgres
      POSTGRES_DB: myapp-db
    volumes:
      - postgres-data:/var/lib/postgresql/data
    restart: unless-stopped
  minio:
    container_name: s3minio
    image: bitnami/minio:latest
    ports:
      - "9000:9000"
      - "9001:9001"
    volumes:
      - minio_storage:/data
volumes:
  postgres-data:
  minio_storage:

# If you have docker files in the root of the project
docker-compose up

# In our case, we have dockerfile and docker-compose file in the compose folder, so we need to run:
docker-compose -f compose/docker-compose.yml up

# --- Optional ---
# For running the application with secrets ${VARIABLE_NAME} stored in the .env file, we would need to run:
docker-compose -f compose/docker-compose.yml --env-file .env up

# If you want to run the application in the background, you can use the -d flag:
docker-compose -f compose/docker-compose.yml up -d