容器与云原生 / 系统课时
区分开发与生产配置
区分开发与生产配置
本课使用一份公共 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 端口。合并顺序从左到右,后面的文件覆盖前面的同名配置。
按自己的节奏,确认真正理解。