在CCE Turbo集群中为Pod配置固定EIP

使用场景

在云原生网络2.0下，支持为StatefulSet工作负载或直接创建的Pod分配固定的公网IP（EIP）。

约束限制

• 仅以下指定版本的CCE Turbo集群支持用户配置Pod固定EIP：
  • v1.19集群：v1.19.16-r20及以上版本
  • v1.21集群：v1.21.10-r0及以上版本
  • v1.23集群：v1.23.8-r0及以上版本
  • v1.25集群：v1.25.3-r0及以上版本
  • v1.25以上版本集群
• 开启固定EIP功能需要和Pod自动创建EIP功能配合使用，详情请参见在CCE Turbo集群中为Pod配置EIP。
• 目前只支持StatefulSet类型的Pod或直接创建的Pod固定EIP，暂不支持Deployment、DaemonSet等其他类型的工作负载配置Pod固定EIP。
• 固定EIP创建后，生命周期内（如过期时间未到/Pod还在使用中）不支持通过Pod修改EIP属性。
• 对Pod的EIP地址无明确要求的业务不建议配置固定EIP，因为配置了固定EIP的Pod，Pod重建的耗时会略微变长。

配置固定EIP

创建固定EIP的Pod时，填写EIP相关的annotation后，EIP会随Pod自动创建并绑定至该Pod。

以下示例创建一个名为nginx的有状态负载，EIP将随Pod自动创建并绑定至Pod。具体字段含义请参见表1。

• 创建有状态负载时固定独占带宽类型的EIP，无需指定带宽ID，示例如下：

  apiVersion: apps/v1
  kind: StatefulSet
  metadata:
    name: nginx
  spec:
    serviceName: nginx
    replicas: 3
    selector:
      matchLabels:
        app: nginx
    template:
      metadata:
        labels:
          app: nginx
        annotations:
          yangtse.io/static-eip: 'true'   # Pod固定EIP
          yangtse.io/static-eip-expire-no-cascading: 'false'   # EIP级联删除
          yangtse.io/static-eip-expire-duration: 5m   # 固定EIP过期回收的时间间隔
          yangtse.io/pod-with-eip: 'true'    # EIP跟随Pod创建
          yangtse.io/eip-bandwidth-size: '5'    # EIP带宽
          yangtse.io/eip-network-type: 5_bgp    # EIP类型
          yangtse.io/eip-charge-mode: bandwidth    # EIP计费模式
      spec:
        containers:
          - name: container-0
            image: nginx:alpine
            resources:
              limits:
                cpu: 100m
                memory: 200Mi
              requests:
                cpu: 100m
                memory: 200Mi
        imagePullSecrets:
          - name: default-secret

• 创建有状态负载时固定共享带宽类型的EIP，必须指定带宽ID，示例如下：

  apiVersion: apps/v1
  kind: StatefulSet
  metadata:
    name: nginx
  spec:
    serviceName: nginx
    replicas: 3
    selector:
      matchLabels:
        app: nginx
    template:
      metadata:
        labels:
          app: nginx
        annotations:
          yangtse.io/static-eip: 'true'   # Pod固定EIP
          yangtse.io/pod-with-eip: 'true'    # EIP跟随Pod创建
          yangtse.io/eip-network-type: 5_bgp    # EIP类型
          yangtse.io/eip-bandwidth-id: <eip_bandwidth_id>    # EIP共享带宽ID
      spec:
        containers:
          - name: container-0
            image: nginx:alpine
            resources:
              limits:
                cpu: 100m
                memory: 200Mi
              requests:
                cpu: 100m
                memory: 200Mi
        imagePullSecrets:
          - name: default-secret

删除固定EIP

删除Pod后，在配置的固定EIP过期时间内，如果有同名的Pod创建，EIP依旧可用。只有在EIP过期时间内没有同名Pod创建或者删除StatefulSet时开启级联删除EIP时，固定EIP才会删除。