Kong/kongctl v0.6.0

on GitHub

kongctl Release Highlights

✨ What's New

Enhanced Dump Filtering
Filter dump operations by resource names and IDs with the new --filter-* options, making it easier to export specific subsets of your Kong configuration:

kongctl dump --filter-name=my-api
kongctl dump --filter-id=abc-123

Field-Level Declarative Diffs
Declarative diffs now show granular field-level changes instead of whole-resource replacements, giving you precise visibility into what will actually change during an apply operation.

Docker Image Distribution
kongctl is now published as a Docker image alongside binary releases, simplifying integration into containerized workflows and CI/CD pipelines.

docker pull kong/kongctl:latest

🐛 Fixes & Improvements

Portal Sync Mode Fix
Fixed a critical bug where external portal child pages were incorrectly marked for deletion in sync mode (#541), preserving your portal content structure.

App Authentication Strategy Normalization
Resolved inconsistent configuration keys for key_auth and oidc app authentication strategies, ensuring predictable declarative config behavior (#534).

CLI Command Cleanup
Removed non-declarative subcommands from kongctl delete and removed the kongctl create verb to streamline the CLI surface toward declarative-first workflows.

Go 1.26 Modernization
Upgraded to Go 1.26 with comprehensive codebase modernization using go fix, bringing performance improvements and modern Go idioms throughout.

📚 Docs & DX

• Added comprehensive declarative configuration reference page
• Improved user-agent headers for better debugging and support interactions
• Enhanced E2E test harness with better retry logic and timeout diagnostics

🔗 Commit References

Features

• 6a1340c Feat: Event Gateway DP certificate management (#530)
• c0e6e3c Feat: Enhanced delcarative diffs to show field level changes (#526)
• 70052a7 Feat: Adds dump filter for resource names and ids (#537)
• 3023a32 Feat: Improved user-agent headers originating from kongctl (#512)
• 7622a81 Feat: Adds Docker image building to release process (#495)

Fixes

• 58d05b0 Bug: External portal child pages are marked for deletion in sync mode (#541)
• 27960ca Fix: Repaired broken goreleaser action ver
• 4cc3736 Fix: Upgraded sdk-konnect-go to v0.25.0 (#547)
• 73ffb3f Tidy: go fix run (#546)
• 4c33a3b Fix: e2e harness retry defaults and improve timeout diagnostics (#545)
• 4c8ad94 Fix: hardens some sec suggestions after GH action review (#535)
• d7e3722 Fix: normalize app auth strategy config keys for key_auth/oidc (#534)
• 16c7ebf fix(deps): update module github.com/ajg/form to v1.7.1 (#531)
• c74492c Fix: Added mode to declarative diff command (#525)
• 8c19c88 fix(deps): update module github.com/mattn/go-runewidth to v0.0.20 (#523)
• 7340f37 fix(deps): update module github.com/ajg/form to v1.7.0 (#524)
• 3bca523 Fix: remove non-declarative subcommands from kongctl delete (#517)
• 2569280 Fix: Fix workflows using improper key for reading secrets (#511)
• 367bb42 Fix: Docker permission error for kongctl user (#508)
• e315bea Fix: Transitioned to goreleaser for docker builds and publication (#504)
• e1f682b fix: use env context instead of secrets in step-level if conditions in docker-publish workflow (#503)
• fd39e92 Fix: Removed clipboard build time dependencies no longer required (#502)
• b9b878d Fix: The release process to use go 1.26 (#498)
• 1e0c55a Task: Upgrade go to 1.26.0 and go fix modernization (#479)
• 4a616ec Fix: release notes simplification
• 0083b7c Fix: release notes simplification and other workflow updates (#476)
• d6478b6 Fix: release workflow shas (#473)
• 0dc5cc6 Fix: Minor tweaks to release workflow

Other Changes

• bedd4b4 Upgrades: gh aw upgrades (#543)
• 8acc9bf Docs: Add declarative configuration reference page (#510)
• 303797d chore(deps): update github/gh-aw action to v0.46.4 (#538)
• 227e223 chore(deps): update github/gh-aw action to v0.46.2 (#536)
• 0802bed Upgrades: gh aw recompile (#529)
• 43b2d32 chore(deps): update github/gh-aw action to v0.46.0 (#521)
• c6e1917 Task: Give agents.md instructions to use standard go build dirs (#520)
• c305339 simplifier: code simplifications 2026-02-28 (#519)
• 1175a95 cmd: remove kongctl create verb from CLI (#515)
• fb50c23 chore(deps): update github/gh-aw action to v0.44.0 (#507)
• 1031430 chore(deps): update docker/setup-qemu-action action to v3.7.0 (#506)
• c6dba22 chore(deps): update docker/setup-buildx-action action to v3.12.0 (#505)
• 72db612 refactor: extract checkStdinApprovalConflict helper to eliminate triple-duplicated stdin/TTY check (#494)
• ecb087f chore(deps): update docker/metadata-action action to v5.10.0 (#501)
• 0b76583 chore(deps): update docker/login-action action to v3.7.0 (#500)
• 06100dd Task: Recompiled agentics workflows (#499)
• 9582440 chore(deps): update docker/build-push-action action to v6.19.2 (#497)
• 049bace chore(deps): pin dependencies (#496)
• 5400fe4 chore(deps): update github/gh-aw action to v0.43.23 (#489)
• b23a26e chore(deps): update github/gh-aw action to v0.43.22 (#487)
• db687f1 chore(deps): update github/gh-aw action to v0.43.21 (#484)
• 59964ec Tidy: Remove unnecessary PR tempalte (#480)
• 7730c3e Task: code simplification consolidate duplicate patterns in lint, listen, and flag parsing (#475)
• a0aea7f chore(deps): pin github/gh-aw action to b70143d (#477)

Full Changelog: Initial release

Generated by Release