Skip to content

docs: improve custom certificate installation guide - #9650

Open
dlanov wants to merge 1 commit into
envoyproxy:mainfrom
dlanov:docs-5757-custom-cert-guide
Open

docs: improve custom certificate installation guide#9650
dlanov wants to merge 1 commit into
envoyproxy:mainfrom
dlanov:docs-5757-custom-cert-guide

Conversation

@dlanov

@dlanov dlanov commented Aug 3, 2026

Copy link
Copy Markdown

Summary

Improve the custom control-plane certificate installation guide by making it a complete, directly executable workflow.

This update:

  • Links to the cert-manager kubectl installation instructions.
  • Creates the envoy-gateway-system namespace before applying namespaced resources.
  • Corrects the envoy-gatewy Secret typo.
  • Adds readiness checks for the CA issuer and certificates.
  • Verifies the generated TLS Secrets.
  • Adds a Helm values example and installation command.
  • Explains that the certgen job should remain enabled because it preserves existing custom certificate Secrets.
  • Adds deployment, pod, and Helm release verification commands.
  • Documents how to keep the Kubernetes cluster domain aligned with the controller certificate DNS names.

Validation

  • tools/node_modules/.bin/markdownlint -c .github/markdown_lint_config.json site/content/en/latest/install/custom-cert.md
  • cd site && npm run build:production
  • make docs-check
  • git diff --check

Fixes #5757.

Signed-off-by: Dennis Lanov <dennis.lanov@gmail.com>
@dlanov
dlanov requested a review from a team as a code owner August 3, 2026 14:43
@netlify

netlify Bot commented Aug 3, 2026

Copy link
Copy Markdown

Deploy Preview for cerulean-figolla-1f9435 ready!

Name Link
🔨 Latest commit 71d6409
🔍 Latest deploy log https://app.netlify.com/projects/cerulean-figolla-1f9435/deploys/6a70a9021ac11000089093c8
😎 Deploy Preview https://deploy-preview-9650--cerulean-figolla-1f9435.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

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.

docs: add more instructions to Control Plane Auth using Custom Certs doc

1 participant