Files
docker_practice/11_compose/11.3_usage.md
T
yeasy ef2625531d style: 含中文的括号统一为全角(336 处 / 110 文件)
全书此前是真·五五开:含中文的括号 336 处半角 : 336 处全角,而且**在同一文件
内混用**——`18_security/18.1_kernel_ns.md` 第 11/17/20 行写 `(如 runC)`,
第 31 行写 `(用户命名空间映射)`。这不是体例问题,是它自己跟自己不一致。

集群里其余 13 本都一边倒(llm_internals 5 : 1049、oc_guide 2 : 713、
forward_deployed_engineering_guide 0 : 108),blockchain_guide 已在 2026-08-05
按同一方向统一过 97 处,故取全角,而非另立新规。全角括号前后不留空格,
原先 `概念 (镜像、容器、仓库) 和` 两侧的空格一并收掉。

**纯拉丁内容的半角括号一个没动**——`新建一个层 (Layer)`、`项目 (project)`
保持原样:改动前后「半角且内容纯拉丁」的数量都是 **1163**,而「半角且含中文」
从 **336 变成 0**。

其余验证:改动前后各自抹掉全部空白与圆括号后**逐字节相同**(两侧均 19559 字符);
左右括号总数改动前后都是 399 : 399,证明没有吞括号也没有配错对。
`check_project_rules` 202/202、`check_emphasis` 202/202、37 tests OK、
根 `format_checker` 与 `validate_codeblocks` 干净、`git diff --check` 干净。
2026-08-24 13:13:23 -07:00

2.2 KiB

11.3 使用

本节将通过一个具体的 Web 应用案例,介绍 Docker Compose 的基本概念和常用操作。

11.3.1 术语

首先介绍几个术语。

  • 服务 (service):一个应用容器,实际上可以运行多个相同镜像的实例。

  • 项目 (project):由一组关联的应用容器组成的一个完整业务单元。

可见,一个项目可以由多个服务(容器)关联而成,Compose 面向项目进行管理。

11.3.2 准备示例

下面创建一个由 web 和 redis 组成的简单示例项目。

应用代码

新建文件夹,在该目录中编写 app.py 文件

from flask import Flask
from redis import Redis

app = Flask(__name__)
redis = Redis(host='redis', port=6379)

@app.route('/')
def hello():
    count = redis.incr('hits')
    return 'Hello World! 该页面已被访问 {} 次。\n'.format(count)

if __name__ == "__main__":
    app.run(host="0.0.0.0", debug=True)

Dockerfile

编写 Dockerfile 文件,内容为

FROM python:3.12-alpine
COPY . /code
WORKDIR /code
RUN pip install redis flask
CMD ["python", "app.py"]

compose.yaml

编写 compose.yaml 文件,这是 Compose 推荐使用的主模板文件(也兼容 docker-compose.yml 等历史文件名)。

services:
  web:
    build: .
    ports:
      - "5000:5000"

  redis:
    image: "redis:alpine"

11.3.3 启动与验证

启动项目

$ docker compose up

此时访问本地 5000 端口,每次刷新页面,计数就会加 1。

按下 Ctrl-C 停止项目。

后台运行与停止

$ docker compose up -d
$ docker compose stop

查看日志

$ docker compose logs -f

进入服务

$ docker compose exec redis sh
/data # redis-cli
127.0.0.1:6379> get hits
"9"

11.3.4 常用命令

构建与重建

$ docker compose build
$ docker compose start

运行一次性命令

$ docker compose run web python app.py

验证与清理

$ docker compose config
$ docker compose down

💡 docker compose down 默认会删除容器和网络,但 保留数据卷。如需同时删除数据卷,请使用 docker compose down -v。