容器服务
容器服务
文档指南
请输入
- 文档首页
容器服务弹性容器实例 VCI用户指南创建 VCI 实例创建实例并配置远端代理仓
复制全文
下载 pdf创建实例并配置远端代理仓
文档反馈
问问助手弹性容器实例（VCI）支持镜像仓库 Mirror 配置，镜像拉取时会将请求的地址替换成 Mirror 仓库的地址拉取镜像。
背景信息
在用户业务中，会存在需要拉取境外镜像源、多云场景协作等需求。VCI 基于火山引擎镜像仓库（CR）的远端代理（Proxy cache）能力，提供镜像仓库 Mirror 配置功能，在使用公开的海外镜像场景中，可通过该能力直接拉取对应的镜像，无需更换镜像地址，满足用户的跨地域业务需求。
说明
功能说明
VCI 通过 Annotation 方式提供 Mirror 配置能力。Annotation 说明如下：
- Annotation Key：vci.volcengine.com/registry-mirror-config
- Annotation Value：
- 参数值支持的格式为 JSON。
- JSON 文件格式及参数说明如下：
- {"mirrors": { // 远端代理仓域名配置。"docker.io": ["address1.cr.volces.com", "address2.cr.volces.com"], // 按需配置，表示将 docker.io 远端仓镜像映射到指定的 CR 代理仓。填写多个代理仓域名时按前后顺序从代理仓中拉取镜像。"hub.byted.org": ["address2.cr.volces.com"], // 按需配置，表示将 hub.byted.org 远端仓镜像映射到指定的 CR 代理仓。"*": ["default-address.cr.volces.com"] // 按需配置，表示所有类型镜像，均映射到指定的 CR 代理仓。}，"configs": {"address1.cr.volces.com": { // 为指定的 CR 代理仓，配置访问策略。"auth": {"username": "xxx", // CR 代理仓实例的登录用户名。"password": "yyy" // CR 代理仓实例的登录密码，需要进行 Base64 编码后传入。}，"tls": {"insecure_skip_verify": true // 按需配置，表示登录 CR 代理仓实例时忽略证书校验。}}}}
使用方法
前提条件
- 已创建 VCI 业务相关集群。详细操作，请参见 在 VPC-CNI 网络模型集群中使用 VCI、在 Flannel 网络模型集群中使用 VCI。
- 已创建私有网络及其子网。详细操作，请参见 创建私有网络。
- 已创建远端代理仓。详细操作，请参见 创建远端代理仓。
代码示例
创建 VCI Deployment 的示例代码如下所示：
说明
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/registry-mirror-config: |
{
"mirrors": {
"docker.io": ["address1.cr.volces.com", "address2.cr.volces.com"],
"hub.byted.org": ["address2.cr.volces.com"],
"*": ["default-address.cr.volces.com"]
}，
"configs": {
"address1.cr.volces.com": {
"auth": {
"username": "demo-user",
"password": "*****************"
}，
"tls": {
"insecure_skip_verify": true
}
}
}
}
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 17:32:20
这个页面对您有帮助吗？
有用
有用
无用
无用