容器服务支持为 Pod 配置固定 IP，解决基于 Pod IP 的访问控制、服务注册、服务发现、日志审计等需求。本文为您介绍如何为 Pod 配置固定 IP。

背景信息

容器服务支持在创建 VPC-CNI 网络模型的集群时开启 Trunk ENI 模式，开启后可以在 Trunk ENI 节点中为 Pod 配置独占弹性网卡，并指定 Pod 的子网和安全组。

当 Pod 配置独占网卡时，支持为 Pod 配置固定 IP。方便用户针对具体的 Pod IP 配置访问控制、服务注册、服务发现、日志审计等。配置固定 IP 涉及的 CRD 资源对象和作用如下：

• VPCENIDefinition 对象：该对象用来定义 ENI 的 VPC IPAM 配置信息。包括 VPC ID、IP 分配模式、安全组、子网 ID 等。
• PodNetworkDefinition 对象：该对象用来定义 Pod 的网络配置，包含所使用的 IPAM 信息，Pod 选择信息等。

使用限制

• Trunk ENI 特性仅支持在 VPC-CNI 容器网络模型的集群中使用。
• Trunk ENI 特性仅支持在创建集群时进行配置，集群创建后不支持修改。
• 目前只支持 StatefulSet 类型或无 ownerReferences 的 Pod 配置固定 IP，暂不支持 Deployment、DaemonSet 等其他类型的工作负载配置 Pod 固定 IP。

前提条件

• 集群已安装 vpc-cni 组件，并升级至 v1.6.0 及以上版本。
• 集群已安装 vpc-cni-controlplane 组件，并升级至 v1.3.3 及以上版本。

操作步骤

步骤一：创建集群并配置 Trunk ENI

1. 登录 容器服务控制台。
2. 在集群管理页面的左侧导航栏，选择 集群。
3. 在集群列表页面，单击左上角 创建集群，跳转到集群创建页面的 集群配置 步骤，完成后单击 下一步：节点池配置。

集群配置步骤的关键配置项如下，其他参数按需配置即可。

4. 在 节点池配置 步骤，按需配置即可，完成后单击 下一步：组件配置。
5. 在组件配置步骤，将默认安装 vpc-cni-controlplane 组件，其他组件按需配置即可，完成后单击 下一步：确认配置。

6. 确认新建集群信息和计费准确无误后，阅读 《容器服务专用服务条款》 并勾选同意，单击 确定 ，开始创建集群。

步骤二：开启 Pod 固定 IP 功能

1. 集群创建完成后，单击目标集群名称，进入集群管理页面。
2. 在左侧导航栏选择 组件管理。
3. 选择 网络 页签，找到 vpc-cni-controlplane 组件，单击 配置，并开启 Pod 固定 IP 功能。

4. 单击 确定，完成配置。

步骤三：创建 VPCENIDefinition 对象

1. 在左侧导航栏选择 工作负载 > 对象浏览器。
2. 在对象浏览器管理页面，单击 使用 Yaml 创建，创建 VPCENIDefinition 对象。
   • 在 类型 下拉菜单中选择 自定义。
   • 在 Yaml 配置框内输入 Yaml 配置。

apiVersion: network.volcengine.com/v1beta1
kind: VPCENIDefinition
metadata:
  name: vpceni-default # 自定义 VPCENIDefinition 对象名称
  namespace: default
spec:
  vpcID: vpc-rr1s2d*** # 必选，集群所属私有网络（VPC）的 ID
  allocateType:
    releaseAfter: 3m0s # 必选，Pod 删除后，IP 的延迟回收时间，取值为 0 表示“立即回收”。仅在 releaseStrategy 为 TTL 时有效
    releaseStrategy: TTL # 必选，IP 回收策略，取值为 TTL（延迟回收）和 Never（永不回收）。当配置为 Never 时，releaseAfter 的配置无效
    type: Fixed # 必选，IP 分配模式，Fixed 表示固定分配模式
  securityGroupIDs: 
  - sg-rrhowl*** # 必选，Pod 默认安全组
  subnetIDs:
  - subnet-13f64*** # 必选，指定 VPC 中的子网 ID
  - subnet-13fy9***

spec字段中的详细参数说明如下所示。

步骤四：创建 PodNetworkDefinition 对象

1. 在左侧导航栏选择 工作负载 > 对象浏览器。
2. 在对象浏览器管理页面，单击 使用 Yaml 创建，创建 PodNetworkDefinition 对象。
   • 在 类型 下拉菜单中选择 自定义。
   • 在 Yaml 配置框内输入 Yaml 配置。

apiVersion: network.volcengine.com/v1beta1
kind: PodNetworkDefinition
metadata:
  name: vpceni1
  namespace: default
spec:
  ipResource:
    name: vpceni-default # 必选，自定义的 VPCENIDefinition 对象名称，与上一步中配置的一致
    type: VPCENIDefinition  # 必选，指定网络资源类型，固定值
  selectors:
  - podSelector:
      matchLabels:
        foo: bar # 可选，PodNetworkDefinition 对象中定义的 Pod 标签，用于匹配指定的 Pod，独占弹性网卡并配置固定 IP
    namespaceSelector:
      matchLabels:
        foo: bar # 可选，PodNetworkDefinition 对象中定义的 Namespace 标签，用于匹配指定的 Namespace，为 Namespace 中的全部 Pod 提供独占弹性网卡并配置固定 IP

spec字段中的详细参数说明如下所示。

步骤五：配置 Pod 独占弹性网卡

系统支持以下方式配置 Pod 独占弹性网卡，包括：

• 命名空间标签：通过匹配 Namespace 的标签，为 Namespace 中的全部 Pod 提供独占网卡能力。
• Pod 标签：通过匹配 Pod 的标签，为指定 Pod 提供独占网卡能力。

方式一：配置命名空间标签

您可以在创建命名空间时，添加 PodNetworkDefinition 对象中定义的标签（例如：foo: bar），为 Namespace 中的全部 Pod 提供独占网卡能力。示例如下：

apiVersion: v1
kind: Namespace
metadata:
  name: namespace-demo # 命名空间的名称
  labels:
    foo: bar  # 添加 PodNetworkDefinition 对象中定义的标签

方式二：创建 Pod 并添加标签

您可以在创建 Pod 时，添加 PodNetworkDefinition 对象中定义的标签（例如：foo: bar），为该 Pod 提供独占网卡能力。示例如下：

apiVersion: v1
kind: Pod
metadata:
  name: pod-demo # Pod 名称
  namespace: default # Pod 所在命名空间
  labels:
    foo: bar  # 添加 PodNetworkDefinition 对象中定义的标签
spec:
  containers:
    - name: hello-pod 
      image: nginx:latest
      ports:
        - containerPort: 80

方式三：创建工作负载并添加标签

您可以在创建工作负载时，添加 PodNetworkDefinition 对象中定义的标签（例如：foo: bar），为该 Pod 提供独占网卡能力。示例如下：

apiVersion: apps/v1
kind: StatefulSet
metadata:
  name: statefulset-demo # 工作负载的名称
  namespace: default # 工作负载所在的命名空间
spec:
  replicas: 1 
  selector:
    matchLabels:
      foo: bar
  template:
    metadata:
      labels:
        foo: bar
    spec:
      containers:
      - name: nginx 
        image: nginx:latest
        ports:
        - containerPort: 80 

结果验证

配置完成后，匹配 PodNetworkDefinition 对象 Label 的 Pod 被系统自动补全 Pod Annotation（包括：ENI request/limit），Pod 将被调度到支持 Trunk 的节点上，并为 Pod 配置独占弹性网卡。

如下图所示，系统自动补全k8s.volcengine.com/eni-ip-status等 Annotation，表示 Pod 已经配置独占弹性网卡。

在 Pod 详情页面，选择 网卡 页签，可以查看独占网卡的相关信息。