容器与云原生 / 系统课时

区分开发与生产配置

区分开发与生产配置

本课使用一份公共 Compose 配置加两份环境覆盖文件,分别满足本地开发和生产部署。完成后,你可以在不复制整套服务定义的前提下,切换端口、源码挂载、调试命令、镜像版本和重启策略。

学习目标

  • 提取开发与生产环境的公共配置
  • 使用多份 Compose 文件覆盖差异项
  • 在启动前检查最终合并结果

识别环境差异

公共部分包括服务关系、内部网络、数据库卷和环境变量名称;差异部分才放进覆盖文件。

配置项 开发环境 生产环境
后端代码 绑定挂载,启用调试 固定镜像,不挂载源码
对外端口 前端、后端、数据库可按需开放 通常只开放前端
镜像版本 本地构建 使用明确版本标签
重启策略 手工控制 unless-stopped
密码 本地测试值 外部密钥注入

不要维护两份完全独立的 Compose 文件,否则公共配置很容易随迭代产生偏差。

编写公共配置

创建 compose.yaml:

yaml
services:
  db:
    image: mysql:8.4
    environment:
      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}
      MYSQL_DATABASE: ${MYSQL_DATABASE}
      MYSQL_USER: ${MYSQL_USER}
      MYSQL_PASSWORD: ${MYSQL_PASSWORD}
    volumes:
      - db-data:/var/lib/mysql
      - ./db/init.sql:/docker-entrypoint-initdb.d/001-init.sql:ro
    healthcheck:
      test:
        - CMD-SHELL
        - mysqladmin ping -h 127.0.0.1 -uroot -p$$MYSQL_ROOT_PASSWORD --silent
      interval: 5s
      timeout: 3s
      retries: 20
    networks:
      - app-net

  backend:
    image: demo-backend:${APP_VERSION:-latest}
    environment:
      DB_HOST: db
      DB_PORT: 3306
      DB_NAME: ${MYSQL_DATABASE}
      DB_USER: ${MYSQL_USER}
      DB_PASSWORD: ${MYSQL_PASSWORD}
    depends_on:
      db:
        condition: service_healthy
    networks:
      - app-net

  frontend:
    image: demo-frontend:${APP_VERSION:-latest}
    depends_on:
      backend:
        condition: service_started
    networks:
      - app-net

volumes:
  db-data:

networks:
  app-net:
    driver: bridge

公共文件保留稳定结构,环境差异通过后续文件合并。${APP_VERSION:-latest} 表示未提供版本时使用 latest,生产环境应显式设置版本。

编写开发覆盖配置

创建 compose.dev.yaml:

yaml
services:
  db:
    ports:
      - "3306:3306"

  backend:
    build:
      context: ./backend
    environment:
      APP_ENV: development
    volumes:
      - ./backend:/app
    command:
      - flask
      - --app
      - app
      - run
      - --host=0.0.0.0
      - --port=8000
      - --debug
    ports:
      - "8000:8000"

  frontend:
    build:
      context: ./frontend
    ports:
      - "8080:80"

源码绑定挂载便于修改后立即生效,后端和数据库端口也便于本地调试。该文件不应在生产环境使用。创建 .env.dev:

text
APP_VERSION=dev
MYSQL_ROOT_PASSWORD=rootpass
MYSQL_DATABASE=demo_app
MYSQL_USER=app
MYSQL_PASSWORD=apppass

编写生产覆盖配置

创建 compose.prod.yaml:

yaml
services:
  db:
    restart: unless-stopped

  backend:
    restart: unless-stopped
    environment:
      APP_ENV: production

  frontend:
    restart: unless-stopped
    ports:
      - "80:80"

创建 .env.prod:

text
APP_VERSION=1.0.0
MYSQL_ROOT_PASSWORD=<ROOT_PASSWORD>
MYSQL_DATABASE=demo_app
MYSQL_USER=app
MYSQL_PASSWORD=<APP_PASSWORD>

<ROOT_PASSWORD> 和 <APP_PASSWORD> 是部署时注入的占位符,不能原样使用,也不要把真实生产密码提交到代码仓库。

检查并启动目标环境

先检查开发环境合并结果中的服务列表:

bash
docker compose \
  --env-file .env.dev \
  -f compose.yaml \
  -f compose.dev.yaml \
  config --services

预期输出:

text
db
backend
frontend

启动开发环境:

bash
docker compose \
  --env-file .env.dev \
  -f compose.yaml \
  -f compose.dev.yaml \
  up -d --build

预期结果:

text
[+] Running
 ✔ Container <PROJECT>-db-1       Healthy
 ✔ Container <PROJECT>-backend-1  Started
 ✔ Container <PROJECT>-frontend-1 Started

<PROJECT> 通常来自当前目录名。生产环境在启动前同样先执行配置检查:

bash
docker compose \
  --env-file .env.prod \
  -f compose.yaml \
  -f compose.prod.yaml \
  config --services

预期输出:

text
db
backend
frontend

确认生产密码已注入、镜像标签存在后,启动生产环境:

bash
docker compose \
  --env-file .env.prod \
  -f compose.yaml \
  -f compose.prod.yaml \
  up -d

预期结果:

text
[+] Running
 ✔ Container <PROJECT>-db-1       Healthy
 ✔ Container <PROJECT>-backend-1  Started
 ✔ Container <PROJECT>-frontend-1 Started

生产环境只发布前端 80 端口。合并顺序从左到右,后面的文件覆盖前面的同名配置。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

区分开发与生产配置

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通