You need to enable JavaScript to run this app.
导航

配置 IPv4/IPv6 双栈网络

最近更新时间2023.08.08 20:59:44

首次发布时间2023.08.08 20:59:44

弹性容器实例同时支持 IPv4 和 IPv6 双栈网络能力,相比 IPv4,IPv6 大大扩展了地址的可用空间。本文主要介绍如何为 VCI 实例配置 IPv4/IPv6 双栈网络。

VCI Pod 主网卡和辅助网卡均支持 IPv4 和 IPv6 双栈网络。补齐 IPv6 支持的能力,满足 Pod 在双栈模式下运行的需求。

说明

邀测·申请试用】:该功能目前处于邀测阶段,如需使用,请提交申请。

前提条件

  • 已创建 IPv4/IPv6 双栈集群。详细操作,请参见 通过 VKE 搭建 IPv4/IPv6 双栈集群

    说明

    IPv4/IPv6 双栈网络能力,目前在 VKE 和 VCI 均处于邀测阶段,如需使用,提交申请。

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

配置说明

通过添加 Pod Annotation 方式,为弹性容器实例配置 IPv4/IPv6 双栈网络。

Annotation 说明,如下所示。

Annotation KeyAnnotation Value 示例值说明是否必填

vci.vke.volcengine.com/pod-ip-family

ipv4

VCI Pod 主网卡使用的协议栈。取值如下:

  • ipv4:(默认)使用 IPv4 单栈网络。
  • dualstack:使用 IPv4/IPv6 双栈网络。

本场景必填

vke.volcengine.com/preferred-network-interface对象类型VCI Pod 辅助网卡配置。数组类型,数组中每个对象均代表一张辅助网卡的配置信息。详情如本文下方 辅助网卡配置信息表 所示。非必填

辅助网卡配置信息表

Key示例值说明是否必填
Type"Secondary"弹性网卡类型,辅助网卡时必须为"Secondary"必填

SubnetIds

["subnet-os74b******"]

子网 ID。

  • 子网必须属于当前 VCI Pod 主网卡所在的 VPC。
  • 辅助网卡与主网卡的子网可以相同,也可以不同,VPC 的 CIDR 允许重叠。

必填

SecurityGroupIds

["sg-123edf******"]

弹性网卡加入的安全组列表。

  • 指定的安全组必须与弹性网卡在同一个 VPC 内。
  • 安全组数量 >= 1。

必填

SecondaryPrivateIpAddressCount

1

辅助网卡的辅助私网 IP 数量,取值范围:1~2。
辅助网卡至少有 1 个主私网 IP,可以有 0 至多个辅助私网 IP。

注意

  • 辅助网卡仅使用主私网 IP 时,请不要填写该参数。
  • 辅助网卡所能够绑定的弹性公网 IP 总数量为:SecondaryPrivateIpAddressCount + 1

非必填

Ipv6AddressCount

1

VCI Pod 辅助网卡的 IPv6 地址数量,取值范围:1~2。
传入该参数后,系统自动从网卡所属子网中分配相应数量的空闲 IP 地址作为网卡的辅助私网 IP 地址。

非必填

配置示例

本文以指定子网创建 VCI 实例时,同时配置 IPv4/IPv6 双栈网络为例。创建 VCI 实例的详细操作,请参见 指定容器 vCPU 和内存创建实例指定 VCI 规格创建实例指定子网创建实例

Kubernetes 方式

以创建无状态负载(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/pod-ip-family: dualstack #主网卡使用的协议栈
        vke.volcengine.com/preferred-network-interface:  #辅助网卡配置信息
            '[{
               "Type":"Secondary",  #网卡类型,必须填写 "Secondary",代表辅助网卡
               "SubnetIds":["subnet-os74b94e***"],  #辅助网卡的子网 ID
               "SecurityGroupIds":["sg-123edfgt8***"],  #辅助网卡所在的安全组 ID
               "SecondaryPrivateIpAddressCount": 1, #辅助网卡的辅助私网 IP 数量
               "Ipv6AddressCount": 1 #辅助网卡的 IPv6 地址数量
              }]'
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: cr-cn-beijing.volces.com/tw/nginx:1.0 # 容器镜像的地址和版本,请配置为您自己的镜像地址。
        ports:
        - containerPort: 80

控制台方式

在 VPC-CNI 集群中创建工作负载时,配置 实例注解。下图以无状态负载(Deployment)为例,其他工作负载的创建方法与之相似。详细的创建工作负载方法,请参见 工作负载

说明

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

alt