容器服务
容器服务
容器服务
文档指南
请输入
容器服务 VKE
产品动态
Kubernetes 版本发布记录
组件发布记录
监控组件
DNS 组件
GPU 组件
Sandbox 组件
安全公告
产品公告
历史公告
用户指南
集群
节点池
授权
网络
容器网络
服务（Service）
路由（Ingress）
APIG Ingress
ALB Ingress
自定义转发规则配置示例
CLB Ingress
Nginx Ingress
Gateway API
工作负载
存储
数据管理中心（DMC）
对象存储（TOS）
FSX 访问方式
文件存储（NAS）
FSX 访问方式
弹性文件存储（EFS）
文件存储（vePFS）
FSX 访问方式
vePFS Client 访问方式
NFS 访问方式
大数据文件存储（CloudFS）
弹性伸缩
工作负载弹性伸缩
事件驱动伸缩（KEDA）
组件管理
网络组件
监控组件
DNS 组件
GPU 组件
Sandbox 组件
异构计算
调度管理
可观测性
基础观测
诊断与巡检
最佳实践
网络
可观测性
安全合规
API 参考
集群管理
节点池管理
组件管理
机型镜像管理
云原生观测
巡检诊断
弹性容器实例
附录
开发指南
常见问题
通用 FAQ
集群 FAQ
集群管理
集群升级
节点与节点池 FAQ
授权 FAQ
工作负载 FAQ
服务与路由 FAQ
存储 FAQ
弹性伸缩 FAQ
可观测性 FAQ
配额 FAQ
组件 FAQ
容器镜像 FAQ
AI 云原生
推理套件
Helm 模板 AI 应用
Deepseek 实践
Qwen 实践
最佳实践
MiniMax 模型部署
Qwen 模型部署
弹性容器实例 VCI
最新动态
用户指南
虚拟节点
VKE 集群使用虚拟节点
自建/跨云集群使用虚拟节点
创建 VCI 实例
VCI Agent Sandbox
安全合规
- 文档首页
容器服务弹性容器实例 VCI用户指南创建 VCI 实例创建实例时拉取自建镜像仓库的镜像
复制全文
下载 pdf创建实例时拉取自建镜像仓库的镜像
文档反馈
问问助手弹性容器实例（VCI）在拉取镜像时，支持从自建镜像仓库中拉取镜像。拉取自建镜像仓库中的镜像时，可能会碰到因协议不同或者证书认证失败而导致镜像拉取失败的问题。本文介绍在自建镜像仓库采用 HTTP 协议和使用自签发证书的情况下，如何拉取自建镜像仓库中的镜像来创建 VCI 实例或者镜像缓存。
功能说明
VCI 在如下场景中支持自建镜像仓库：
- 创建实例时拉取镜像（包括使用镜像缓存）。
- 制作镜像缓存。
Annotation Key | Annotation Value 示例值 | 说明 | 是否必填 |
Annotation Key | Annotation Value 示例值 | 说明 | 是否必填 |
vci.volcengine.com/insecure-registries | "registry1,registry:5000,registry:80" | 使用自签发证书的情况下，拉取镜像时无法通过证书认证，导致镜像拉取失败。可以通过跳过 TLS 认证来解决。 多个镜像仓库通过半角逗号（,）分隔。如果镜像仓库地址有端口号，则需要带上端口号。 | 否 |
vci.volcengine.com/plain-http-registries | "registry1-http,registry-http:5000,registry-http:80" | 指定通过 HTTP 访问的镜像仓库，多个镜像仓库通过半角逗号（,）分隔。如果镜像仓库地址有端口号，则需要带上端口号。 | 否 |
使用限制
- 该方法仅支持以 YAML 方式使用，暂不支持控制台方式使用。
- 在镜像缓存中，仅支持自动创建和手动创建镜像缓存的场景，不支持 CRD 方式创建镜像缓存。镜像缓存相关说明，请参见 VCI 镜像缓存。
使用方法
apiVersion: apps/v1
kind: Deployment
metadata:
name: nginx-deployment
spec:
replicas: 2
selector:
matchLabels:
app: nginx
template:
metadata:
annotations:
vke.volcengine.com/burst-to-vci: enforce # 强制使用 VCI。
vke.volcengine.com/preferred-subnet-ids: subnet-3tispp1nai**** # 指定子网 ID，可指定同一个可用区内多个子网，多个子网之间用半角逗号（,）分隔。
vci.vke.volcengine.com/preferred-instance-family: vci.u1 #指定 VCI 的规格族。
"vci.volcengine.com/insecure-registries": "registry1,registry:5000,registry:80" #指定跳过 TLS 认证的镜像仓库，多个镜像仓库通过","隔开。
"vci.volcengine.com/plain-http-registries": "registry1-http,registry-http:5000,registry-http:80" # 指定通过 HTTP 访问的镜像仓库，多个镜像仓库通过","隔开。
labels:
app: nginx
spec:
containers:
- name: nginx
image：doc-cn-beijing.cr.volces.com/vke/nginx-demo:v1.0 # 您的自建镜像仓库地址。若使用公网镜像，请确保您的集群能够访问公网。
ports:
- containerPort: 80
resources:
requests: # 指定容器的 vCPU 和内存。
cpu: "500m"
memory: "1024Mi"
limits:
cpu: "1"
memory: "2048Mi"
最近更新时间：2026.08.19 11:23:29
这个页面对您有帮助吗？
有用
有用
无用
无用