Scaffolding for the listener controller

$ go run ./cmd/scaffold-controller -interactive=false       -kind=Listener       -gophercloud-client=NewLoadBalancerV2       -gophercloud-module=github.com/gophercloud/gophercloud/v2/openstack/loadbalancer/v2/listeners       -gophercloud-type=Listener       -openstack-json-object=listener       -available-polling-period=15       -deleting-polling-period=15       -required-create-dependency=LoadBalancer       -optional-create-dependency=Pool       -import-dependency=LoadBalancer

Author: eshulman2

api/v1alpha1/listener_types.go

@@ -0,0 +1,98 @@
+/*
+Copyright 2025 The ORC 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 v1alpha1
+
+// ListenerResourceSpec contains the desired state of the resource.
+type ListenerResourceSpec struct {
+	// name will be the name of the created resource. If not specified, the
+	// name of the ORC object will be used.
+	// +optional
+	Name *OpenStackName `json:"name,omitempty"`
+
+	// description is a human-readable description for the resource.
+	// +kubebuilder:validation:MinLength:=1
+	// +kubebuilder:validation:MaxLength:=255
+	// +optional
+	Description *string `json:"description,omitempty"`
+
+	// loadBalancerRef is a reference to the ORC LoadBalancer which this resource is associated with.
+	// +required
+	// +kubebuilder:validation:XValidation:rule="self == oldSelf",message="loadBalancerRef is immutable"
+	LoadBalancerRef KubernetesNameRef `json:"loadBalancerRef,omitempty"`
+
+	// poolRef is a reference to the ORC Pool which this resource is associated with.
+	// +optional
+	// +kubebuilder:validation:XValidation:rule="self == oldSelf",message="poolRef is immutable"
+	PoolRef *KubernetesNameRef `json:"poolRef,omitempty"`
+
+	// TODO(scaffolding): Add more types.
+	// To see what is supported, you can take inspiration from the CreateOpts structure from
+	// github.com/gophercloud/gophercloud/v2/openstack/loadbalancer/v2/listeners
+	//
+	// Until you have implemented mutability for the field, you must add a CEL validation
+	// preventing the field being modified:
+	// `// +kubebuilder:validation:XValidation:rule="self == oldSelf",message="<fieldname> is immutable"`
+}
+
+// ListenerFilter defines an existing resource by its properties
+// +kubebuilder:validation:MinProperties:=1
+type ListenerFilter struct {
+	// name of the existing resource
+	// +optional
+	Name *OpenStackName `json:"name,omitempty"`
+
+	// description of the existing resource
+	// +kubebuilder:validation:MinLength:=1
+	// +kubebuilder:validation:MaxLength:=255
+	// +optional
+	Description *string `json:"description,omitempty"`
+
+	// loadBalancerRef is a reference to the ORC LoadBalancer which this resource is associated with.
+	// +optional
+	LoadBalancerRef *KubernetesNameRef `json:"loadBalancerRef,omitempty"`
+
+	// TODO(scaffolding): Add more types.
+	// To see what is supported, you can take inspiration from the ListOpts structure from
+	// github.com/gophercloud/gophercloud/v2/openstack/loadbalancer/v2/listeners
+}
+
+// ListenerResourceStatus represents the observed state of the resource.
+type ListenerResourceStatus struct {
+	// name is a Human-readable name for the resource. Might not be unique.
+	// +kubebuilder:validation:MaxLength=1024
+	// +optional
+	Name string `json:"name,omitempty"`
+
+	// description is a human-readable description for the resource.
+	// +kubebuilder:validation:MaxLength=1024
+	// +optional
+	Description string `json:"description,omitempty"`
+
+	// loadBalancerID is the ID of the LoadBalancer to which the resource is associated.
+	// +kubebuilder:validation:MaxLength=1024
+	// +optional
+	LoadBalancerID string `json:"loadBalancerID,omitempty"`
+
+	// poolID is the ID of the Pool to which the resource is associated.
+	// +kubebuilder:validation:MaxLength=1024
+	// +optional
+	PoolID string `json:"poolID,omitempty"`
+
+	// TODO(scaffolding): Add more types.
+	// To see what is supported, you can take inspiration from the Listener structure from
+	// github.com/gophercloud/gophercloud/v2/openstack/loadbalancer/v2/listeners
+}

api/v1alpha1/zz_generated.deepcopy.go

@@ -23,6 +23,7 @@ rules:
   - groups
   - images
   - keypairs
+  - listeners
   - loadbalancers
   - networks
   - ports
@@ -54,6 +55,7 @@ rules:
   - groups/status
   - images/status
   - keypairs/status
+  - listeners/status
   - loadbalancers/status
   - networks/status
   - ports/status

cmd/models-schema/zz_generated.openapi.go

@@ -0,0 +1,14 @@
+---
+apiVersion: openstack.k-orc.cloud/v1alpha1
+kind: Listener
+metadata:
+  name: listener-sample
+spec:
+  cloudCredentialsRef:
+    # TODO(scaffolding): Use openstack-admin if the resource needs admin credentials to be created
+    cloudName: openstack
+    secretName: openstack-clouds
+  managementPolicy: managed
+  resource:
+    description: Sample Listener
+    # TODO(scaffolding): Add all fields the resource supports