Skip to content

[DX-1942] Gateway Release Notes 5.8.1 #6288

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 12 commits into
base: master
Choose a base branch
from
97 changes: 97 additions & 0 deletions tyk-docs/content/developer-support/release-notes/gateway.md
Original file line number Diff line number Diff line change
@@ -44,6 +44,103 @@ Our minor releases are supported until our next minor comes out.
---
## 5.8 Release Notes

### 5.8.1 Release Notes

#### Release Date 9 May 2025

#### Release Highlights

This patch release contains various bug fixes. For a comprehensive list of changes, please refer to the detailed [changelog]({{< ref "#Changelog-v5.8.1" >}}) below.

#### Breaking Changes

There are no breaking changes in this release.

#### Dependencies {#dependencies-5.8.1}

##### Compatibility Matrix For Tyk Components

| Gateway Version | Recommended Releases | Backwards Compatibility |
|---- |---- |---- |
| 5.8.1 | MDCB v2.8.1 | MDCB v2.8.1 |
| | Operator v1.2.0 | Operator v0.17 |
| | Sync v2.1.0 | Sync v2.1.0 |
| | Helm Chart v3.0 | Helm all versions |
| | EDP v1.13 | EDP all versions |
| | Pump v1.12.0 | Pump all versions |
| | TIB (if using standalone) v1.7.0 | TIB all versions |

##### 3rd Party Dependencies & Tools

| Third Party Dependency | Tested Versions | Compatible Versions | Comments |
| ------------------------------------------------------------ | ---------------------- | ---------------------- | -------- |
| [Go](https://go.dev/dl/) | 1.23 | 1.23 | [Go plugins]({{< ref "api-management/plugins/golang" >}}) must be built using Go 1.23 |
| [Redis](https://redis.io/download/) | 6.2.x, 7.x | 6.2.x, 7.x | Used by Tyk Gateway |
| [OpenAPI Specification](https://spec.openapis.org/oas/v3.0.3)| v3.0.x | v3.0.x | Supported by [Tyk OAS]({{< ref "api-management/gateway-config-tyk-oas" >}}) |

Given the potential time difference between your upgrade and the release of this version, we recommend users verify the ongoing support of third-party dependencies they install, as their status may have changed since the release.

#### Deprecations

There are no deprecations in this release.

#### Upgrade instructions {#upgrade-5.8.1}

If you are upgrading to 5.8.1, please follow the detailed [upgrade instructions](#upgrading-tyk).

#### Downloads

- [Docker image to pull](https://hub.docker.com/r/tykio/tyk-gateway/tags?page=&page_size=&ordering=&name=v5.8.1)
- ```bash
docker pull tykio/tyk-gateway:v5.8.1
```
- Helm charts
- [tyk-charts v3.0.0]({{<ref "developer-support/release-notes/helm-chart#300-release-notes" >}})

- [Source code tarball for OSS projects](https://github.com/TykTechnologies/tyk/releases)

#### Changelog {#Changelog-v5.8.1}

##### Fixed

<ul>
<li>
<details>
<summary>Fixed Inconsistent Context Behavior in UDG APIs</summary>

Addressed an issue for UDG APIs where caching led to the forwarding of stale values for headers that contained content variables towards the upstream of the UDG apis.
</details>
</li>
<li>
<details>
<summary>Improved Route Matching Logic for API Requests</summary>

Resolved an issue where requests could be routed incorrectly due to inverted prioritisation of dynamically declared paths over those with similar static paths. Now, statically declared paths take priority in the path matching algorithm, so if API1 has listen path `/path/{param}/endpoint` and API2 has listen path `/path/specific/endpoint` a request to `/path/specific/endpoint/resource` will be correctly routed to API2.
</details>
</li>
<li>
<details>
<summary>Resolved Issue With Default Enforced Request Timeout</summary>

Fixed an issue where an [enforced timeout]({{< ref "tyk-self-managed#enforced-timeouts" >}}) set for a specific API endpoint could be overruled by the configured [proxy_default_timeout]({{< ref "tyk-oss-gateway/configuration#proxy_default_timeout" >}}). Now if an endpoint-level timeout is set then this will be honoured, regardless of any default timeout that is configured.
</details>
</li>
<li>
<details>
<summary>Fixed Issue With Tyk Self-Managed Gateways Claiming Licenses</summary>

Resolved a race condition in self-managed deployments which occasionally lead to fewer Gateways registering with the Dashboard than the number that had been licensed. Now Tyk Self-Managed deployments will allow the licensed number of Gateways to register and serve traffic.
</details>
</li>
<li>
<details>
<summary>Resolved merging issue in field-based policy permissions</summary>

Resolved a bug where `allowed_types` from multiple policies were incorrectly merged using intersection logic. Policies now correctly merge fields to allow access to any fields listed across the applied policies.
</details>
</li>
</ul>

### 5.8.0 Release Notes

#### Release Date 28 March 2025
7 changes: 6 additions & 1 deletion tyk-docs/data/releases/gateway.json
Original file line number Diff line number Diff line change
@@ -1,9 +1,14 @@
{
"home": "tyk-oss-gateway",
"licensed": false,
"latest": "5.8.0",
"latest": "5.8.1",
"lts": "5.3.10",
"releaseNotesPath": "developer-support/release-notes/gateway",
"5.8.1": {
"date": "09/05/2025",
"tag": "https://github.com/TykTechnologies/tyk/releases/tag/v5.8.1",
"docker": "https://hub.docker.com/r/tykio/tyk-gateway/tags?page=1&name=v5.8.1"
},
"5.8.0": {
"date": "28/03/2025",
"tag": "https://github.com/TykTechnologies/tyk/releases/tag/v5.8.0",