文档中心

容器服务

请输入

网络

指定子网创建实例

弹性容器实例支持使用默认子网创建，也支持指定子网创建。本文主要介绍通过指定子网，创建弹性容器实例的步骤。

背景信息

未指定子网时，使用的默认子网为：创建集群时指定的 Pod 子网。

使用限制

子网所属可用区必须已有虚拟节点（Virtual Node）。

实例创建成功后不允许更改子网。

前提条件

已创建 VCI 业务相关集群。详细操作，请参见在 VPC-CNI 网络模型集群中使用 VCI、在 Flannel 网络模型集群中使用 VCI。

已创建私有网络及其子网。详细操作，请参见创建私有网络。

Kubernetes 方式创建

创建 Pod 或者工作负载（包括 Deployment、StatefulSet、Job、CronJob）时，通过添加 Annotation，指定子网。

Annotation 说明，如下所示。

Annotation Key	Annotation Value 示例值	说明	是否必填
vke.volcengine.com/preferred-subnet-ids	subnet-3tispp1nai****	设置实例子网。说明支持指定多个可用区的多个子网。多子网之间使用半角逗号（,）隔开。指定多个子网时，系统从多个子网中选择一个剩余 IP 数量最多的子网创建 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​
      labels:​
        app: nginx​
    spec:​
      containers:​
      - name: nginx​
        image: doc-cn-beijing.cr.volces.com/vke/nginx-demo:v1.0 # 容器镜像的地址和版本，请配置为您自己的镜像地址。​
        ports:​
        - containerPort: 80​

控制台方式

与 Kubernetes 方式创建相同，在创建工作负载时添加注解（Annotation），指定子网。

下图以无状态负载（Deployment）为例，其他工作负载的创建方法与之相似。详细的创建工作负载方法，请参见工作负载。

说明

弹性容器实例不支持守护进程（Daemonset）。更多信息，请参见使用限制。

查询实例所属子网

通过 Pod Annotation，获取 VCI 实例所属子网 ID。

Annotation Key	Annotation Value 示例值	说明
vke.volcengine.com/used-subnet-id	subnet-128fhnvjjgg****	实例所属子网 ID。

最近更新时间：2026.08.19 11:23:42

这个页面对您有帮助吗？

有用

无用