Skip to content

[release-next] Document the new ListenerSet feature#1970

Merged
cert-manager-prow[bot] merged 3 commits intocert-manager:release-nextfrom
maelvls:listenerset-documentation
Feb 23, 2026
Merged

[release-next] Document the new ListenerSet feature#1970
cert-manager-prow[bot] merged 3 commits intocert-manager:release-nextfrom
maelvls:listenerset-documentation

Conversation

@maelvls
Copy link
Copy Markdown
Member

@maelvls maelvls commented Feb 17, 2026 •
edited
Loading

Preview: https://deploy-preview-1970--cert-manager.netlify.app/docs/usage/gateway/#listenerset

Here is the documentation for the ListenerSet feature (certificate-shim + HTTP-01 solver) in cert-manager/cert-manager#8252.

Copilot AI review requested due to automatic review settings February 17, 2026 17:03
@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. size/L Denotes a PR that changes 100-499 lines, ignoring generated files. labels Feb 17, 2026
@maelvls maelvls changed the title [cert-manger 1.20] Document the new ListenerSet feature [cert-manager 1.20] Document the new ListenerSet feature Feb 17, 2026
@netlify
Copy link
Copy Markdown

netlify Bot commented Feb 17, 2026 •
edited
Loading

✅ Deploy Preview for cert-manager ready!

Built without sensitive environment variables

Name Link
🔨 Latest commit b3f207c
🔍 Latest deploy log https://app.netlify.com/projects/cert-manager/deploys/699c291aa5db9b0008c77d13
😎 Deploy Preview https://deploy-preview-1970--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.

maelvls
maelvls commented Feb 17, 2026
View reviewed changes
Comment thread content/docs/usage/gateway.md Outdated
Copilot AI reviewed Feb 17, 2026
View reviewed changes
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR documents the new ListenerSet feature in cert-manager 1.20, which enables self-service TLS configuration for application developers using Gateway API without requiring edit access to Gateway resources. This addresses a key pain point when migrating from Ingress to Gateway API, where TLS configuration moves from developer-owned Ingress resources to operator-owned Gateway resources.

Changes:

  • Updated the info box at the top of the Gateway documentation to announce ListenerSet support
  • Added comprehensive ListenerSet documentation section with feature overview, installation instructions, and usage examples
  • Documented configuration requirements including Gateway API v1.5+ CRDs and feature gates

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread content/docs/usage/gateway.md Outdated
Comment thread content/docs/usage/gateway.md
Comment thread content/docs/usage/gateway.md Outdated
Comment thread content/docs/usage/gateway.md Outdated
Comment thread content/docs/usage/gateway.md Outdated
@maelvls maelvls force-pushed the listenerset-documentation branch from f92f314 to fce325a Compare February 17, 2026 19:10
hjoshi123
hjoshi123 reviewed Feb 20, 2026
View reviewed changes
Comment thread content/docs/usage/gateway.md Outdated
Comment thread content/docs/usage/gateway.md
defined in that ListenerSet.

ListenerSet resources support the same cert-manager annotations as Gateway
resources. See the [Supported Annotations](#supported-annotations) section
Copy link
Copy Markdown
Contributor

@hjoshi123 hjoshi123 Feb 20, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we have the supported annotations section?

Copy link
Copy Markdown
Member Author

@maelvls maelvls Feb 20, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There is a section "Supported annotations" further up in the page https://cert-manager.io/docs/usage/gateway/#supported-annotations. I had forgotten to update that section to mention ListenerSet, that's now done

@maelvls maelvls force-pushed the listenerset-documentation branch 3 times, most recently from e6d68c9 to 02437a3 Compare February 20, 2026 13:02
@maelvls maelvls changed the base branch from master to release-next February 20, 2026 14:17
@cert-manager-prow cert-manager-prow Bot added size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files. and removed size/L Denotes a PR that changes 100-499 lines, ignoring generated files. labels Feb 20, 2026
@maelvls maelvls force-pushed the listenerset-documentation branch from 02437a3 to 900a9c8 Compare February 20, 2026 14:27
@maelvls
listenerset: documentation
e4d264f 
Signed-off-by: Maël Valais <mael@vls.dev>
@maelvls maelvls force-pushed the listenerset-documentation branch from 900a9c8 to e4d264f Compare February 20, 2026 14:29
@cert-manager-prow cert-manager-prow Bot added size/L Denotes a PR that changes 100-499 lines, ignoring generated files. and removed size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files. labels Feb 20, 2026
@maelvls maelvls changed the title [cert-manager 1.20] Document the new ListenerSet feature [release-next] Document the new ListenerSet feature Feb 20, 2026
@hjoshi123
Copy link
Copy Markdown
Contributor

hjoshi123 commented Feb 20, 2026

@maelvls do we wanna document this annotation in the supported annotations:

acme.cert-manager.io/http01-parentrefkind
acme.cert-manager.io/http01-parentrefname

@maelvls
Copy link
Copy Markdown
Member Author

maelvls commented Feb 20, 2026

Good point, totally forgot to document them. I'll do that.

@maelvls
address Hemant's feedback: add the two new annotations
6a9fa66 
Signed-off-by: Maël Valais <mael@vls.dev>
@maelvls
two annotations were missing from the _redirect file
b3f207c 
cert-manager.io/issuer-name
cert-manager.io/renew-before-percentage

Signed-off-by: Maël Valais <mael@vls.dev>
@maelvls
Copy link
Copy Markdown
Member Author

maelvls commented Feb 23, 2026

Done! @SgtCoDFish Would you be able to take a last look? Thanks!

SgtCoDFish
SgtCoDFish approved these changes Feb 23, 2026
View reviewed changes
Copy link
Copy Markdown
Member

@SgtCoDFish SgtCoDFish left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

/lgtm
/approve

I can't see a reason to not merge this, looks great and makes sense to get it into release-next

@cert-manager-prow cert-manager-prow Bot added the lgtm Indicates that a PR is ready to be merged. label Feb 23, 2026
@cert-manager-prow
Copy link
Copy Markdown
Contributor

cert-manager-prow Bot commented Feb 23, 2026

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: SgtCoDFish

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

The pull request process is described 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

@cert-manager-prow cert-manager-prow Bot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Feb 23, 2026
@cert-manager-prow cert-manager-prow Bot merged commit 3bf9e7c into cert-manager:release-next Feb 23, 2026
7 checks passed
@maelvls maelvls mentioned this pull request Feb 24, 2026
Merged
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

Copilot code review Copilot Copilot left review comments

@SgtCoDFish SgtCoDFish SgtCoDFish approved these changes

+1 more reviewer

@hjoshi123 hjoshi123 hjoshi123 left review comments

Reviewers whose approvals may not affect merge requirements

Assignees

No one assigned

Labels

approved Indicates a PR has been approved by an approver from all required OWNERS files. dco-signoff: yes Indicates that all commits in the pull request have the valid DCO sign-off message. lgtm Indicates that a PR is ready to be merged. size/L Denotes a PR that changes 100-499 lines, ignoring generated files.

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

4 participants

@maelvls @hjoshi123 @SgtCoDFish