容器与云原生 / 系统课时

Compose 怎样声明一个 Volume

Compose 怎样声明一个 Volume

需要让数据库文件、上传内容或其他状态在容器重建后继续存在时,可以使用 Compose 命名 Volume。正确配置包含两个动作:先在顶层声明 Volume,再在具体服务中把它挂载到容器真正写数据的目录。

学习目标

  • 正确区分顶层 volumes 声明与服务级 Volume 挂载
  • 使用命名 Volume 保存容器重建后仍需保留的数据
  • 验证 docker compose down 后数据是否仍然存在

声明和挂载是两件事

顶层 volumes 用来声明 Compose 项目需要管理的命名 Volume;服务自身的 volumes 则决定哪个容器能够使用它,以及它在容器内挂载到哪个路径。只写顶层声明并不会自动把 Volume 挂入所有服务。([Docker Documentation][2])

最基本的关系可以写成 db-data:/data:冒号左侧的 db-data 是命名 Volume,右侧的 /data 是容器内部路径。

创建一个可验证的命名 Volume

下面使用一个轻量容器演示持久化机制。生产环境中的数据库配置方式相同,只需把 /data 换成数据库实际的数据目录。

yaml
services:
  store:
    image: alpine:3.22
    command: ["sh", "-c", "while true; do sleep 3600; done"]
    volumes:
      - db-data:/data

volumes:
  db-data:

db-data: 后面没有额外属性是合法写法,表示让容器运行时按默认配置创建并管理这个命名 Volume。服务中的 db-data:/data 才真正建立 Volume 与容器目录之间的挂载关系。

验证容器删除后数据仍存在

启动服务,在 Volume 中创建文件,然后执行普通的 docker compose down 删除容器,再重新启动:

bash
docker compose up -d >/dev/null
docker compose exec store sh -c 'echo persisted > /data/demo.txt'
docker compose down >/dev/null
docker compose up -d >/dev/null
docker compose exec store cat /data/demo.txt

预期输出:

text
persisted

这里重新创建的是容器,而 /data/demo.txt 仍由命名 Volume 保存。Docker Compose 的普通 down 默认不会删除在 Compose 文件中声明的命名 Volume,因此下一次 up 可以再次挂载原有数据。([Docker Documentation][3])

理解 Volume 的生命周期

命名 Volume 的生命周期与单个容器不同。容器可以被删除和重新创建,而 Volume 继续存在,这正是它适合数据库、队列持久化目录和应用上传文件的原因。

需要特别区分普通的 docker compose down 与 docker compose down -v。后者会删除 Compose 声明的命名 Volume,因此其中保存的数据也会被清除。重置本地开发数据库时这很方便,但生产或含重要数据的环境不能把它当成普通停机命令使用。([Docker Documentation][3])

如果多个服务需要访问同一个命名 Volume,每个服务都必须在自己的 volumes 中显式挂载它。顶层声明负责定义资源,服务级声明负责授予并确定挂载位置;把这两个层次分清后,数据库等有状态服务的 Compose 持久化配置就会非常直接。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

Compose 怎样声明一个 Volume

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通