feat!: Add new ListenerClass.pinnedNodePorts field (#1105)

* feat!: Add new `ListenerClass.stickyNodePorts` field

* changelog

* Update crates/stackable-operator/src/crd/listener/class/mod.rs

Co-authored-by: Techassi <git@techassi.dev>

* Update crates/stackable-operator/src/crd/listener/class/mod.rs

* sticky -> pinning

* pinning -> pinned

* changelog

* changelog

* Update crates/stackable-operator/src/crd/listener/class/mod.rs

Co-authored-by: Nick <10092581+NickLarsenNZ@users.noreply.github.com>

* charts

---------

Co-authored-by: Techassi <git@techassi.dev>
Co-authored-by: Nick <10092581+NickLarsenNZ@users.noreply.github.com>

Author: 3 people

crates/stackable-operator/CHANGELOG.md

@@ -4,12 +4,18 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+### Added
+
+- BREAKING: Add new ListenerClass `.spec.pinnedNodePorts` field ([#1105]).
+
+[#1105]: https://github.com/stackabletech/operator-rs/pull/1105
+
 ## [0.99.0] - 2025-10-06
 
 ### Added
 
 - Add CLI argument and env var to disable the end-of-support checker: `EOS_DISABLED` (`--eos-disabled`) ([#1101]).
-- Add end-of-support checker ([#1096]).
+- Add end-of-support checker ([#1096], [#1103]).
   - The EoS checker can be constructed using `EndOfSupportChecker::new()`.
   - Add new `MaintenanceOptions` and `EndOfSupportOptions` structs.
   - Add new CLI arguments and env vars:

crates/stackable-operator/crds/ListenerClass.yaml

@@ -66,5 +66,19 @@ pub mod versioned {
         /// Defaults to `HostnameConservative`.
         #[serde(default = "ListenerClassSpec::default_preferred_address_type")]
         pub preferred_address_type: core_v1alpha1::PreferredAddressType,
+
+        /// Whether or not a Pod exposed using a NodePort should be pinned to a specific Kubernetes node.
+        ///
+        /// By pinning the Pod to a specific (stable) Kubernetes node, stable addresses can be
+        /// provided using NodePorts. The pinning is achieved by listener-operator setting the
+        /// `volume.kubernetes.io/selected-node` annotation on the Listener PVC.
+        ///
+        /// However, this only works on setups with long-living nodes. If your nodes are rotated on
+        /// a regular basis, the Pods previously running on a removed node will be stuck in Pending
+        /// until you delete the PVC with the pinning.
+        ///
+        /// Because of this we don't enable pinning by default to support all environments.
+        #[serde(default)]
+        pub pinned_node_ports: bool,
     }
 }