feat: add kubernetes cert-issuer docs

[carlosmonastyrski]

Context

Kubernetes Issuer guide: This adds a friendly, step-by-step guide that walks customers through issuing Kubernetes certificates with the Infisical Issuer, from installing it to connecting it to their PKI Application and getting their first certificate. It also renames the existing cert-manager guide so it's clear that one covers the ACME approach, making it easy for readers to pick the path that fits their setup without mixing the two up.

Screenshots

Steps to verify the change

Type

• Fix
• Feature
• Improvement
• Breaking
• Docs
• Chore

Checklist

• Title follows the conventional commit format: type(scope): short description (scope is optional, e.g., fix: prevent crash on sync or fix(api): handle null response).
• Tested locally
• Updated docs (if needed)
• Updated CLAUDE.md files (if needed)
• Read the contributing guide

[infisical-review-police]

💬 Discussion in Slack: #pr-review-infisical-7042-feat-add-kubernetes-cert-issuer-docs

Posted by Review Police — reviews, comments, new commits, and CI failures will stream into this channel.

[linear]

PKI-269

[mintlify]

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

Project	Status	Preview	Updated (UTC)
infisical	🟢 Ready	View Preview	Jun 26, 2026, 4:50 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

[greptile-apps]

Greptile Summary

This PR splits the existing Kubernetes cert-manager guide into two separate pages — one for the ACME/EAB approach (k8s-cert-manager-acme) and a new one for the Infisical external issuer (k8s-cert-manager-issuer) — and updates all cross-links, the nav, and adds a redirect for the old URL.

• New guide (k8s-cert-manager-issuer.mdx): covers installing the Infisical cert-manager external issuer via Helm, RBAC approver setup, Universal Auth and Kubernetes Auth credential flows, Issuer/ClusterIssuer YAML, and FAQ.
• Renamed guide (k8s-cert-manager-acme.mdx): minor title/description updates and a new Info callout directing users to the Infisical Issuer guide when appropriate.
• Navigation and redirects in docs.json are correctly updated; all in-doc cross-links in gloo-mesh.mdx, acme.mdx, overview.mdx, and migration.mdx are also updated.

Confidence Score: 5/5

Pure documentation change with no executable code. All link updates are consistent and the redirect preserves existing URLs.

Every internal cross-link, the nav entry in docs.json, and the redirect all point to the correct new targets. The new Infisical Issuer guide is detailed and technically sound, covering RBAC, both auth methods, ClusterIssuer nuances, and a FAQ. No code is modified.

No files require special attention.

Important Files Changed

Filename	Overview
docs/docs.json	Adds both new pages to the nav, removes old k8s-cert-manager entry, and adds a redirect from the old URL to the ACME page. Changes look correct.
docs/documentation/platform/pki/guides/applications/k8s-cert-manager-issuer.mdx	New guide for the Infisical cert-manager external issuer. Well-structured with RBAC approver setup, Universal Auth and Kubernetes Auth tabs, FAQ, and cross-links to the ACME guide. Content is technically accurate.
docs/documentation/platform/pki/guides/applications/k8s-cert-manager-acme.mdx	Renamed from k8s-cert-manager.mdx with minor title/description updates and an added Info callout linking to the new Infisical Issuer guide. No issues.
docs/documentation/platform/pki/guides/applications/gloo-mesh.mdx	Link updated from the old URL to k8s-cert-manager-acme; the Gloo Mesh guide explicitly uses ACME enrollment, so this target is correct.
docs/documentation/platform/pki/applications/enrollment-methods/acme.mdx	Two link references updated from k8s-cert-manager to k8s-cert-manager-acme. No issues.
docs/documentation/platform/pki/guides/overview.mdx	Overview card split into two entries for the ACME and Infisical Issuer guides. Links and descriptions are accurate.
docs/documentation/platform/pki/migration.mdx	Single link reference updated from old URL to k8s-cert-manager-acme. No issues.

_{Reviews (1): Last reviewed commit: "Add kubernetes cert-issuer docs" | Re-trigger Greptile}

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 312c3ceba3

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".