多容器Docker应用打包与部署指南

Docker 不支持也不推荐将多个运行中的容器“合并”为单个镜像；正确做法是分别构建、推送各服务镜像，并通过 docker-compose.yml 统一编排部署。本文详解标准化构建、镜像管理与生产分发的最佳实践。

Docker 不支持也不推荐将多个运行中的容器“合并”为单个镜像；正确做法是分别构建、推送各服务镜像，并通过 `docker-compose.yml` 统一编排部署。本文详解标准化构建、镜像管理与生产分发的最佳实践。

在 Docker 生态中，不存在“merge containers”这一操作——容器是运行时实例，镜像是不可变的构建产物，而微服务架构天然鼓励职责分离。你当前使用 docker-compose.yml 协调 Nginx 与 PHP-FPM 容器，这本身就是最佳实践；目标不应是“合并容器”，而是实现可复现、可分发、无本地依赖的镜像化部署流程。

✅ 正确路径：分离构建 + 统一编排

你需要两个独立但协同的镜像：

• nginx 镜像：仅含静态文件、配置和 Nginx 运行时；
• php-fpm 镜像：仅含应用代码、PHP 运行时及扩展。

二者通过 Docker 网络通信（如默认 bridge 或自定义网络），不共享文件系统、不耦合进程、不混杂职责。

1. 重构 Dockerfile：按角色拆分（推荐）

避免单 Dockerfile 多 FROM 目标带来的混淆，为每个服务创建专用文件：

# Dockerfile.nginx
FROM nginx:1.21.6-alpine
COPY ./src/ /var/www/html/
COPY ./nginx/conf.d/app.conf /etc/nginx/conf.d/default.conf
EXPOSE 80

# Dockerfile.php
FROM php:7.4-fpm-alpine
RUN docker-php-ext-install pdo_mysql opcache
COPY ./src/app/ /var/www/html/app/
EXPOSE 9000

⚠️ 注意：COPY 必须将代码打入镜像——删除 volumes 挂载后，镜像才真正自包含。开发时可用 override 文件临时挂载，但生产镜像必须“开箱即用”。

2. 分层 docker-compose.yml：兼顾开发与生产

主文件 docker-compose.yml（用于生产/分发）
✅ 仅声明 image、端口暴露策略、网络连接，不含任何 build 或 volume：

version: '3.8'
services:
  nginx:
    image: registry.example.com/myapp/nginx:${TAG:-latest}
    ports: ["80:80"]
    depends_on: [php]
  php:
    image: registry.example.com/myapp/php:${TAG:-latest}
    # 不暴露 9000 端口给外部 —— 仅限内部通信

覆盖文件 docker-compose.override.yml（仅本地开发使用）
⚠️ 此文件不提交至仓库或分发，用于快速迭代：

version: '3.8'
services:
  nginx:
    build:
      context: .
      dockerfile: Dockerfile.nginx
    volumes:
      - ./src/:/var/www/html/
  php:
    build:
      context: .
      dockerfile: Dockerfile.php
    ports: ["9000:9000"]  # 便于本地调试

Compose 自动合并两者：docker-compose build 会基于 override 中的 build 构建并打上 registry.example.com/... 标签；docker-compose up 则按主文件拉取远程镜像。

3. 构建、推送与部署全流程

# 1. 设置语义化标签（推荐 Git SHA 或日期）
export TAG=20260417

# 2. 构建并推送双镜像（自动使用 override 中的 build 配置）
docker-compose build
docker-compose push

# 3. 在目标服务器上仅需此命令（无需源码、Dockerfile、override）
scp docker-compose.yml user@prod-server:/opt/myapp/
ssh user@prod-server "cd /opt/myapp && export TAG=20260417 && docker-compose up -d"

此时 Docker 将自动从私有 Registry 拉取 nginx:${TAG} 和 php:${TAG} 镜像，并启动完全隔离、无外部依赖的服务栈。

? 关键原则总结

• ❌ 禁止尝试用 docker commit 导出运行中容器为“合并镜像”——破坏可重现性、引入未知状态、违反不可变镜像原则；
• ✅ 必须确保镜像内含全部运行时依赖（PHP 扩展、Nginx 配置、应用代码）；
• ✅ 推荐使用 docker-compose push（需 Compose v2.20+）或脚本循环 docker push 实现批量推送；
• ✅ 生产环境禁用 container_name 和自定义 networks（除非有跨栈通信需求），默认网络更轻量、更安全；
• ✅ 使用 .env 文件管理 TAG、REGISTRY 等变量，提升可移植性。

遵循此模式，你的应用即可实现：
? 开发时热重载（via override）
? 测试时环境一致（镜像即环境）
? 生产时一键部署（仅需 compose 文件 + tag）
? 团队协作零歧义（镜像来源清晰、构建逻辑分离）

这才是 Docker 原生、可持续、符合云原生演进方向的交付范式。