FROM ubuntu:22.04

# 创建一个挂载点
VOLUME /data

# 创建多个挂载点
VOLUME ["/var/log", "/var/data", "/etc/config"]

flowchart TD
    A[数据持久化方式] --> B["VOLUME /data\n（Dockerfile 声明）"]
    A --> C["docker run -v mydata:/data\n（命名卷，运行时指定）"]
    A --> D["docker run -v /host/path:/data\n（绑定挂载，运行时指定）"]

    B --> E["匿名卷\n由 Docker 生成随机哈希名"]
    C --> F["命名卷\n用户指定卷名，方便管理"]
    D --> G["绑定挂载\n挂载宿主机任意目录"]

    E --> H["docker volume ls\n显示为乱码哈希"]
    F --> I["docker volume ls\n显示为 mydata"]
    G --> J["不通过 volume 管理\n直接 mount"]

FROM mysql:8.0
# MySQL 镜像中已经声明了：
VOLUME /var/lib/mysql

# 不指定任何卷，Docker 自动创建匿名卷
docker run -d --name mysql1 mysql:8.0

# 查看自动创建的卷
docker volume ls
# DRIVER    VOLUME NAME
# local     0a1b2c3d4e5f...  ← 随机哈希名

# 删除容器后匿名卷默认不会被删除
docker rm mysql1
docker volume ls  # 匿名卷还在

FROM python:3.11-slim
WORKDIR /app
COPY . .
VOLUME /app/data  # 声明数据目录
CMD ["python", "app.py"]

# 方式1：让 Docker 自动创建匿名卷
docker run -d myapp
docker volume ls | grep myapp  # 看到匿名卷

# 方式2：映射到命名卷（覆盖匿名卷）
docker volume create myapp_data
docker run -d -v myapp_data:/app/data myapp

# 方式3：绑定挂载到宿主机目录
docker run -d -v /home/user/data:/app/data myapp

# 查看容器的大小
docker run -d --name test ubuntu:22.04 sleep 3600

# 在 VOLUME 目录中写入大量数据
docker exec test dd if=/dev/zero of=/data/bigfile bs=1M count=100

# 查看容器可写层大小——几乎不变！
docker ps -s --filter name=test
# SIZE 显示的是可写层大小，/data 的数据不在里面

# 创建第一个容器
docker run -d --name db1 -v dbdata:/var/lib/mysql mysql:8.0

# 第二个容器共享同一个卷
docker run -d --name db2 --volumes-from db1 mysql:8.0
# db2 和 db1 共用 /var/lib/mysql 数据

# ❌ 先 VOLUME 后 COPY —— COPY 的数据会丢失！
FROM ubuntu:22.04
VOLUME /app
COPY myapp /app/  # 这些数据将丢失，因为 VOLUME 先执行

# ✅ 先 COPY 后 VOLUME —— 数据保留
FROM ubuntu:22.04
COPY myapp /app/
VOLUME /app  # 此时 /app 已有数据，用户可挂载覆盖

sequenceDiagram
    participant DF as Dockerfile
    participant Build as 构建过程
    participant Run as 运行时

    DF->>Build: VOLUME /app
    Build->>Build: 标记 /app 为挂载点
    DF->>Build: COPY myapp /app/
    Build->>Build: 数据写入镜像层

    Note over Build: ❌ 运行时若挂载卷，COPY 数据被覆盖

    alt 正确顺序
        DF->>Build: COPY myapp /app/
        DF->>Build: VOLUME /app
        Note over Build: ✅ 数据在镜像层，挂载可选
    end

# 旧式 -v 语法
docker run -v myvolume:/app/data myapp

# 新式 --mount 语法（推荐）
docker run --mount source=myvolume,target=/app/data myapp

# 绑定挂载
docker run --mount type=bind,source=/host/data,target=/app/data myapp

# tmpfs（内存挂载）
docker run --mount type=tmpfs,target=/app/cache myapp

# 列出所有卷
docker volume ls

# 查看卷详情
docker volume inspect myvolume

# 创建卷
docker volume create myvolume

# 删除卷（必须没有容器使用）
docker volume rm myvolume

# 清理未使用的卷
docker volume prune

# 查看容器挂载的卷
docker inspect container_name | grep -A 10 Mounts