Skip to content

docs: document internal load balancer requirements for private web services#270

Open
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/43ea7d62
Open

docs: document internal load balancer requirements for private web services#270
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/43ea7d62

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify Bot commented May 19, 2026

Summary

Clarifies how Porter handles private (internal load balancer) web services now that internal-LB availability is discovered live from each cluster rather than assumed.

Context

Upstream change ships per-cluster discovery of ingress endpoints. The internal load-balancer option is now only offered on clusters where the controller is actually installed, and app create/update is rejected (invalid_load_balancer_mode) when private: true is set on a cluster that lacks the controller. Private services also use a different CNAME target than public services, surfaced per-service in the Networking tab.

Changes

  • applications/configuration-as-code/services/web-service.mdx: Expanded the private field reference with prerequisites, the dashboard gating behavior, the validation error users may hit, and a note that the CNAME target differs from public services.
  • applications/configure/custom-domains.mdx: Added a callout that public and private services have different load-balancer hostnames, and that switching a service's mode requires updating the DNS record.

@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify Bot commented May 19, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
porter 🟢 Ready View Preview May 19, 2026, 9:07 PM

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.

0 participants