ListenerSet adjust PortNumber kubebuilder validations

apis/v1/gateway_types.go

@@ -390,6 +390,9 @@ type Listener struct {
 	// same port, subject to the Listener compatibility rules.
 	//
 	// Support: Core
+	//
+	// +kubebuilder:validation:Minimum=1
+	// +kubebuilder:validation:Maximum=65535
 	Port PortNumber `json:"port"`
 
 	// Protocol specifies the network protocol this listener expects to receive.

apis/v1/httproute_types.go

@@ -1209,6 +1209,9 @@ type HTTPRequestRedirectFilter struct {
 	// Support: Extended
 	//
 	// +optional
+	//
+	// +kubebuilder:validation:Minimum=1
+	// +kubebuilder:validation:Maximum=65535
 	Port *PortNumber `json:"port,omitempty"`
 
 	// StatusCode is the HTTP status code to be used in response.

apis/v1/object_reference_types.go

@@ -143,6 +143,8 @@ type BackendObjectReference struct {
 	// resource or this field.
 	//
 	// +optional
+	// +kubebuilder:validation:Minimum=1
+	// +kubebuilder:validation:Maximum=65535
 	Port *PortNumber `json:"port,omitempty"`
 }
 

apis/v1/shared_types.go

@@ -148,6 +148,9 @@ type ParentReference struct {
 	// Support: Extended
 	//
 	// +optional
+	//
+	// +kubebuilder:validation:Minimum=1
+	// +kubebuilder:validation:Maximum=65535
 	Port *PortNumber `json:"port,omitempty"`
 }
 
@@ -227,9 +230,6 @@ type CommonRouteSpec struct {
 }
 
 // PortNumber defines a network port.
-//
-// +kubebuilder:validation:Minimum=1
-// +kubebuilder:validation:Maximum=65535
 type PortNumber int32
 
 // BackendRef defines how a Route should forward a request to a Kubernetes

apis/v1alpha2/shared_types.go

@@ -40,9 +40,6 @@ type ParentReference = v1.ParentReference
 type CommonRouteSpec = v1.CommonRouteSpec
 
 // PortNumber defines a network port.
-//
-// +kubebuilder:validation:Minimum=1
-// +kubebuilder:validation:Maximum=65535
 type PortNumber = v1.PortNumber
 
 // BackendRef defines how a Route should forward a request to a Kubernetes

apis/v1beta1/shared_types.go

@@ -40,9 +40,6 @@ type ParentReference = v1.ParentReference
 type CommonRouteSpec = v1.CommonRouteSpec
 
 // PortNumber defines a network port.
-//
-// +kubebuilder:validation:Minimum=1
-// +kubebuilder:validation:Maximum=65535
 type PortNumber = v1.PortNumber
 
 // BackendRef defines how a Route should forward a request to a Kubernetes

apisx/v1alpha1/xlistenerset_types.go

@@ -127,7 +127,13 @@ type ListenerEntry struct {
 
 	// Port is the network port. Multiple listeners may use the
 	// same port, subject to the Listener compatibility rules.
-	Port PortNumber `json:"port"`
+	//
+	// +optional
+	//
+	// +kubebuilder:default=0
+	// +kubebuilder:validation:Minimum=0
+	// +kubebuilder:validation:Maximum=65535
+	Port PortNumber `json:"port,omitempty"`
 
 	// Protocol specifies the network protocol this listener expects to receive.
 	Protocol ProtocolType `json:"protocol"`
@@ -208,6 +214,9 @@ type ListenerEntryStatus struct {
 	Name SectionName `json:"name"`
 
 	// Port is the network port the listener is configured to listen on.
+	//
+	// +kubebuilder:validation:Minimum=1
+	// +kubebuilder:validation:Maximum=65535
 	Port PortNumber `json:"port"`
 
 	// SupportedKinds is the list indicating the Kinds supported by this

pkg/generator/main.go

@@ -69,6 +69,8 @@ func main() {
 		log.Fatalf("failed to register markers: %s", err)
 	}
 
+	registerMarkerOverrides(parser.Collector.Registry)
+
 	crd.AddKnownTypes(parser)
 	for _, r := range roots {
 		parser.NeedPackage(r)

pkg/generator/markers.go

@@ -0,0 +1,66 @@
+/*
+Copyright 2025 The Kubernetes Authors.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+package main
+
+import (
+	apiext "k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1"
+	"sigs.k8s.io/controller-tools/pkg/markers"
+)
+
+type Minimum float64
+
+func (m Minimum) Value() float64 {
+	return float64(m)
+}
+
+//nolint:unparam
+func (m Minimum) ApplyToSchema(schema *apiext.JSONSchemaProps) error {
+	val := m.Value()
+	schema.Minimum = &val
+	return nil
+}
+
+type Maximum float64
+
+func (m Maximum) Value() float64 {
+	return float64(m)
+}
+
+//nolint:unparam
+func (m Maximum) ApplyToSchema(schema *apiext.JSONSchemaProps) error {
+	val := m.Value()
+	schema.Maximum = &val
+	return nil
+}
+
+// kubebuilder Min Max markers are broken with type aliases
+func registerMarkerOverrides(into *markers.Registry) {
+	minMarker, _ := markers.MakeDefinition(
+		"kubebuilder:validation:Minimum",
+		markers.DescribesField,
+		Minimum(0),
+	)
+
+	maxMarker, _ := markers.MakeDefinition(
+		"kubebuilder:validation:Maximum",
+		markers.DescribesField,
+		Maximum(0),
+	)
+
+	into.Register(minMarker) //nolint:errcheck
+	into.Register(maxMarker) //nolint:errcheck
+}