Skip to content

v0.5.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 24 Feb 21:15
· 1107 commits to main since this release
v0.5.0
654acb4
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Kong logo kongctl Release Highlights

Welcome to kongctl v0.5.0! This release brings powerful new CLI capabilities, expanded declarative workflow support, and meaningful quality-of-life improvements for everyday Kong Konnect users.

✨ What's New

kongctl listen — Real-time Konnect Audit-Log Streaming

A brand-new listen command lets you subscribe to and stream Audit-Log events from Konnect in real time, giving you live visibility into Konnect activity, authorizations, API access, and more

kongctl listen --help
kongctl tail --help

kongctl lint — Validate Declarative Config

A new lint command validates your declarative configuration files before you apply them, catching errors early in the workflow.

kongctl lint -f config.yaml

kongctl patch file — File-based Patching

Apply partial updates to resources from a file, complementing the existing inline patch support.

kongctl patch file -f patch.yaml

kongctl delete -f — Bulk Declarative Cleanup

You can now use -f (file input) with the delete command to remove all resources described in a declarative input file — enabling clean, repeatable teardown of environments.

kongctl delete -f config.yaml

Expanded --jq Filter Support

The --jq flag for filtering output is now available across all get and list commands, making it easier to extract and script against specific fields.

kongctl get control-planes --jq '.items[].name'

🐛 Fixes & Improvements

  • --jq with empty arrays: Fixed a bug where jq filters incorrectly returned null for empty array responses (#461).
  • plan command flags: The -o/--output flag is now correctly rejected on the plan command, with improved error messages and examples (#450).
  • Actionable arg errors: plan, diff, and sync now emit clear, actionable errors when unexpected positional arguments are passed (#451).
  • TUI theme cycling: Real-time theme cycling in the TUI viewer improves terminal compatibility, especially in non-standard terminal emulators (#449).
  • Improved API request/response logging: More structured and readable logs for HTTP interactions when using --log-level debug/trace (#457).
  • Declarative API optimization: Reduced API calls in declarative sync operations for faster and more efficient plan/apply workflows (#464).
  • Dependency updates: charmbracelet/bubbles v1, golang.org/x/term, golang.org/x/text.

📚 Docs & DX

  • Developer site documentation is now prominently referenced in the main README (#469).
  • AGENTS.md updated with flag-binding patterns for contributors (#448).
  • Fixed incorrect -o flag usage in patch command examples (#440).
  • Fixed the deck integration example (#441).

🔗 Commit References

Features

  • a4aafe1 Add make mod target for dependency management (#422)
  • 386b0c4 Add kongctl patch file command (#436)
  • e2e2b72 Feat: Broadens support for --jq filters on get & list commands (#444)
  • 2747d7c Feat: Improves logging for API request/response data (#457)
  • 4218155 feat(view): add real-time theme cycling in TUI to improve terminal compatibility (#449)
  • 91b88f0 Feat: Event Gateway Listeners (#365)
  • a1e7911 Feat: Adding kongctl listen feature (#435)
  • 0af8d47 Add kongctl lint command (#443)
  • af4dc24 Feat: Adds kongctl delete -f support enabling broad resource cleanup from declarative inputs (#463)
  • 654acb4 Feat: Improving kongctl release workflow (#472)

Fixes

  • fd7ee37 Fix: Quick fix to the deck integration example (#441)
  • fa60691 fix(deps): update module github.com/charmbracelet/bubbles to v1 (#453)
  • 81d18b2 fix(deps): update module golang.org/x/term to v0.40.0 (#459)
  • 9ef5b9b fix(deps): update module golang.org/x/text to v0.34.0 (#460)
  • 4ddff53 fix: jq filter returns null for empty array responses (#461)
  • 905d06b fix: reject -o/--output flag in plan command, fix misleading examples, and update e2e scenarios (#450)
  • e788b01 Fix: Linter error on tail stream and fix for Makefile to match CI (#471)

Other Changes

  • 3fe2bfc Configure weekly repo status to categorize discussions as Announcements (#426)
  • 923f96f chore(deps): pin dependencies (#437)
  • 0031161 Refactor tableview: reduce duplication, simplify control flow, optimize sorting (#434)
  • daa6e3a Refactor verb switch statements to eliminate exhaustive matching overhead (#439)
  • f278f1e refactor: introducing base resource and generic methods to reduce boilerplate code (#411)
  • a2c29a0 refactor: introduced registry pattern for resources (#414)
  • 0dbef34 Upgrade go version and golangci lint (#446)
  • 4f6f559 refactor: Cleanup some command configurations (#447)
  • b83a882 docs: Document flag binding pattern in AGENTS.md (#448)
  • 30c6c75 cmd: reject positional args on plan/diff/sync with actionable error (#451)
  • f854673 refactor: simplify ShouldUseColor by merging duplicate cases (#458)
  • a355706 cmd: simplify sync command context setup for consistency with plan/diff (#466)
  • ca8b56f Docs: Mention developer site documentation in main README (#469)
  • 2078389 Task: Optimizes declarative Konnect API utilization (#464)

For full details, review the generated changelog entries below.

Full Changelog: v0.4.2...v0.5.0

Generated by Release

Assets 9
Loading