Skip to content

Add documentation for servies of type loadbalancer#18

Draft
DebakelOrakel wants to merge 1 commit intomainfrom
doc/loadbalancer
Draft

Add documentation for servies of type loadbalancer#18
DebakelOrakel wants to merge 1 commit intomainfrom
doc/loadbalancer

Conversation

@DebakelOrakel
Copy link
Copy Markdown
Contributor

@DebakelOrakel DebakelOrakel commented Apr 8, 2026

Checklist

  • Try to isolate changes into separate PRs (to build a better changelog).
  • Categorize the PR by setting a good title and adding one of the labels:
    change, decision, requirement/quality, requirement/functional, dependency
    as they show up in the changelog
  • Link this PR to related issues if applicable.

@DebakelOrakel DebakelOrakel requested a review from a team April 8, 2026 11:15
@DebakelOrakel DebakelOrakel added enhancement New feature or request change and removed enhancement New feature or request labels Apr 8, 2026
Copy link
Copy Markdown
Member

@simu simu left a comment

Choose a reason for hiding this comment

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

Generally, I feel like the current revision of this page creates the wrong impression that exposing applications via service type LoadBalancer just works on all clusters.

I've added some inline comments for some obvious caveats, but I think this will need quite a bit more detail before it's actually suitable to publish.

Comment on lines +47 to +48
L2 Announcements is a feature which makes services visible and reachable on the machine network of the cluster.
This feature is primarily intended for on-premises deployments within networks without BGP based routing.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Copy-paste error?

@@ -0,0 +1,165 @@
= Service Type LoadBalancer

Depending on the infrastructure there are different implementations of services of type LoadBalancer.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
Depending on the infrastructure there are different implementations of services of type LoadBalancer.
Depending on the infrastructure there are different implementations of services of type LoadBalancer.
[IMPORTANT]
====
For some infrastructures, no `LoadBalancer` service types are available out of the box.
Please contact us if you need `LoadBalancer` services on such infrastructures.
====

protocol: TCP
----
<1> Define the selector associated with your deployment.
<2> Allow access from `world`.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
<2> Allow access from `world`.
<2> Allow access from anywhere (CIDR `0.0.0.0/0`).
Note that, depending on the `LoadBalancer` implementation, it may or may not be possible to restrict access to specific IPs via network policy.

kind: Service
metadata:
name: your-service-lb
namespace: your-namespace
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

This example should have a few of the useful annotations such as access control and a link to https://github.com/cloudscale-ch/cloudscale-cloud-controller-manager?tab=readme-ov-file#loadbalancer-service-configuration

@DebakelOrakel DebakelOrakel marked this pull request as draft April 9, 2026 09:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants