Skip to content

Conversation

lena-larionova
Copy link
Contributor

@lena-larionova lena-larionova commented Sep 3, 2025

Description

Fixes #2622

Solace Consume plugin doc

  • examples of all the modes
  • Also including examples for SSL and URI capture from the original plugin
  • Trying out adding a "use cases and examples" table that links to examples. It feels a bit weird because the descriptions for the modes are just duplicates of the "Implementation" section. Any thoughts?

Still need to test everything to make sure it works in this implementation.

Notes on includes:

  • Removed the "implementation" include: the differences between the event plugins are too big and the include has become messy for such a short list of modes
  • Added a WebSocket include + diagram: should be mostly the same between Kafka and Solace

Preview Links

https://deploy-preview-2768--kongdeveloper.netlify.app/plugins/solace-consume/unreleased/
https://deploy-preview-2768--kongdeveloper.netlify.app/plugins/solace-consume/examples/auto/unreleased
https://deploy-preview-2768--kongdeveloper.netlify.app/event-gateway/#protocol-mediation-plugins
Note that the event gateway index doesn't show this plugin because it's unreleased.

Changes from includes:
https://deploy-preview-2768--kongdeveloper.netlify.app/plugins/kafka-consume/
https://deploy-preview-2768--kongdeveloper.netlify.app/plugins/confluent-consume/

Checklist

  • Tested how-to docs. If not, note why here. - to do
  • All pages contain metadata.
  • Any new docs link to existing docs.
  • All autogenerated instructions render correctly (API, decK, Konnect, Kong Manager).
  • Style guide (capitalized gateway entities, placeholder URLs) implemented correctly.
  • Every page has a description entry in frontmatter.
  • Add new pages to the product documentation index (if applicable).

Copy link

netlify bot commented Sep 3, 2025

Deploy Preview for kongdeveloper ready!

Name Link
🔨 Latest commit 34e4424
🔍 Latest deploy log https://app.netlify.com/projects/kongdeveloper/deploys/68c0a5a8cff9440008062227
😎 Deploy Preview https://deploy-preview-2768--kongdeveloper.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.

@lena-larionova lena-larionova modified the milestone: Gateway 3.12 Sep 3, 2025
@lena-larionova lena-larionova marked this pull request as ready for review September 9, 2025 01:31
@lena-larionova lena-larionova requested a review from a team as a code owner September 9, 2025 01:31
Copy link
Contributor

@cloudjumpercat cloudjumpercat left a comment

Choose a reason for hiding this comment

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

Just had a few suggestions, so I'll approve this now! I tested all the examples and they all worked (with fake values, not real Solace values)

By default, SSL certification validation is disabled. In a production environment, we recommend enabing SSL validation.

In your Solace configuration, set up the following:
* `SESSION_SSL_TRUST_STORE_DIR`: Path to the trust store directory. For example, `/usr/local/share/lua/5.1/kong/plugins/solace/cert`.
Copy link
Member

@bungle bungle Sep 11, 2025

Choose a reason for hiding this comment

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

Just a note, this didn't fit into 3.12, but I am trying to automate this with:
https://github.com/Kong/kong-ee/pull/14004

But for now you need to setup them, most likely in plugin config itself, e.g. in:
config.session.properties map.

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.

3 participants