Skip to content

Document Pulsar topicsPattern regex subscriptions#5226

Open
jslatten wants to merge 2 commits into
dapr:v1.18from
jslatten:pulsar-topics-pattern-docs
Open

Document Pulsar topicsPattern regex subscriptions#5226
jslatten wants to merge 2 commits into
dapr:v1.18from
jslatten:pulsar-topics-pattern-docs

Conversation

@jslatten

@jslatten jslatten commented Jun 25, 2026

Copy link
Copy Markdown
Contributor

Thank you for helping make the Dapr documentation better!

Please follow this checklist before submitting:

  • Commits are signed with Developer Certificate of Origin (DCO - learn more)
  • Read the contribution guide
  • Commands include options for Linux, MacOS, and Windows within tabpane
  • New file and folder names are globally unique
  • Page references use shortcodes instead of markdown or URL links
  • Images use HTML style and have alternative text
  • Places where multiple code/command options are given have tabpane

Description

Documents the new topicsPattern and autoDiscoveryPeriod metadata fields on the Apache Pulsar pub/sub component, which add support for subscribing to multiple topics within a tenant/namespace by regular expression (with Pulsar auto-discovering newly created matching topics).

Changes to reference/components-reference/supported-pubsub/setup-pulsar.md:

  • Two new rows in the Spec metadata fields table: topicsPattern and autoDiscoveryPeriod.
  • A new Subscribe to multiple topics with a pattern section explaining the behavior, scoping (tenant/namespace), regex (not glob) semantics, auto-discovery, concrete-topic delivery, and the schema-validation caveat, with a YAML example.

This is the documentation counterpart to the component implementation in dapr/components-contrib (PR linked below), as required by the components-contrib contribution process.

Issue reference

Relates to dapr/components-contrib#2566
Implementation PR: dapr/components-contrib#4422

Add documentation for the new topicsPattern and autoDiscoveryPeriod
metadata fields on the Pulsar pub/sub component, which enable subscribing
to multiple topics within a tenant/namespace by regular expression with
automatic discovery of newly created matching topics.

Relates to dapr/components-contrib#2566

Signed-off-by: Justin Slatten <justin.slatten@gmail.com>
Document the default as "0" (defers to the Pulsar client's own interval,
currently 1m) instead of "1m", matching what the component sets when the
field is unset.

Relates to dapr/components-contrib#2566

Signed-off-by: Justin Slatten <justin.slatten@gmail.com>
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.

1 participant