Docker Compose 入门:用一个 YAML 文件拉起 Python + Redis 开发环境

举报
yd_291309839 发表于 2026/11/11 23:32:07 2026/11/11
【摘要】 做后端小项目时,经常要同时跑好几样东西:一个 Python Web 服务、一个 Redis 做缓存或计数,有时还要加个数据库。如果每次都手动 docker run 一长串参数,不光容易敲错,换台电脑还得重新回忆一遍。Docker Compose 就是为这种场景准备的:把多个容器的配置写进一个 compose.yaml,一条命令全部启动、全部停止。本文用一个“访问计数器”的小例子,带你走一遍完...

做后端小项目时,经常要同时跑好几样东西:一个 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,容器删了数据也还在。

三、启动、查看与停止

在项目目录执行:

docker compose up -d --build

-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,计数并不会归零,这就是具名卷的作用。

四、开发时的小技巧

  1. 代码热更新:在 web 下增加 volumes: - .:/app,并把启动命令加上 --debug,改完代码保存就能生效,不用每次重建镜像。
  2. 环境变量文件:把配置写进同目录的 .env 文件,Compose 会自动读取,在 YAML 中用 ${变量名} 引用,避免把密码等敏感信息写死在文件里,.env 记得加入 .gitignore。
  3. 只重启一个服务:docker compose restart web,不会影响 Redis。
  4. 新版 Docker 已内置 docker compose(中间是空格)子命令,老教程里的 docker-compose 是独立安装的旧版工具,两者语法基本兼容。

五、小结

Docker Compose 的价值在于“把环境写成代码”:一个 compose.yaml 就描述了项目需要哪些服务、怎么连接、数据放在哪里。新同事拿到仓库,装好 Docker 后一条 docker compose up 就能跑起来,再也不用对着文档一步步装 Redis。建议从本文这个两服务的小例子开始,熟悉之后再逐步加入数据库、Nginx 反向代理和健康检查,你会发现本地开发环境变得干净又可复现。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。