Skip to content

feat(gateway): CEL conditions for plugins#5449

Open
lena-larionova wants to merge 5 commits into
release/gateway-3.15from
feat/conditional-plugins-cel
Open

feat(gateway): CEL conditions for plugins#5449
lena-larionova wants to merge 5 commits into
release/gateway-3.15from
feat/conditional-plugins-cel

Conversation

@lena-larionova
Copy link
Copy Markdown
Contributor

@lena-larionova lena-larionova commented Jun 3, 2026

Description

3.15 replaces plugin expressions in ATC with CEL.

Note: The file app/gateway/plugins/expressions-314.md does not need review, other than for the banner at the top. This is the old doc, renamed. I might turn this into a versioned page.

Fixes #5400

Preview Links

https://deploy-preview-5449--kongdeveloper.netlify.app/gateway/plugins/expressions - new doc for CEL
https://deploy-preview-5449--kongdeveloper.netlify.app/gateway/plugins/expressions-314 - old doc for ATC ‼️ don't review this whole page - it was renamed, so it's actually mostly unchanged. The relevant changes here are the title + warning banner before the intro.
https://deploy-preview-5449--kongdeveloper.netlify.app/gateway/entities/plugin/#conditional-plugin-execution
https://deploy-preview-5449--kongdeveloper.netlify.app/gateway/configure-conditional-plugin-execution/

@netlify
Copy link
Copy Markdown

netlify Bot commented Jun 3, 2026

Deploy Preview for kongdeveloper ready!

Name Link
🔨 Latest commit a6a0666
🔍 Latest deploy log https://app.netlify.com/projects/kongdeveloper/deploys/6a21ed340f6f8e0008ee8e55
😎 Deploy Preview https://deploy-preview-5449--kongdeveloper.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

@lena-larionova lena-larionova force-pushed the feat/conditional-plugins-cel branch from 4595419 to 7e5b109 Compare June 3, 2026 18:11
@lena-larionova lena-larionova marked this pull request as ready for review June 3, 2026 18:11
@lena-larionova lena-larionova requested a review from a team as a code owner June 3, 2026 18:11
Copilot AI review requested due to automatic review settings June 3, 2026 18:11
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

Updates Kong Gateway conditional plugin documentation for 3.15 by migrating the reference material from legacy ATC expressions to CEL, and adds a version-pinned 3.14 reference page for legacy syntax.

Changes:

  • Convert the main plugin-conditions reference (/gateway/plugins/expressions/) from ATC to CEL, including new field/function docs and CEL-focused FAQs.
  • Add a 3.14-only legacy reference page (/gateway/plugins/expressions-314/) with a prominent banner pointing readers to the CEL docs for 3.15+.
  • Update the conditional plugin execution how-to and the Plugin entity docs to reference CEL-based conditions and the updated logging output.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 8 comments.

File Description
app/gateway/plugins/expressions.md Migrates the primary reference page to CEL syntax and expands the field/function reference and FAQs.
app/gateway/plugins/expressions-314.md Adds a version-scoped 3.14 ATC reference page with a warning banner redirecting 3.15+ readers to CEL docs.
app/_how-tos/gateway/configure-conditional-plugin-execution.md Updates the how-to TL;DR and logging examples to match CEL-based conditional execution behavior in 3.15.
app/_gateway_entities/plugin.md Updates the Plugin entity docs’ “Conditional plugin execution” section wording to describe CEL conditions and link to the updated docs.

Comment thread app/gateway/plugins/expressions.md Outdated
Comment thread app/gateway/plugins/expressions.md
Comment thread app/gateway/plugins/expressions.md
Comment thread app/gateway/plugins/expressions.md
Comment thread app/gateway/plugins/expressions.md
Comment thread app/gateway/plugins/expressions-314.md Outdated
Comment thread app/gateway/plugins/expressions.md
Comment thread app/_gateway_entities/plugin.md
Comment thread app/gateway/plugins/expressions.md Outdated
Comment thread app/gateway/plugins/expressions.md Outdated
Comment thread app/gateway/plugins/expressions.md Outdated
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: lena-larionova <54370747+lena-larionova@users.noreply.github.com>
Comment thread app/gateway/plugins/expressions.md Outdated
Copy link
Copy Markdown
Contributor

@chobits chobits left a comment

Choose a reason for hiding this comment

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

Although I thought translating from an ERD to a DOC would involve a lot of details, this document surprisingly covers them all and even adds more examples. Awesome! 🤩

Comment thread app/gateway/plugins/expressions.md Outdated
Comment thread app/gateway/plugins/expressions.md
Comment thread app/gateway/plugins/expressions-314.md
Comment thread app/gateway/plugins/expressions.md Outdated
Comment thread app/gateway/plugins/expressions.md
Comment thread app/gateway/plugins/expressions.md Outdated
Comment thread app/gateway/plugins/expressions.md Outdated
Comment thread app/gateway/plugins/expressions.md Outdated
Comment thread app/gateway/plugins/expressions.md Outdated
Comment thread app/gateway/plugins/expressions.md Outdated
Comment thread app/gateway/plugins/expressions.md Outdated
Comment thread app/gateway/plugins/expressions.md Outdated
Comment thread app/gateway/plugins/expressions.md Outdated
lena-larionova and others added 2 commits June 4, 2026 14:03
Co-authored-by: Angel <Guaris@users.noreply.github.com>
Co-authored-by: lena-larionova <54370747+lena-larionova@users.noreply.github.com>
@lena-larionova lena-larionova requested review from Guaris and chobits June 4, 2026 21:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants