changelog, docs

Author: adwk67

CHANGELOG.md

@@ -16,5 +16,7 @@ All notable changes to this project will be documented in this file.
   - Resources (CPU, memory, storage)
   - PodDisruptionBudgets
   - Replicas
+- Add Listener support ([#17]).
 
 [#10]: https://github.com/stackabletech/opensearch-operator/pull/10
+[#17]: https://github.com/stackabletech/opensearch-operator/pull/17

docs/modules/opensearch/pages/usage-guide/listenerclass.adoc

@@ -0,0 +1,17 @@
+= Service exposition with ListenerClasses
+:description: Configure OpenSearch service exposure with ListenerClasses: cluster-internal, external-unstable, or external-stable.
+
+The operator deploys a xref:listener-operator:listener.adoc[Listener] for OpenSearch role-groups.
+The listener defaults to only being accessible from within the Kubernetes cluster, but this can be changed by setting `.spec.nodes.roleGroups.{role-group-name}.config.listenerClass`:
+
+[source,yaml]
+----
+spec:
+  nodes:
+    roleGroups:
+      cluster-manager:
+        config:
+          listenerClass: external-stable
+----
+<1> Specify a ListenerClass, such as `external-stable`, `external-unstable`, or `cluster-internal` (the default setting is `cluster-internal`) at role-group level.
+This can be set for all role-groups individually.

docs/modules/opensearch/partials/nav.adoc

@@ -2,6 +2,7 @@
 ** xref:opensearch:getting_started/installation.adoc[]
 ** xref:opensearch:getting_started/first_steps.adoc[]
 * xref:opensearch:usage-guide/index.adoc[]
+** xref:opensearch:usage-guide/listenerclass.adoc[]
 ** xref:opensearch:usage-guide/node-roles.adoc[]
 ** xref:opensearch:usage-guide/storage-resource-configuration.adoc[]
 ** xref:opensearch:usage-guide/configuration-environment-overrides.adoc[]

rust/operator-binary/src/crd/mod.rs

@@ -242,7 +242,7 @@ impl v1alpha1::OpenSearchConfig {
                     },
                 },
             },
-            listener_class: Some("cluster-internal".to_string()),
+            listener_class: Some(DEFAULT_LISTENER_CLASS.to_string()),
         }
     }
 }