[Antrea 2.0] Promote APIs to appropriate versions and feature gates to appropriate stages

[luolanzone]

Describe what you are trying to solve
This is a sub-task of issue #4832.

Describe the solution you have in mind

• API Version
  A few APIs need to be upgraded from alpha to beta, meanwhile, it's a good chance to revisit the code when perform the upgrade, a few known APIs codes need to be cleanup.

• The schema of AntreaAgentInfo / AntreaControllerInfo CRDs are still unstructured, using x-kubernetes-preserve-unknown-fields: true for the whole struct (@ceclinux Add openAPI schema for AntreaAgentInfo and AntreaControllerInfo #5206)
• Egress : v1alpha2 -> v1beta1 (@wenqiq Promote Egress API to v1beta1 #5180 )
• ExternalIPPool: v1alpha2 -> v1beta1 (@hongliangl Promote ExternalIPPool API to v1beta1 #5176 )
• Traceflow : v1alpha1 -> v1beta1 (@luolanzone Promote Traceflow API to v1beta1 #5108 )
  • The SrcIP field in IPHeader and IPv6Header in Traceflow API is never used and redundant with the field with same name in the parent struct.
  • The IPHeader field should be a pointer like IPv6Header to make more sense for IPv6 case.
  • Make the Flags field a pointer to support explicitly setting it to 0, see
    Set default flag to 2 for TCP traceflow #4948 (comment)
• NetworkPolicy / ClusterNetworkPolicy: v1alpha1 -> v1beta1 (@GraysonWu Upgrade ACNP and ANNP to v1beta1 #5186 )
• Tier: v1alpha1 -> v1beta1 (@GraysonWu Upgrade Tier API version to v1beta1 #5172 )
• ClusterGroup/Group: v1alpha3 -> v1beta1 (@GraysonWu Upgrade ClusterGroup and Group to v1beta1 #5181 )

• Feature Gates
  There are some features which may be promising to next stage before or in v2.0:
  (Add or keep the toggle for some GA features)

• UI: Octant -> Antrea UI
• AntreaProxy: Beta -> GA (need to toggle after GA,DSR has a dedicate feature gate?) Promote feature gate AntreaProxy to GA #5401
• EndpointSlice: Beta -> GA (no need toggle) Promote feature gate EndpointSlice to GA #5393
• NodeIPAM: Alpha -> Beta (Done in v1.12) -> GA
• Multicast: Alpha -> Beta （Done in v1.12）
• TopologyAwareHints: Alpha -> Beta (upstream is still Beta in 1.27, keep them consistent)
• Egress: Alpha -> Beta

Following features require more discussions before promoting:

• AntreaPolicy: Beta -> GA? (could it be confusing if the API stage doesn't match feature gate stage?)
• Traceflow: Beta -> GA? (as we are considering graduating its API to v1)
• ServiceExternalIP: Alpha(1.5) -> Beta? (Has a bug need to be resolved, and a new feature is from user)
• IPsecCertAuth: Alpha -> Beta? (need more tests and confirmation about this feature)
• ExternalNode: Alpha -> Beta? (two on-going issues on Azure)
• SupportBundleCollection: Alpha -> Beta? (It's mainly for ExternalNode, CRD is stable, more protocols beside sftp?)
• FlowExporter: Alpha -> Beta? (lots of changes on going, may need more discussion, check the scale test result)
• L7NetworkPolicy: Alpha -> Beta? (a bug about checksum need to be resolved)
• NetworkPolicyStats: Beta (1.2)-> GA?
• NodePortLocal: Beta (1.4) -> GA? Promote feature gate NodePortLocal to GA #5491
• AntreaIPAM: Alpha (1.4) -> Beta?
• TrafficControl: Alpha (1.7) -> Beta ?
• SecondaryNetwork: Alpha (1.5) -> Beta?

[luolanzone]

@GraysonWu I assigned below APIs promotion to you considering they are highly bound to NP, please let me know if you have bandwidth issue. Thanks.

NetworkPolicy / ClusterNetworkPolicy: v1alpha1 -> v1beta1 (@GraysonWu )
Tier: v1alpha1 -> v1beta1 (@GraysonWu )
ClusterGroup/Group: v1alpha3 -> v1beta1 (@GraysonWu )

[luolanzone]

We need a follow up PR to add deprecated for the old versions if we plan to increase the min supported version to v1.19
please refer to this comment #5108 (comment).

[luolanzone]

@antoninbas @jianjuns @tnqn Regarding the feature gate promotion, we have a few candidates as the list in the issue summary, could you help to check if it's good to go to promote AntreaProxy and EndpointSlice to GA? The remaining items are also listed with question mark. Probably we need more discussion for them.

[antoninbas]

I am fine with AntreaProxy and EndpointSlice graduation to GA, but maybe we want to keep a boolean field in the config as a way for users to disable AntreaProxy?

For the others, maybe we can discuss it first at the next community meeting?

[luolanzone]

The other features remained in this issues will be kept the same stage for now. No further changes are required in this issue, so close it.