同一Compose项目分开测试与正式环境:检查卷、端口和凭据
项目名称只是隔离的第一步
适用于Linux服务器上已有Docker Engine 28及以上、Compose v2项目,需要同时保留测试和正式两套环境。开始前备份原compose文件与数据,记录正式项目名称,不直接对正在运行的正式栈改名。改项目名可能让Compose创建一套新卷,看起来像数据丢失。
两套环境至少要分开项目名、域名或端口、数据卷、数据库账号与库、外部凭据、计划任务。显式的container_name、外部卷、卷的name字段、相同宿主绑定目录和外部网络,不会因为换了-p就自动隔离。
一、为自己的应用准备独立文件
下面以已构建并能正常启动的myapp镜像为例,应用在容器内监听8000,数据写到/app/data。若应用使用数据库,请事先准备两个独立数据库及账号,分别写入运行环境文件;不能把测试配置仍指向正式数据库。
services:
web:
image: "$BLY_APP_IMAGE"
env_file:
- "$BLY_RUNTIME_FILE"
ports:
- "127.0.0.1:$BLY_WEB_PORT:8000"
volumes:
- app_data:/app/data
volumes:
app_data:
把它保存为独立演示项目的compose.yaml,按自己项目实际要求合并其他服务。这里没有container_name和卷的自定义name,Compose会按项目生成独立资源。已有项目的数据库、队列和缓存也必须逐项检查,不能只替换web部分。
创建.env.test:
BLY_APP_IMAGE=local/myapp:2026-11-15.1
BLY_WEB_PORT=18081
BLY_RUNTIME_FILE=./test.runtime.env
创建.env.prod,使用已通过测试的镜像编号:
BLY_APP_IMAGE=local/myapp:2026-11-15.1
BLY_WEB_PORT=18080
BLY_RUNTIME_FILE=./prod.runtime.env
再分别建立test.runtime.env和prod.runtime.env,填写应用实际读取的变量。Compose插值文件与传入容器的运行环境文件用途不同;--env-file本身不会把所有值自动传给应用。涉及秘密的文件设为600并排除出代码仓库。
二、先检查隔离条件,再启动测试环境
运行up之前,先确认当前Shell未导出同名BLY变量,否则可能覆盖文件值;核对test.runtime.env中的数据库、缓存、对象存储、队列及外部API均属于测试环境。提前关闭真实付款、自动续费、短信、邮件、Webhook和正式调度器,必要时限制出口。不能先启动,再指望进管理界面关闭这些功能。
docker compose -p myapp_test --env-file .env.test -f compose.yaml config -q
docker compose -p myapp_test --env-file .env.test -f compose.yaml config --volumes
docker compose -p myapp_test --env-file .env.test -f compose.yaml up -d
docker compose -p myapp_test --env-file .env.test -f compose.yaml ps
docker volume inspect myapp_test_app_data
curl -sS -D - -o /dev/null http://127.0.0.1:18081/
启动后再检查容器实际Mounts及端口,确保与事先核对的一致,且未挂载正式数据路径。普通config会输出展开后的配置,可能含密码,不把完整输出截图或发给无关人员。有关变量可参考Docker Compose环境变量为什么没生效。
三、验证隔离是否生效
测试环境使用单独账号和脱敏数据,关闭自动续费、真实付款、短信、邮件、Webhook以及会执行正式任务的队列和调度器。项目名隔离不会阻止容器访问网络上的正式服务,因此还需按业务配置测试端点,必要时限制测试网络出口。
使用测试账号做一次新增和删除操作,确认正式库、上传目录和任务队列均未变化。网页入口可通过本机代理或受限测试域名提供访问,不直接开放数据库端口。
四、操作时始终写明目标环境
docker compose -p myapp_test --env-file .env.test -f compose.yaml stop
测试环境停止后,正式环境应继续服务。正式发布前对myapp_prod执行同样的配置检查,但已有生产项目应沿用原项目名、路径和卷映射,不能照抄示例创建空数据环境。清理测试时只处理myapp_test核实过的资源,不加全局prune或对生产执行down -v。
正式数据库账号应只允许访问正式库,测试账号应只访问测试库。验收隔离时也要检查缓存键、对象存储目录和搜索索引名称;这些外部资源若仍共用,测试删除操作仍可能影响正式业务。