Docker Compose 编排全栈应用的核心是通过 YAML 文件统一管理前端、后端、数据库等服务，围绕可运行、可复现、可协作目标组织配置，明确服务边界与依赖，合理设计网络通信，分离配置与数据，并通过“写→启→查→调”闭环持续验证迭代。
用 Docker Compose 编排全栈 Web 应用，本质是把前端、后端、数据库等服务写进一个 YAML 文件，用统一命令启停和管理。它不追求“一次写完所有细节”，而是围绕可运行、可复现、可协作三个目标组织配置。
明确服务边界与依赖关系
全栈应用通常包含至少三类核心服务：静态资源托管（如 Nginx）、业务逻辑服务（如 Node.js/Python）、数据存储（如 PostgreSQL/MySQL）。每个服务在 docker-compose.yml 中定义为独立的 service，并通过 depends_on 显式声明启动顺序。
- 前端服务一般不构建镜像，直接挂载 HTML/JS 文件到 Nginx 容器内
- 后端服务推荐使用 build 指向本地 Dockerfile，便于调试和定制运行时环境
- 数据库服务需配置 environment（如密码、数据库名）和 volumes（确保数据持久化）
- 避免仅靠 depends_on 控制就绪状态；对强依赖（如后端连数据库），应在应用代码中加入重试逻辑或使用健康检查
合理设计网络与通信方式
默认情况下，Compose 会为项目创建一个桥接网络，所有服务自动加入该网络，并可通过服务名互相访问。这意味着后端代码里连接数据库只需写 db:5432，而不是 localhost:5432。
- 不需要手动定义 network，除非有跨项目通信或自定义子网需求
- 对外暴露端口（如 ports: ["8080:80"]）只作用于宿主机，容器间通信走内部网络名，无需开放端口
- 若需反向代理（如用 Nginx 统一入口），建议单独起一个 nginx 服务，通过 upstream 指向 backend 服务名
分离配置与数据，提升可维护性
把环境变量、初始化脚本、静态资源等从 YAML 文件中抽离出来，既保持配置简洁，又方便不同环境复用。
- 用 .env 文件管理敏感或易变参数（如 POSTGRES_PASSWORD、NODE_ENV），YAML 中引用为 ${DB_PASSWORD}
- 数据库初始化 SQL 放在 ./db/init.sql，通过 volume 挂载到容器初始化路径（如 /docker-entrypoint-initdb.d/）
- 前端构建产物输出到 ./dist，Nginx 直接挂载该目录，避免每次 rebuild 前端镜像
- 日志、上传文件等动态数据必须挂载 volumes，否则容器重启即丢失
验证与迭代部署流程
编排不是一锤定音，而是一个“写→启→查→调”的闭环。每次修改后都应快速验证关键链路是否通畅。
- 执行 docker-compose up -d 启动全部服务，再用 docker-compose ps 查看状态
- 用 docker-compose logs -f backend 实时跟踪后端日志，确认是否成功连接 db
- 在浏览器访问宿主机端口（如 http://localhost:8080），观察前端加载和 API 调用是否正常
- 修改代码后，可单独重建某服务：docker-compose up -d --build backend
