为 Pod 绑定独立 EIP

容器服务支持为 Pod 提供独立的公网出/入口，能够满足单个或少量 Pod 公网互通的场景，而且有效解决 Pod 间公网带宽争抢的问题。本文为您介绍如何为 Pod 绑定公网 IP。

前提条件

• 已创建 VPC-CNI 网络模型的集群，详情请参见 创建集群。
• 已通过 kubectl 连接目标集群。详情请参见 连接集群。
• 为 Pod 绑定已有 EIP 前，需要首先完成创建 EIP 实例。详情请参见 申请公网 IP。

使用限制

• 该特性仅支持在 VPC-CNI 容器网络模型场景下使用。
• EIP 特性开启后不支持关闭；vpc-cni-controlplane 组件安装后，暂不允许卸载。
• 确保账户余额不低于 100 元（含代金券，且除去代金券后余额不为零），能够正常创建 EIP 资源。
• 单个火山引擎账号、单个地域下，默认最多可申请的 EIP 数量为 20 个。若默认配额无法满足需求，请前往 配额中心 ，申请提升配额。
• 单个火山引擎账号、单个地域下，每天最多可以创建请求的数量为可申请 EIP 数量的 2 倍。
• 单个火山引擎账号、单个地域下，每天最多可以绑定请求的数量为可申请 EIP 数量的 3 倍。

步骤一：安装组件

1. 登录 容器服务控制台。
2. 在左侧导航栏中选择 集群，单击目标集群。
3. 在集群管理页面的左侧导航栏中，选择 组件管理。
4. 选择 网络 页签，将鼠标移动到 vpc-cni-controlplane 组件上，单击右上角的 ... > 安装。
   
5. 在弹出的配置框内开启 Pod 绑定公网 IP 功能。
   

   说明

   若存量集群已经安装 vpc-cni-controlplane 组件，请确保组件已经升级到 v1.3.0 及以上版本。详情请参见 升级组件。

6. 单击 确定，完成组件安装。

步骤二：为 Pod 绑定独立 EIP

容器服务通过实例注解（Annotation）方式为 Pod 配置 EIP。支持绑定已有 EIP，也支持创建新的 EIP 并绑定到 Pod 网卡。

绑定已有 EIP

配置工作负载时为 Pod 绑定已有 EIP

以无状态负载为例，您可以在配置时添加 Annotation，为 Pod 绑定独立 EIP。示例和说明如下：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: deployment-eip-demo # 工作负载的名称
  namespace: default # 工作负载所在的命名空间
spec:
  replicas: 1 
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      annotations:
        vke.volcengine.com/primary-eip-id: "eip-rr67***"  # Pod 绑定的已有 EIP 实例 ID
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx 
        image: nginx:latest
        ports:
        - containerPort: 80 

Annotation 说明如下表所示。

配置 Pod 时绑定已有 EIP

您可以在配置 Pod 时添加 Annotation，为 Pod 绑定独立 EIP。示例和说明如下：

apiVersion: v1
kind: Pod
metadata:
  name: pod-eip-demo # Pod 名称
  namespace: default # Pod 所在命名空间
  annotations: 
    vke.volcengine.com/primary-eip-id: "eip-rr67***"  # Pod 绑定的已有 EIP 实例 ID
spec:
  containers:
    - name: hello-pod 
      image: nginx:latest
      ports:
        - containerPort: 8080 # adjust port for your container

新建 EIP 并绑定

配置工作负载时创建 EIP 并与 Pod 绑定

以无状态负载为例，您可以在配置时添加 Annotation，创建新的 EIP 并与 Pod 绑定。示例和说明如下：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: deployment-eip-demo # 工作负载的名称
  namespace: default # 工作负载所在的命名空间
spec:
  replicas: 1 
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      annotations: 
        vke.volcengine.com/primary-eip-allocate: '{"type": "Elastic"}' # EIP 申请策略，固定值
        vke.volcengine.com/primary-eip-attributes: '{
          "name": "eip-demo",
          "description": "demo for pods eip",
          "isp": "BGP",
          "billingType": 2,
          "projectName": "default",
          "bandwidthPackageId": "bwp-2d63yyj3ki4u858oz***"
        }'
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx 
        image: nginx:latest
        ports:
        - containerPort: 80 

Annotation 说明如下表所示。

primary-eip-attributes中的参数说明如下表所示。

配置 Pod 时创建 EIP 并与 Pod 绑定

您可以在配置 Pod 时添加 Annotation，为 Pod 绑定独立 EIP。示例和说明如下：

apiVersion: v1
kind: Pod
metadata:
  name: pod-eip-demo # Pod 名称
  namespace: default # Pod 所在命名空间
  annotations: 
    vke.volcengine.com/primary-eip-allocate: '{"type": "Elastic"}' # EIP 申请策略，固定值
    vke.volcengine.com/primary-eip-attributes: '{
      "name": "eip-demo",
      "description": "demo for pods eip",
      "isp": "BGP",
      "billingType": 2,
      "projectName": "default",
      "bandwidthPackageId": "bwp-2d63yyj3ki4u858oz***"
    }'
spec:
  containers:
    - name: hello-pod 
      image: nginx:latest
      ports:
        - containerPort: 8080 # adjust port for your container

步骤三：（可选）控制 Pod Ready 状态

由于 Pod 创建和 EIP 绑定是一个异步的过程，控制器会在 Pod IP 分配后，为 Pod 配置 EIP 地址。因此，Pod 的 Ready 状态可能早于 EIP 绑定成功时间。您可以在 Pod 配置 init container，监控 Pod 的 Ready 状态，检查 EIP 是否已经绑定成功，配置参考如下：

apiVersion: v1
kind: Pod
metadata:
  name: pod-eip-demo
  annotations:
    vke.volcengine.com/primary-eip-id: "eip-rr67***"
  ...
spec:
  initContainers:
  - command:
    - timeout
    - "60"
    - sh
    - -c
    - until grep -E '[0-9]+' /etc/eipinfo/allocated-eips; do echo waiting for
      allocated-eips; sleep 1; done   
    image: busybox:latest
    imagePullPolicy: Always
    name: init
    volumeMounts:
    - mountPath: /etc/eipinfo
      name: eipinfo
  volumes:    
   - name: eipinfo      
     downwardAPI:        
      items:          
       - path: "allocated-eips"            
         fieldRef:              
          fieldPath: metadata.annotations['vke.volcengine.com/allocated-eips']
...

结果验证

检查 Pod 状态

Pod 为Running状态后，您可以检查 Pod 和与 EIP 的绑定状态。绑定完成后，系统将为 Pod 打上vke.volcengine.com/allocated-eips等 annotation，可以以此来验证 Pod 的 Ready 状态。如下图所示。

vke.volcengine.com/allocated-eips字段中的参数说明如下所示。

查看 EIP 信息

登录 公网 IP 控制台，在 公网访问 > 公网 IP 列表中，可以查看到与 Pod 绑定的 EIP 实例。

通过 EIP 访问 Pod

通过公网访问 Pod 中部署的应用（例如：Nginx），若可以正常访问，则表示 Pod 配置的独立 EIP 可以正常工作。

参考信息

清理 VKE 创建的 EIP 实例

如果您自行更改了 VKE 创建的 EIP 实例规格，则 Pod 被删除时，VKE 不会自动同步删除 EIP 实例，从而导致 EIP 资源残留。此时，您可以使用 EIP 中的特定标签，在 EIP 控制台中查找并手工清理 VKE 创建的 EIP 实例。标签说明如下表所示：

VKE 创建的 EIP 实例信息示例，如下所示：