22.0.1

Hotfix release (version 22.0.1) for #1833 issue

Default timeout vs the Quality of Service feature

Special thanks to Alvin Huang!

About

The bug is related to the Quality of Service feature (aka QoS) and the HttpClient.Timeout property.

• If JSON QoSOptions section is defined in the route config, then the bug is masked rather than active, and the timeout value is assigned from the QoS TimeoutValue property.
• If the QoSOptions section is not defined in the route config or the TimeoutValue property is missing, then the bug is active and affects downstream requests that never time out.

Breaking Change

• The old zero value has recovered in the FileQoSOptions class. Make sure your custom code proper usage of the Ocelot.Configuration.DownstreamRoute class QosOptions.TimeoutValue property!

Technical info

In version 22.0, the bug was found in the explicit default constructor of the FileQoSOptions class with a maximum TimeoutValue. Previously, the default constructor was implicit with the default assignment of zero 0 to all int properties.

The new explicit default constructor breaks the old implementation of QoS TimeoutValue logic, as our QoS documentation states:


Finally, the "default 90 second" logic for HttpClient breaks down when there are no QoS options and all requests on those routes are infinite, if, for example, downstream services are down or stuck.

The Bug Artifacts

• Reported bug: 1833 by @huanguolin
• Hotfix PR: 1834 by @huanguolin

Starring ⭐ aka Release Influencers

⭐ Alvin Huang, @huanguolin
⭐ Raman Maksimchuk, @raman-m

Features in Release 22.0.1

Logbook

• _{37265ad by Raman Maksimchuk on Friday, December 08 at 11:46 →}
  Release 22.0.1
• _{ab79b01 by Alvin Huang on Friday, December 08 at 03:59 →}
  #1833 Default timeout(90s) of downstream requests is broken (#1834)

21.0.0

Upgrade to .NET 8 (version 21.0.0) aka .NET 8 release

Read article: Announcing .NET 8 by Gaurav Seth, on November 14th, 2023
Read the Docs: Ocelot 21.0

About

We are pleased to announce to you that we can now offer the support of .NET 8.
But that is not all, in this release, we are adopting support of several versions of the .NET framework through multitargeting.
The Ocelot distribution is now compatible with .NET 6, 7 and 8. 🎉

In the future, we will try to ensure the support of the .NET SDKs that are still actively maintained by the .NET team and community. Current .NET versions in support are the following: 6, 7, 8.

Technical info

As an ASP.NET Core app, now Ocelot targets net6.0, net7.0 and net8.0 frameworks. Starting with v21.0.0, the solution's code base supports Multitargeting as SDK-style projects. Find out more here: Target frameworks in SDK-style projects.

It should be easier for teams to move between (migrate to) .NET 6, 7 and 8 frameworks. Also, new features will be available for all .NET SDKs which we support via multitargeting.

Honoring 🏅 aka Top Contributors 👏

1^st 🥇 goes to Guillaume Gnaegi for delivering 1 feature in 63 files changed
2^nd 🥈 goes to Raman Maksimchuk for delivering 1 feature in 17 files changed
3^rd 🥉 goes to @raman-m for delivering 1 feature in 5 files changed

Starring ⭐ aka Release Influencers

⭐ Guillaume Gnaegi, @ggnaegi
⭐ Raman Maksimchuk, @raman-m

Features in Release 21.0.0

Logbook

• _{50ff768 by raman-m on Monday, November 20 at 23:43 →}
  +semver: breaking | Release 21.0
• _{7d93623 by Raman Maksimchuk on Monday, November 20 at 23:02 →}
  .NET8 Release artifacts (#1792)
• _{24b507e by Guillaume Gnaegi on Monday, November 20 at 00:41 →}
  #1787 Upgrade to .NET 8 (#1789)

20.0.1

Documentation release 20.0.1 for Polish Apple, v20.0

Read the Docs: Ocelot 20.0

Special thanks to @ggnaegi!

Starring ⭐ aka Release Influencers

⭐ Guillaume Gnaegi, @ggnaegi
⭐ Raman Maksimchuk, @raman-m

Features in Release 20.0.1

Logbook

• _{f5d94c9 by @raman-m on Friday, October 27 at 15:08 →}
  Prepare for the 20.0.1 release
• _{640b005 by Raman Maksimchuk on Thursday, October 26 at 14:07 →}
  #1731 Docs for 20.0 release (#1754)
• _{0a05369 by Guillaume Gnaegi on Sunday, October 15 at 22:09 →}
  #1731 Read the Docs configuration file v2 (#1733)

20.0.0

September 2023 (version 20.0.0) aka Polish Apple release

Codenamed as Polish Apple
Read the Docs: Ocelot 20.0

Honoring 🏅 aka Top Contributors 👏

1^st 🥇 goes to Raman Maksimchuk for delivering 5 features
2^nd 🥈 goes to @jlukawska for delivering 3 features
3^rd 🥉 goes to Guillaume Gnaegi for delivering 2 features

Starring ⭐ aka Release Influencers

⭐⭐⭐⭐⭐ Raman Maksimchuk, @raman-m
⭐⭐⭐ @jlukawska
⭐⭐ Guillaume Gnaegi, @ggnaegi
⭐ Anthony Steele, @AnthonySteele
⭐ Ben Bartholomew, @ben-bartholomew
⭐ @DanHarltey
⭐ Fabrizio Mancin, @Fabman08
⭐ Freddy, @fku-
⭐ Kevin Grossmann, @grssmnn
⭐ Marco, @eddex
⭐ Roman, @ArtRoman
⭐ Thiago Loureiro, @thiagoloureiro
⭐ Vijay Karavadra, @vijay-karavadra
⭐ guoyongchang, @guoyongchang
⭐ leonluc-dev, @leonluc-dev
⭐ zhangq, @zqlovejyc

Features in Release 20.0.0

Logbook

• _{65be4b6 by raman-m on Friday, October 06 at 20:52 →}
  Fix Git command placeholder bug
• _{d2f76ae by raman-m on Friday, October 06 at 19:44 →}
  +semver: breaking | Polish Apple release | 2nd build
• _{adac0a2 by raman-m on Friday, October 06 at 10:20 →}
  Polish Apple release
• _{fcdd274 by Raman Maksimchuk on Friday, October 06 at 09:07 →}
  A brand new Release Notes feature for Releases being made by 'build.cake' script (#1716)
• _{e5f31ef by Raman Maksimchuk on Monday, October 02 at 19:17 →}
  Follow up #1670: Fix StyleCop issues and improve the code (#1711)
• _{e950cf2 by Ben Bartholomew on Saturday, September 30 at 14:50 →}
  #653 Adding null check for downstreamResponse (#1334)
• _{5a81cce by Freddy on Saturday, September 30 at 19:34 →}
  Second parameter of Substring is wrong in HeaderFindAndReplaceCreator (#1424)
• _{5dbbbef by Fabrizio Mancin on Saturday, September 30 at 16:26 →}
  #1400 Manage multiple patterns for allowed/blocked IPs via Security Options config section (#1399)
• _{cc0b9b8 by Kevin Grossmann on Friday, September 29 at 20:42 →}
  Ignore port when using UpstreamHost option (#1505)
• _{f8eb5e1 by Guillaume Gnaegi on Friday, September 29 at 19:44 →}
  #1634 #1487 #1329 #1304 #1294 #793 Consul polling of services: enhancements and fix errors (#1670)
• _{ab29442 by Roman on Friday, September 29 at 11:27 →}
  #1509 #1683 Replace non-WS protocols for the 'ClientWebSocket' in WebSocketsProxyMiddleware (#1689)
• _{190b001 by leonluc-dev on Thursday, September 28 at 18:14 →}
  #1225 Update ServiceDiscovery documentation and samples to include Custom Providers (#1656)
• _{fa179bf by zhangq on Thursday, September 28 at 23:04 →}
  #1375 #1237 #925 #920 Fix DownstreamRoute DangerousAcceptAnyServerCertificateValidator (#1377)
• _{5fd5bf9 by Raman Maksimchuk on Monday, September 25 at 18:00 →}
  #1681 'using' statements life hacks (#1682)
• _{8b89257 by Raman Maksimchuk on Monday, September 25 at 16:54 →}
  #1700 Add sequential tests with disabled parallelization (#1705)
• _{fdad15d by Guillaume Gnaegi on Monday, September 25 at 14:15 →}
  #1700 Create custom Ocelot config file when instantiating steps during parallel execution (#1703)
• _{75cd0b3 by Raman Maksimchuk on Monday, September 25 at 10:51 →}
  #1677 #1686 United documentation update (#1678)
• _{b7976fc by guoyongchang on Saturday, September 23 at 09:30 →}
  #1351 #1510 New AddOcelot extensions to support custom ASP.NET MVC pipeline building via the IMvcCoreBuilder interface (#1655)
• _{4d245ec by Vijay Karavadra on Saturday, September 23 at 19:19 →}
  #1228 #1235 #1247 Overloaded AddOcelot method for dynamic FileConfiguration construction (#1569)
• _{5ad807d by jlukawska on Saturday, September 23 at 11:12 →}
  #893 Problems to cancel a request (CancellationToken) (#1367)
• _{b27761f by jlukawska on Saturday, September 23 at 10:43 →}
  #1057 #1068 Add service discovery logs (#1366)
• _{ec85b13 by jlukawska on Friday, September 22 at 21:39 →}
  #1288 Query string char missing (#1335)
• _{8893f04 by Marco on Friday, September 22 at 21:25 →}
  fix: minor grammar fix in default rate limit response message (#1639)
• _{e6081ce by Thiago Loureiro on Friday, September 22 at 21:15 →}
  Fixed logger message typos in the OutputCacheMiddleware class (#1315)
• _{21bc4a4 by DanHarltey on Friday, September 22 at 20:05 →}
  #908 Quality of Service - Configuration (#1279)
• _{455d7d3 by Anthony Steele on Friday, September 22 at 19:45 →}
  Exception mapper naming (#1211)

19.0.3

Read the Docs: Ocelot 19.0

ebe70fd - Raman Maksimchuk - Merge pull request #1695 from ThreeMammals/develop
a90664b - Raman Maksimchuk - Release features #1499 #1663 (#1660) (#1693)
346df03 - Tom Pallister - Update README.md
433dfca - Justin Middler - fixed up required spacing in README (#1499)
6ca54fe - Raman Maksimchuk - #1660 Huge logs because of StyleCop.Analyzers warnings (#1663)
bc25f4e - TomPallister - push code coverage for main and develop branches

19.0.2

fdc761c - TomPallister - updated docs
3bd0f8d - Tom Pallister - updated report generator (#1648)

19.0.1

b9cc313 - TomPallister - updated nuget package icon url

19.0.0

Read the Docs: Ocelot 19.0

46b12a2 - TomPallister - updated cake syntax
4db816a - TomPallister - updated Cake.Coveralls
dec610d - TomPallister - updated csmacnz.Coveralls
66d09e3 - TomPallister - updated csmacnz.Coveralls
b2ec165 - TomPallister - updated eddiewebb/[email protected]
312f1c6 - Tom Pallister - tests passing on debian 10 (#1647)
07263be - TomPallister - Merge branch 'RaynaldM-upgrade-to-net7' into develop
8920836 - TomPallister - +semver: major updated build
c444c25 - Ray - last packages update
4afdea3 - Ray - code cleaning
96a3fd8 - Ray - First step

18.0.0

Read the Docs: Ocelot 18.0

36ad6e1 - TGP - use the DotNetNuGet cake code
b6b789c - TGP - add nuget to cake as a tool
565968a - TGP - use xplat nuget package for cake
822a0b0 - TGP - add nuget tool for publish to cake script
f1db025 - TGP - install net5.0 in correct place in container
c07e6ee - TGP - use new base image for build & release
69bd9a8 - TGP - fix test and use latest coveralls tool
52555fc - Tom Pallister - switch to main for default branch (#1559)
e5ee57b - Tom Pallister - Feat/net6.0 upgrade (#1558)

17.0.1

Read the Docs: Ocelot 17.0

3dcc6b6 - TGP - Merge branch 'feat/fix-build' into develop
ba4b767 - TGP - use new deletedir api
47a024b - TGP - fix cake.json version
096f94d - TGP - update nuget packages to reference ocelot logo from GitHub
ff6f6e3 - TGP - update nuget packages to reference ocelot logo from GitHub
77c6c30 - TGP - add ocelot logo to repo
3ef6abd - TomPallister - +semver: breaking bump to version 17.0.0
b46feda - TomPallister - rename authorisation to authorization
b2dd70f - TomPallister - release process note
ede71c4 - TomPallister - updated release process
ab3533b - TomPallister - bring back develop
f62ed72 - TomPallister - all packages upgraded and tests passing
17b0555 - TomPallister - tests passing
3255162 - TomPallister - wip tests failing
6eed692 - TomPallister - more package updates
ebf8532 - TomPallister - removed rafty and updated more packages
b356539 - TomPallister - update nuget packages and graphql example
fdad2bb - TomPallister - update circle build image
9bc5ad1 - TomPallister - dont need this
a39b5fd - TomPallister - dont need .config
bdefa2d - TomPallister - dont need .config
03c8cd6 - TomPallister - works on linux
de0f4f9 - TomPallister - build finally working....MAGIC
94ce022 - TomPallister - wip
3a8d55f - TomPallister - Merge branch 'feat/net5upgrade' of github.com:ThreeMammals/Ocelot into feat/net5upgrade
6e1dc3f - TomPallister - wip
f413102 - TomPallister - wip
7e2b312 - TomPallister - Merge branch 'feat/net5upgrade' of github.com:ThreeMammals/Ocelot into feat/net5upgrade
730c940 - TomPallister - wip
ef69429 - TomPallister - mono complete
71a1053 - TomPallister - build works on windows
a5a1606 - TomPallister - upgrade dotnet test and coverages packages
1185576 - TomPallister - wip
0fab351 - TomPallister - move to dotnet tools for cake
4b23e0c - TomPallister - line endings
f16cdd8 - TomPallister - fix tests and line endings
c1776fb - TomPallister - fix warnings
7f49bf5 - TomPallister - wip
a9eec31 - TomPallister - fix code broken after net5.0 upgrade
1c6bfc3 - TomPallister - add make and build tools to image
7254d4d - TomPallister - +semver: breaking upgrade base build image to net5.0
708b575 - TomPallister - upgrade csproj to net5.0