Kubernetes 镜像卷（Image Volume）使用指南

原创于 2025-06-10 09:03:35 发布 · 359 阅读

CC 4.0 BY-SA版权

Kubernetes 镜像卷（Image Volume）使用指南

概述

在 Kubernetes 中，镜像卷（Image Volume）是一项强大的特性，它允许你将 OCI 镜像仓库中的内容直接挂载到容器内部。这项功能从 Kubernetes v1.31 版本开始引入，需要通过特性门控（Feature Gate）启用。

核心概念

镜像卷本质上是一种特殊的卷类型，它能够：

从容器镜像中提取特定内容
将这些内容作为卷挂载到 Pod 的容器中
保持与原始镜像相同的文件权限和目录结构

使用场景

镜像卷特别适用于以下场景：

需要将配置文件从镜像中分离出来单独管理
希望在多个容器间共享只读的静态内容
需要从基础镜像中提取特定工具或库文件

准备工作

在使用镜像卷前，请确保：

集群版本不低于 v1.31
容器运行时支持镜像卷特性
已启用 ImageVolume 特性门控
具备在主机和 Pod 中执行命令的权限

基础用法示例

下面是一个使用镜像卷的基本 Pod 配置示例：

apiVersion: v1
kind: Pod
metadata:
  name: image-volume-pod
spec:
  containers:
  - name: container
    image: nginx
    command: ["bash"]
    args: ["-c", "sleep 1d"]
    volumeMounts:
    - name: image-volume
      mountPath: /volume
  volumes:
  - name: image-volume
    image: busybox:1.36

在这个示例中：

我们创建了一个名为 image-volume-pod 的 Pod
使用 busybox:1.36 镜像作为卷来源
将该卷挂载到容器的 /volume 路径

操作步骤

部署 Pod 到集群：
```
kubectl apply -f image-volumes.yaml
```

进入容器交互模式：

kubectl exec -it image-volume-pod -- bash

验证卷内容：
```
ls /volume
```
这将显示 busybox 镜像中的文件结构

高级用法：subPath

从 Kubernetes v1.33 开始，镜像卷支持 subPath 和 subPathExpr，允许你只挂载镜像中的特定子目录而非整个镜像内容。

示例配置：

apiVersion: v1
kind: Pod
metadata:
  name: image-volume-subpath
spec:
  containers:
  - name: container
    image: nginx
    command: ["bash"]
    args: ["-c", "sleep 1d"]
    volumeMounts:
    - name: image-volume
      mountPath: /volume/file
      subPath: dir/file
  volumes:
  - name: image-volume
    image: busybox:1.36

在这个高级示例中：