Docker Compose 入门:用一个 YAML 文件拉起 Python + Redis 开发环境
做后端小项目时,经常要同时跑好几样东西:一个 Python Web 服务、一个 Redis 做缓存或计数,有时还要加个数据库。如果每次都手动 docker run 一长串参数,不光容易敲错,换台电脑还得重新回忆一遍。Docker Compose 就是为这种场景准备的:把多个容器的配置写进一个 compose.yaml,一条命令全部启动、全部停止。本文用一个“访问计数器”的小例子,带你走一遍完整流程。
一、准备项目文件
新建目录 counter-demo,里面放三个文件。
第一个是 app.py,用 Flask 写一个最简单的接口,每访问一次就让 Redis 里的计数加一:
from flask import Flask
import redis, os
app = Flask(__name__)
r = redis.Redis(host=os.getenv("REDIS_HOST", "redis"), port=6379)
@app.route("/")
def index():
n = r.incr("hits")
return f"这个页面已被访问 {n} 次\n"
注意 host 写的是 redis,而不是 localhost。这是 Compose 的关键点:同一个 Compose 项目里的服务会加入同一个网络,服务名就是可解析的主机名。
第二个是 requirements.txt:
flask==3.0.3
redis==5.0.8
第三个是 Dockerfile:
FROM python:3.12-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY . .
CMD ["flask", "--app", "app", "run", "--host=0.0.0.0", "--port=5000"]
先复制 requirements.txt 再安装依赖、最后才复制代码,是为了利用镜像层缓存:只改代码时不必重新 pip install。
二、编写 compose.yaml
services:
web:
build: .
ports:
- "5000:5000"
environment:
- REDIS_HOST=redis
depends_on:
- redis
redis:
image: redis:7-alpine
volumes:
- redis-data:/data
volumes:
redis-data:
逐项解释一下:
services下面每个键就是一个服务。web用当前目录的 Dockerfile 构建,redis直接用官方镜像。ports把容器的 5000 端口映射到宿主机,方便浏览器访问;Redis 只给内部用,所以不映射端口,更安全。depends_on让 Compose 先启动 redis 再启动 web。要注意它只保证“启动顺序”,不保证 Redis 已经可以接受连接,生产环境可以配合healthcheck使用。volumes声明了一个具名卷redis-data,容器删了数据也还在。
三、启动、查看与停止
在项目目录执行:
-d 表示后台运行,--build 表示有改动就重新构建镜像。然后访问 curl http://localhost:5000,多执行几次,可以看到数字在递增。
几个日常最常用的命令:
docker compose ps # 查看各服务状态
docker compose logs -f web # 跟踪 web 服务的日志
docker compose exec redis redis-cli get hits # 进入 redis 容器查看计数
docker compose down # 停止并删除容器和网络(卷保留)
docker compose down -v # 连同数据卷一起删除,慎用
试一下 docker compose down 再 up -d,计数并不会归零,这就是具名卷的作用。
四、开发时的小技巧
- 代码热更新:在
web下增加volumes: - .:/app,并把启动命令加上--debug,改完代码保存就能生效,不用每次重建镜像。 - 环境变量文件:把配置写进同目录的
.env文件,Compose 会自动读取,在 YAML 中用${变量名}引用,避免把密码等敏感信息写死在文件里,.env记得加入.gitignore。 - 只重启一个服务:
docker compose restart web,不会影响 Redis。 - 新版 Docker 已内置
docker compose(中间是空格)子命令,老教程里的docker-compose是独立安装的旧版工具,两者语法基本兼容。
五、小结
Docker Compose 的价值在于“把环境写成代码”:一个 compose.yaml 就描述了项目需要哪些服务、怎么连接、数据放在哪里。新同事拿到仓库,装好 Docker 后一条 docker compose up 就能跑起来,再也不用对着文档一步步装 Redis。建议从本文这个两服务的小例子开始,熟悉之后再逐步加入数据库、Nginx 反向代理和健康检查,你会发现本地开发环境变得干净又可复现。
- 点赞
- 收藏
- 关注作者
评论(0)