⚡部署的通行证：Docker 容器化基础

大家好，我是大布布将军。

当你写完一个功能完备的 Node.js 服务后，你可能会遇到一个经典问题： "在我的电脑上运行得好好的，为什么到了服务器上就报错了？"

这通常是由于环境不一致导致的：服务器上的 Node.js 版本、操作系统配置、依赖库安装情况都可能与你的开发环境不同。

Docker 就是解决这个问题的核心工具。它引入了容器化 (Containerization) 的概念。

1. 什么是容器化？------隔离与一致性

容器（Container）可以理解为一个轻量级的、独立的虚拟机 。它将你的应用程序及其所有依赖（代码、运行时、系统工具、库等）都打包在一个标准的、可执行的单元中。

隔离性：每个容器都是隔离的。一个容器内的应用崩溃不会影响到其他容器。
一致性 ：只要能运行 Docker，你的 BFF 服务在任何地方（本地、测试环境、生产环境）都将以完全相同的方式运行。

Docker 的核心构成：

Dockerfile： 一个文本文件，包含构建 Docker 镜像 (Image) 的所有指令。它是构建的"菜谱"。
Image (镜像)： 应用程序及其环境的只读模板。你可以用它创建多个容器。
Container (容器)： 镜像的一个运行实例。

2. 实践项目：为 Node.js BFF 编写 Dockerfile

Dockerfile 是容器化的起点。对于 Node.js 应用，我们需要精心设计 Dockerfile 的步骤，以确保镜像体积小、构建速度快。

步骤一：多阶段构建 (Multi-stage Builds)

为了减小最终镜像的体积，我们使用多阶段构建。

第一阶段 (Builder) ：安装所有依赖（包括开发依赖）。
第二阶段 (Runner) ：只保留运行应用所需要的代码和生产依赖。

Dockerfile

复制代码

# --------------------- 阶段 1: 构建阶段 (Builder Stage) ---------------------
FROM node:20-alpine AS builder

# 1. 设置工作目录
WORKDIR /app

# 2. 拷贝 package.json 和 package-lock.json，并安装依赖 (利用缓存)
# 这一步是性能优化的关键：如果依赖没变，Docker 会跳过 npm install
COPY package*.json ./
RUN npm install

# 3. 拷贝所有源文件，并进行 TypeScript 编译
COPY . .
RUN npm run build 
# 假设 npm run build 会将 TypeScript 编译到 /dist 目录


# --------------------- 阶段 2: 运行阶段 (Runner Stage) ---------------------
# 生产环境只需要运行时的 Node.js 环境，所以使用更小的 Alpine 基础镜像
FROM node:20-alpine 

WORKDIR /app

# 4. 从构建阶段拷贝编译好的 JS 文件和生产依赖
# 只需要生产依赖 (dependencies)，不需要开发依赖 (devDependencies)
COPY --from=builder /app/node_modules ./node_modules
COPY --from=builder /app/package*.json ./
COPY --from=builder /app/dist ./dist 

# 5. 暴露端口 (例如 NestJS 默认的 3000 端口)
EXPOSE 3000

# 6. 定义启动命令
# 启动编译后的 JavaScript 文件
CMD ["node", "dist/main.js"]

3. Docker Compose：一键启动全栈服务

在实际开发中，你的 Node.js BFF 不会孤立运行，它需要数据库（如 PostgreSQL/MySQL）和缓存（如 Redis）。Docker Compose 允许你用一个配置文件，定义和启动多个相互连接的容器服务。

YAML

复制代码

# 📁 docker-compose.yml
version: '3.8'
services:
  # 1. 我们的 Node.js BFF 服务
  bff-service:
    build: . # 使用当前目录的 Dockerfile
    ports:
      - "3000:3000"
    environment:
      # 环境变量注入，无需硬编码
      DATABASE_HOST: postgres-db 
      REDIS_HOST: redis-cache
    depends_on:
      - postgres-db
      - redis-cache
      
  # 2. PostgreSQL 数据库服务
  postgres-db:
    image: postgres:14-alpine
    restart: always
    environment:
      POSTGRES_USER: user
      POSTGRES_PASSWORD: password
      POSTGRES_DB: bff_database
    # 容器内部的网络名称是 postgres-db

  # 3. Redis 缓存服务
  redis-cache:
    image: redis:alpine
    restart: always
    # 容器内部的网络名称是 redis-cache

有了这个文件，你只需要在命令行运行 docker-compose up -d，就能在本地启动一个完整的、与生产环境高度一致的全栈环境。

4. 总结

Docker 容器化是现代软件工程师的标准技能，它解决了"环境不一致"的问题，并极大地简化了复杂的微服务架构。

通过 Dockerfile 规范化你的构建流程，通过 Docker Compose 实现本地全栈环境的一键启动，你就完成了从"写代码"到"交付代码"的关键转变。

下一篇，我们将把目光投向云端，学习如何将这个 Docker 化的服务，通过 CI/CD 流程自动部署到服务器，实现真正的自动化交付。