修复maxPod字段

* 同步 crd 到 chart
* 可选字段使用指针，避免apply时发生不预期现象
* 更新文档

Author: imroc

api/v1alpha1/dedicatedclbservice_types.go

@@ -30,7 +30,7 @@ type DedicatedCLBServiceSpec struct {
 	LbRegion string `json:"lbRegion,omitempty"`
 	// CLB 所在 VPC ID，不填则使用 TKE 集群所在的 VPC 的 ID。
 	// +optional
-	VpcId string `json:"vpcId"`
+	VpcId *string `json:"vpcId"`
 	// CLB 端口范围的最小端口号。
 	// +optional
 	// +kubebuilder:default:value=500
@@ -41,7 +41,7 @@ type DedicatedCLBServiceSpec struct {
 	MaxPort int64 `json:"maxPort,omitempty"`
 	// 限制单个 CLB 的 Pod/监听器 的最大数量。
 	// +optional
-	MaxPod int64 `json:"maxPod,omitempty"`
+	MaxPod *int64 `json:"maxPod,omitempty"`
 	// Pod 的标签选择器，被选中的 Pod 会被绑定到 CLB 监听器下。
 	Selector map[string]string `json:"selector"`
 	// Pod 监听的端口。

api/v1alpha1/zz_generated.deepcopy.go

@@ -60,11 +60,17 @@ spec:
               listenerExtensiveParameters:
                 description: 创建监听器的参数，JSON 格式，详细参数请参考 CreateListener 接口：https://cloud.tencent.com/document/api/214/30693
                 type: string
+              maxPod:
+                description: 限制单个 CLB 的 Pod/监听器 的最大数量。
+                format: int64
+                type: integer
               maxPort:
+                default: 50000
                 description: CLB 端口范围的最大端口号。
                 format: int64
                 type: integer
               minPort:
+                default: 500
                 description: CLB 端口范围的最小端口号。
                 format: int64
                 type: integer
@@ -97,8 +103,6 @@ spec:
                 description: CLB 所在 VPC ID，不填则使用 TKE 集群所在的 VPC 的 ID。
                 type: string
             required:
-            - maxPort
-            - minPort
             - ports
             - selector
             type: object
@@ -145,3 +149,4 @@ spec:
     storage: true
     subresources:
       status: {}
+

charts/tke-extend-network-controller/templates/networking.cloud.tencent.com_dedicatedclbservices.yaml

@@ -27,7 +27,7 @@ _Appears in:_
 | Field | Description | Default | Validation |
 | --- | --- | --- | --- |
 | `lbId` _string_ | CLB 实例的 ID。 |  |  |
-| `maxPort` _integer_ | CLB 当前已被分配的端口。 |  |  |
+| `currentPort` _integer_ | CLB 当前已被分配的端口。 |  |  |
 | `autoCreate` _boolean_ | 是否是自动创建的 CLB。如果是，删除 DedicatedCLBService 时，CLB 也会被清理。 |  |  |
 
 
@@ -163,8 +163,9 @@ _Appears in:_
 | --- | --- | --- | --- |
 | `lbRegion` _string_ | CLB 所在地域，不填则使用 TKE 集群所在的地域。 |  |  |
 | `vpcId` _string_ | CLB 所在 VPC ID，不填则使用 TKE 集群所在的 VPC 的 ID。 |  |  |
-| `minPort` _integer_ | CLB 端口范围的最小端口号。 |  |  |
-| `maxPort` _integer_ | CLB 端口范围的最大端口号。 |  |  |
+| `minPort` _integer_ | CLB 端口范围的最小端口号。 | 500 |  |
+| `maxPort` _integer_ | CLB 端口范围的最大端口号。 | 50000 |  |
+| `maxPod` _integer_ | 限制单个 CLB 的 Pod/监听器 的最大数量。 |  |  |
 | `selector` _object (keys:string, values:string)_ | Pod 的标签选择器，被选中的 Pod 会被绑定到 CLB 监听器下。 |  |  |
 | `ports` _[DedicatedCLBServicePort](#dedicatedclbserviceport) array_ | Pod 监听的端口。 |  |  |
 | `listenerExtensiveParameters` _string_ | 创建监听器的参数，JSON 格式，详细参数请参考 CreateListener 接口：https://cloud.tencent.com/document/api/214/30693 |  |  |

docs/api.md

@@ -8,8 +8,8 @@
 1. `selector` 选中目标应用 Pod 的 labels。
 2. `existedLbIds` 传入用于为 Pod 分配公网映射的 CLB 实例 ID 列表，可动态追加。
 3. `minPort` 和 `maxPort` 为 CLB 自动创建监听器的端口范围，每个端口只绑定一个 Pod。
-4. `ports` 为 Pod 监听的端口列表，通常一个房间进程只监听一个端口。其中 `addressPodAnnotation` 用于 CLB 绑定 Pod 后，自动将其 CLB 外部映射地址自动注入到指定的 pod annotation 中，可结合 Kubernetes 的 Downward API 将外部地址挂载进容器内，以便让应用能够感知到自身的公网地址。
-
+4. `maxPod` 用于限制最大 Pod/监听器 数量。
+5. `ports` 为 Pod 监听的端口列表，通常一个房间进程只监听一个端口。其中 `addressPodAnnotation` 用于 CLB 绑定 Pod 后，自动将其 CLB 外部映射地址自动注入到指定的 pod annotation 中，可结合 Kubernetes 的 Downward API 将外部地址挂载进容器内，以便让应用能够感知到自身的公网地址。
 
 ```yaml
 apiVersion: networking.cloud.tencent.com/v1alpha1
@@ -19,8 +19,9 @@ metadata:
   name: gameserver
 spec:
   lbRegion: ap-chengdu # 可选，CLB 所在地域，默认为集群所在地域
-  minPort: 501 # 在 CLB 自动创建监听器，每个 Pod 占用一个端口，端口号范围在 501-600
-  maxPort: 600
+  minPort: 500 # 可选，在 CLB 自动创建监听器，每个 Pod 占用一个端口，默认端口号范围在 500-50000
+  maxPort: 50000
+  maxPod: 50 # 可选，限制最大 Pod/监听器 数量。
   selector:
     app: gameserver
   ports:

docs/clb-mapping.md

@@ -15,8 +15,9 @@ metadata:
   name: gameserver
 spec:
   lbRegion: ap-chengdu # 可选，CLB 所在地域，默认为集群所在地域
-  minPort: 501 # 在 CLB 自动创建监听器，每个 Pod 占用一个端口，端口号范围在 501-600
-  maxPort: 600
+  minPort: 500 # 可选，在 CLB 自动创建监听器，每个 Pod 占用一个端口，默认端口号范围在 500-50000
+  maxPort: 50000
+  maxPod: 50 # 可选，限制最大 Pod/监听器 数量。
   listenerExtensiveParameters: | # 可选，指定创建监听器时的参数(JSON 格式)，完整参考 CreateListener 接口： https://cloud.tencent.com/document/api/214/30693 （由于是一个监听器只挂一个 Pod，通常不需要自定义监听器配置，因为健康检查、调度算法这些配置，对于只有一个 RS 的监听器没有意义）
     {
       "DeregisterTargetRst": true

docs/crd.md

@@ -233,7 +233,11 @@ func (r *DedicatedCLBServiceReconciler) sync(ctx context.Context, ds *networking
 }
 
 func (r *DedicatedCLBServiceReconciler) allocateNewCLB(ctx context.Context, ds *networkingv1alpha1.DedicatedCLBService, num int) error {
-	ids, err := clb.Create(ctx, ds.Spec.LbRegion, ds.Spec.VpcId, ds.Spec.LbAutoCreate.ExtensiveParameters, num)
+	var vpcId string
+	if ds.Spec.VpcId != nil {
+		vpcId = *ds.Spec.VpcId
+	}
+	ids, err := clb.Create(ctx, ds.Spec.LbRegion, vpcId, ds.Spec.LbAutoCreate.ExtensiveParameters, num)
 	if err != nil {
 		return err
 	}
@@ -366,7 +370,7 @@ func (r *DedicatedCLBServiceReconciler) allocateListener(ctx context.Context, ds
 			return true
 		}
 		allocatedPorts := (lb.CurrentPort - ds.Spec.MinPort + 1)
-		return allocatedPorts >= listenerQuota || (ds.Spec.MaxPod > 0 && allocatedPorts >= ds.Spec.MaxPod)
+		return allocatedPorts >= listenerQuota || (ds.Spec.MaxPod != nil && allocatedPorts >= *ds.Spec.MaxPod)
 	}
 	if havePort() { // 该lb已分配完所有端口，尝试下一个lb
 		ds.Status.AllocatableLb = ds.Status.AllocatableLb[1:]