Skip to content

docs: add NetworkPolicy example manifests#2064

Open
yosofbadr wants to merge 2 commits into
cert-manager:masterfrom
yosofbadr:docs/network-policy
Open

docs: add NetworkPolicy example manifests#2064
yosofbadr wants to merge 2 commits into
cert-manager:masterfrom
yosofbadr:docs/network-policy

Conversation

@yosofbadr
Copy link
Copy Markdown

@yosofbadr yosofbadr commented Apr 15, 2026

Summary

  • Add concrete, ready-to-use Kubernetes NetworkPolicy manifests to the best-practice page
  • Cover seven common policy scenarios: default deny, DNS egress, HTTPS/HTTP egress, webhook ingress, startupapicheck ingress, metrics ingress, and HTTP01 solver ingress
  • Apply the same changes to both content/docs/ and content/v1.19-docs/

Why

Issue cert-manager/cert-manager#2334 collected reports from users running restrictive NetworkPolicy configurations (Calico, Cilium, etc.) who struggled to translate cert-manager's documented network requirements into working manifests. The best-practice page already describes the required traffic flows and provides Helm chart values, but does not include standalone NetworkPolicy resources that users can adapt.

A project maintainer noted in cert-manager/website#1344 that example manifests would be welcome in follow-up PRs.

This PR complements cert-manager/website#2041, which adds cross-references from the HTTP01 guide to the best-practice page.

Test plan

  • Verify the rendered markdown displays correctly in the Netlify deploy preview
  • Confirm all internal documentation links resolve
  • Review each example manifest against the network requirements listed in the same page

Ref: cert-manager/cert-manager#2334

@cert-manager-prow cert-manager-prow Bot added do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. dco-signoff: no Indicates that at least one commit in this pull request is missing the DCO sign-off message. size/L Denotes a PR that changes 100-499 lines, ignoring generated files. labels Apr 15, 2026
@cert-manager-prow
Copy link
Copy Markdown
Contributor

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign joshvanl for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@netlify
Copy link
Copy Markdown

netlify Bot commented Apr 15, 2026

Deploy Preview for cert-manager ready!

Built without sensitive environment variables

Name Link
🔨 Latest commit 692e4bb
🔍 Latest deploy log https://app.netlify.com/projects/cert-manager/deploys/69e7ede1b4489f00084cff4a
😎 Deploy Preview https://deploy-preview-2064--cert-manager.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.

Add concrete, ready-to-use Kubernetes NetworkPolicy manifests to the
best-practice documentation. These examples cover:

- Default deny-all baseline policy
- DNS egress for all components
- HTTPS/HTTP egress for API server and ACME endpoints
- Webhook ingress from the Kubernetes API server
- Webhook ingress from startupapicheck
- Metrics port ingress for Prometheus scraping
- HTTP01 acmesolver pod ingress on port 8089

The existing documentation describes network requirements and Helm chart
values, but users on clusters with restrictive NetworkPolicy (e.g. Calico
default-deny) have reported difficulty translating those requirements into
working manifests.

Ref: cert-manager/cert-manager#2334
Signed-off-by: Yosof Badr <23705518+YosofBadr@users.noreply.github.com>
@yosofbadr yosofbadr force-pushed the docs/network-policy branch from 27d5add to 2ecb8cb Compare April 15, 2026 19:46
@cert-manager-prow cert-manager-prow Bot added dco-signoff: yes Indicates that all commits in the pull request have the valid DCO sign-off message. and removed dco-signoff: no Indicates that at least one commit in this pull request is missing the DCO sign-off message. labels Apr 15, 2026
@yosofbadr yosofbadr marked this pull request as ready for review April 16, 2026 04:38
@cert-manager-prow cert-manager-prow Bot removed the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label Apr 16, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

dco-signoff: yes Indicates that all commits in the pull request have the valid DCO sign-off message. size/L Denotes a PR that changes 100-499 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant