Skip to content

DATAGO-105494: Documetation update for the NodePorts#50

Merged
LewisKSaint merged 2 commits intodev1.4.0from
lewisDATAGO-105494
Jul 22, 2025
Merged

DATAGO-105494: Documetation update for the NodePorts#50
LewisKSaint merged 2 commits intodev1.4.0from
lewisDATAGO-105494

Conversation

@LewisKSaint
Copy link
Collaborator

@LewisKSaint LewisKSaint commented Jul 22, 2025

JIRA

https://sol-jira.atlassian.net/browse/DATAGO-105494

Description

Documentation updates to show the two main options for configuring the broker for NodePort service type.

Anything for reviewers to be aware of?

N/A

✨ PR Description

Purpose: Update NodePort configuration documentation in the Event Broker Operator User Guide to clarify port assignment options and control.

Main changes:

  • Removed incorrect statement about lack of control over NodePort mappings
  • Added detailed explanation of two NodePort configuration options with YAML examples
  • Clarified explicit vs. automatic NodePort assignment methods with benefits and limitations

Generated by LinearB AI and added by gitStream.
AI-generated content may contain inaccuracies. Please verify before using. We'd love your feedback! 🚀

gitstream-cm[bot]

This comment was marked as resolved.

@gitstream-cm
Copy link

gitstream-cm bot commented Jul 22, 2025

Please mark whether you used Copilot to assist coding in this PR

  • Copilot Assisted


**Option 1:** Explicit NodePort Assignment.

With this option, you explicitly specify which node ports to use for each service port. This gives you full control over port assignments. However, if there are conflicts with existing NodePorts, the deployment will fail.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'd suggest dropping the 'With this option, You...' from the start here:

Explicitly specify which node ports to use for each service port. This gives you full control over port assignments. However, if there are conflicts with existing NodePorts, the deployment will fail.


**Option 2:** Automatic NodePort Assignment.

With this option, you let Kubernetes automatically assign node ports. This is simpler but gives you less control. It also avoids conflicts with existing NodePorts, as Kubernetes will find available ports for you.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Similar to the above, with some additional minor changes:

Let Kubernetes automatically assign node ports. This is simpler, but gives you less control. It also avoids conflicts with existing NodePorts, as Kubernetes finds available ports for you.

To support [Internal load balancers](https://kubernetes.io/docs/concepts/services-networking/service/#internal-load-balancer), a provider-specific service annotation can be added by defining the `spec.service.annotations` parameter.

The `spec.service.ports` parameter defines the broker ports/services exposed. It specifies the event broker `containerPort` that provides the service and the mapping to the `servicePort` where the service can be accessed when using LoadBalancer or ClusterIP - however there is no control over the port number mapping when using NodePort. By default most broker service ports are exposed, refer to the ["pubsubpluseventbrokers" Custom Resource definition](/config/crd/bases/pubsubplus.solace.com_pubsubpluseventbrokers.yaml).
The `spec.service.ports` parameter defines the broker ports/services exposed. It specifies the event broker `containerPort` that provides the service and the mapping to the `servicePort` where the service can be accessed when using LoadBalancer or ClusterIP. By default most broker service ports are exposed, refer to the ["pubsubpluseventbrokers" Custom Resource definition](/config/crd/bases/pubsubplus.solace.com_pubsubpluseventbrokers.yaml).
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

One more minor edit (missing comma after 'By default':

The spec.service.ports parameter defines the broker ports/services exposed. It specifies the event broker containerPort that provides the service and the mapping to the servicePort where the service can be accessed when using LoadBalancer or ClusterIP. By default, most broker service ports are exposed, refer to the "pubsubpluseventbrokers" Custom Resource definition.

Copy link

@gitstream-cm gitstream-cm bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✨ PR Review

LGTM

Generated by LinearB AI and added by gitStream.
AI-generated content may contain inaccuracies. Please verify before using. We'd love your feedback! 🚀

@LewisKSaint LewisKSaint merged commit 1a82c2b into dev1.4.0 Jul 22, 2025
12 checks passed
@LewisKSaint LewisKSaint deleted the lewisDATAGO-105494 branch July 23, 2025 15:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants