文档中心

容器服务

请输入

VCI Agent Sandbox

镜像归档

本文主要介绍 VCI Agent Sandbox 中的镜像归档（Commit）能力，及其使用方法。

功能介绍

VCI Agent Sandbox 对容器根文件系统（container rootfs）提供镜像 Commit 能力，支持在镜像 Commit 成功后将其推送到镜像仓库，适用于定期归档运行时所产生的数据。

使用说明

VCI 不会自动清理推送到镜像仓库中的历史镜像，请务必关注您镜像仓库的容量水位。

OCI 镜像规范限制单个镜像最多拥有 128 个层 (Layers)，多次镜像 Commit 后，可能会触发该限制，导致 Commit 失败。建议仅在关键节点进行镜像归档，或定期通过重新构建镜像来合并层。

使用方法

进行镜像 Commit 前需准备镜像仓库，并获取该仓库的用户名和密码。您可以使用火山引擎镜像仓库（CR）产品作为您的镜像仓库，详情请参见 CR 快速入门。

将镜像仓库的用户名和密码配置到 Secret 对象中。详细操作，请参见创建保密字典。

通过 ContainerImageCommit CRD 自动创建镜像 Commit 并制作镜像缓存。

apiVersion: extensions.agents.x-k8s.io/v1alpha1
kind: ContainerImageCommit
metadata:
namespace: default
name: test-commit
spec:
target:
sandboxRef:
apiVersion: agents.x-k8s.io/v1alpha1
kind: Sandbox
namespace: default
name: test-sandbox-example
containerName: test-server # 要归档镜像的容器名。
image: # 镜像 Commit 时使用的参数。
name: sandbox-0202:v0.1.1 # 镜像的地址和 tag。
author: bob
changes: # 当前只支持 ENTRYPOINT 和 CMD。
- "ENTRYPOINT ["nginx"]" # 容器启动时执行的可执行文件。
- "CMD ["-g", "daemon off;"]" # 容器启动时传递给 ENTRYPOINT 的默认参数。
message: "generate commit v0.1.1"
imageCacheConfig:
enable: true # 镜像上传之后，自动制作镜像缓存。
subnetIds: # 制作镜像缓存使用的子网 ID，可以设置集群里的 Pod 子网。
- subnet-xxx
- subnet-yyy
securityGroupIds: # 制作镜像缓存使用的安全组，可以设置集群的 Pod 安全组。
- sg-xxx
retentionDays: 10 # 非必填，镜像缓存的保留时长。单位为：天。
imageCacheSize: 50 # 非必填，镜像缓存的大小。单位为：GiB。
authConfig: # 推送镜像时的鉴权信息。
secretRef:
name: test-registry-auth # 已配置镜像仓库用户名和密码的 Secret 名称。
namespace: default # 存放 Secret 的命名空间。如果不填，默认跟随 ContainerImageCommit 的命名空间。
skipTlsVerify: true # 是否跳过 TLS 验证。取值：true（跳过）/false（不跳过）。
plainHttp: true # 是否使用 HTTP 协议。取值：true（使用）/false（不使用）。
pause: false # 打包镜像时，是否暂停容器。取值：true（暂停容器）/false（不暂停容器）。
timeout: "60m" # 非必填，ContainerImageCommit 的超时时间，超时后状态不再更新。格式为：数字+单位，例如“60m”表示 60 分钟；“120s”表示 120 秒。
retentionDays: 15 # 非必填，Commit Custom Resource 的保留时长。不影响已生成的镜像和镜像缓存。单位为：天。

等待 CRD 的status.phase显示为 Completed 时，镜像打包并推送完成。示例代码如下。

status:
phase: Completed # 镜像打包并推送完成。
taskId: fake-id
tryCount: 1

最近更新时间：2026.03.25 11:24:34

这个页面对您有帮助吗？

有用

无用