Skip to content

docs: add private load balancers + DNS-01 credentials guide#333

Open
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/972c96d4
Open

docs: add private load balancers + DNS-01 credentials guide#333
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/972c96d4

Conversation

@mintlify

@mintlify mintlify Bot commented Jun 10, 2026

Copy link
Copy Markdown
Contributor

Summary

Documents the private NGINX ingress controller + DNS-01 cluster issuer that ships behind the internal NLB feature flag, including the new per-cluster DNS provider credentials endpoints.

Context

The upstream change introduces an internal-only ingress-nginx controller (ingress class nginx-private) plus a cert-manager ClusterIssuer that solves ACME challenges via DNS-01, so private load balancers can serve managed TLS without being publicly reachable. The feature is declared on the cluster contract as an AdditionalLoadBalancer with network_access: PRIVATE and a dns_provider_config (Cloudflare today). Three new API endpoints manage the per-cluster DNS provider API token:

  • GET /api/v2/projects/{project_id}/clusters/{cluster_id}/dns/credentials
  • POST /api/v2/projects/{project_id}/clusters/{cluster_id}/dns/credentials
  • DELETE /api/v2/projects/{project_id}/clusters/{cluster_id}/dns/credentials

Contract writes reject unsupported DNS providers and duplicate additional load balancer entries.

Changes

  • New page applications/configure/private-load-balancers.mdx covering when to use a private LB, prerequisites (Cloudflare API token scopes), how to store / check / rotate / delete DNS credentials, the cluster contract shape, and troubleshooting.
  • Not wired into navigation: the entire feature is gated by the internal_nlb_enabled flag, so per workflow guidance the page is not added to mint.json.

cc @MauAraujo for review.

@mintlify

mintlify Bot commented Jun 10, 2026

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated (UTC)
porter 🟢 Ready View Preview Jun 10, 2026, 3:03 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