v1.1.2

Changelog

• d61e2e2 Add samples to every extension for easier reference (#534)
• f8deace openapi-path: Disable authentication for route (#538)
• 67668b7 add link to basic auth guide (#532)
• a334dbb getting unique cluster id from kube-system (#541)
• 1a60989 turn off analytics when deploying with kustomize, the default for development (#542)

v1.1.1

Changelog

• 8b6095f Add -ldflags '-s -w' to go build commands to strip DWARF, symbol table and debug info from manager binary (#511)
• bd3db7f Analytics: Set TelemetryToken not Telemetry_Token in Makefile (#509)
• de4ff6c Change mocking.enabled value from true to false (#510)
• f87ac35 Maintain hostname when requesting from upstream host (#507)
• 2ec1620 README.md: Anchors should be using kubeshop/kusk-gateway for releases not kubeshop/testkube (#506)
• 57a8363 internal/controllers/parser.go: Fix auth bug, missing fallthrough (#525)
• c23c7ff add links to caching and rate limit guides (#505)
• d190976 remove references to GOPROXY (#512)

v1.1.0

Summary

The Kusk team is proud to announce the v1.1.0 release of Kusk Gateway, which adds Header Based Authentication, Rate limiting, Caching, Post-processed OpenAPI definitions (that is with the potentially sensitive x-kusk settings stripped out).

What's New?

Since the last beta release we have been focusing on making the core of Kusk Gateway production ready - but have also managed to squeeze in some new functionality.

Header Based Authentication

Through x-kusk extensions you can now specify a service or host to validate authentication headers. This can be used for any headers based authentication, including common authentication schemes like basic authentication and API key headers.

x-kusk:
  auth:
    scheme: basic
    path_prefix: /login # optional
    auth-upstream:
      host:
        hostname: example.com
        port: 80

Read more about Header based authentication

Rate Limiting

Kusk Gateway makes it easy to apply rate limiting policies to your API. These can be specified globally or at the path or operation level.

x-kusk:
  rate_limit:
    requests_per_unit: 2
    unit: minute
...

Read more about rate limiting extensions.

Caching

Caches are one way to reduce latency and network traffic, as the response is directly returned from the gateway. Kusk Gateway can implement all the complexity of an HTTP cache with a simple annotation in your OpenAPI spec. These policies can be applied at the global, path, or operation levels.

x-kusk:
  cache:
    enabled: true
    max_age: 60
...

Read more about caching extensions.

Improved Mocking

Kusk Gateway now handles mocking natively in Envoy. This removes the need to install the separate agent process which used to run alongside the manager to handle serving mocked responses.

Read more about mocking

Upgradability

You can now upgrade your Kusk Gateway distribution directly from the Kusk CLI.

kusk upgrade

Grab the latest version of the Kusk CLI here

Changelog

• c0acfd4 Refactor Mocking without the agent process (#438)
• c13a966 added namespaces to kusk-gateway-envoyfleet-manager-role (#443)
• c8074cb adding mocked 'postprocessed' apidef (#468)
• fafd974 check for presence of ANALYTICS ENABLED env var. if empty assume enabled by default (#481)
• c762915 e2e tests/smoketests: Add Caching smoketests (#482)
• fb3a501 e2e tests/smoketests: Add rate limiting smoketests - Closes #471
• fd95fe4 fix autodeploy extension link (#463)
• 960daa7 fix cache bug (#447)
• 806a966 fix extension link (#465)
• fce2b15 fix up extension header style (#458)
• 4f40f24 fix: docs/Dockerfile to reduce vulnerabilities (#457)
• e994778 minor fix for the docker image (#441)
• 1105e0f reverted to GA4 (#413)
• bab3c9b reverted to segmentio (#479)
• 85c3cca updates to running smoke tests (#480)

v1.1.0-rc1

Changelog

• 18a5d02 Auth smoketests (#469)
• 42e0b90 Fix/Cleanup Makefile - Closes #418 (#419)
• 1766461 Fix: x-kusk.openapi-path (#470)
• c0acfd4 Refactor Mocking without the agent process (#438)
• b08de87 Revert "e2e tests/smoketests: Add rate limiting smoketests - Closes #471"
• d107fd2 Smoke Tests CI Pipeline (#483)
• 0729bda Smoketests (#454)
• 3f44f4c Telemetry data (#430)
• 73a3fa1 .github/CODEOWNERS: Add default reviewers (#455)
• a928352 smoketests/basic_auth: Wait for ext-authz-http-service deployment to be ready and sleep an additional 6 seconds (#484)
• c1793d9 add cache configuration (#445)
• 71d8a6c add cache doc (#448)
• ca38e8d add guide for caching (#466)
• 8f5e510 add rate limiting guide (#459)
• c13a966 added namespaces to kusk-gateway-envoyfleet-manager-role (#443)
• c8074cb adding mocked 'postprocessed' apidef (#468)
• fafd974 check for presence of ANALYTICS ENABLED env var. if empty assume enabled by default (#481)
• c762915 e2e tests/smoketests: Add Caching smoketests (#482)
• fb3a501 e2e tests/smoketests: Add rate limiting smoketests - Closes #471
• 20bd4e4 e2e tests/smoketests: Add rate limiting smoketests - Closes #471 (#472)
• fd95fe4 fix autodeploy extension link (#463)
• 80fc782 fix autodeploy extension link (#464)
• 960daa7 fix cache bug (#447)
• 806a966 fix extension link (#465)
• fce2b15 fix up extension header style (#458)
• 4f40f24 fix: docs/Dockerfile to reduce vulnerabilities (#457)
• e994778 minor fix for the docker image (#441)
• 1105e0f reverted to GA4 (#413)
• bab3c9b reverted to segmentio (#479)
• 85c3cca updates to running smoke tests (#480)

v1.0.1

Changelog

• 582b38e Docs update from running through setup (#387)
• 6434040 Fix: Agent killed when API applied with no mocking or upstream defined (#411)
• c59e11f Dockerfiles: Remove cache mount-type (#388)
• d08f883 add docs on rate_limit (#396)
• 0adb1e1 add kusk dashboard command to documentation (#382)
• dd76a04 add ratelimiting (#395)
• d04a744 bump python image version for docs to resolve synk report of vulnerable image (#369)
• 5631d7f fix mocking with multiple examples (#376)
• 0b985a8 update testing manifests (#377)

v1.0.0

Changelog

• 8c6af1b Add build args (#336)
• c3fc30b Document envoyfleet flags in kusk cli (#335)
• c7393cd Finish Getting Started section with "Connect a Service to the API" (#329)
• 6fdda72 Fix errors in x-kusk reference (#331)
• dd0a2a7 Fix list display (#333)
• c6eb6d9 Rework documentation #269 #320 (#327)
• 28d3834 Telemetry (#338)
• 3b77b8f Update CONTRIBUTING.md (#365)
• 5bec925 Update README.md (#363)
• bd1b4bc Update installation guides and README.md #321 (#351)
• 5fb7665 Updated welcome for docs (#361)
• 62f75e8 add 2022 MIT license to all go files (#340)
• 5b82dd9 add kusk cli documentation (#330)
• c18abcc add mock config test (#360)
• c3f7816 added Google Analytics v4 (#326)
• 5bb3d20 fix broken readme links (#349)
• 1d63746 improve development docs (#339)
• 66ce1d6 minor fix to GH actions (#367)
• 695ec42 removed namespacedname from telemetry (#346)

v1.0.0-beta4

Changelog

• fd41b83 Add quickstart section (#302)
• 8e00d5c docs fix (#300)
• 3d1fca4 move Options package into pkg directory so it can be used by other go modules. Currently kusk (previously kgw cli) needs access to the options (#309)

v1.0.0-beta3

Changelog

• 1c6c70d Added convenience make command 'run-docs' (#291)
• 7cb6167 Re-write installation guide (#285)
• 2fc69ad Refactor service reconciler to handle the annotations (#294)
• dcacc11 Remove kgw-envoy prefix (#289)

v1.0.0-beta2

Changelog

• 6d404a4 Configure Manager with ConfigMap (#276)
• 5094ab2 KGW CLI doc (#275)
• 9b55a67 Service annotation reconciler (#277)

v0.0.0-alpha.2.1.4

Changelog

• 1099b3a Fix local development webhook service name (#242)
• edf1adf Removed CertManager dependency, added local certs generation for the webhook server (#244)
• 78029bc Speed Up local development (#245)