.. _Polly: https://github.com/App-vNext/Polly .. _@ebjornset: https://github.com/ebjornset .. _@RaynaldM: https://github.com/RaynaldM .. _@ArwynFr: https://github.com/ArwynFr .. _@AlyHKafoury: https://github.com/AlyHKafoury .. _@FelixBoers: https://github.com/FelixBoers .. _23.2: https://github.com/ThreeMammals/Ocelot/releases/tag/23.2.0 Welcome to Ocelot `23.2`_ ====================================================================================== Thanks for taking a look at the Ocelot documentation! Please use the left hand navigation to get around. The team would suggest taking a look at the **Introduction** chapter first. All **Features** are arranged in alphabetical order. The main features are :doc:`../features/configuration` and :doc:`../features/routing`. We **do** follow development process which is described in :doc:`../building/releaseprocess`. Release Notes ------------- | **Release Tag**: `23.2.0 `_ | **Release Codename**: `Lunar Eclipse `_ What's new? ^^^^^^^^^^^ - :doc:`../features/configuration`: A brand new :ref:`config-merging-tomemory` by `@ebjornset`_ as a part of the :ref:`config-merging-files` feature. The ``AddOcelot`` method merges the **ocelot.*.json** files into a single **ocelot.json** file as the primary configuration file, which is written back to disk and then added to the ``IConfigurationBuilder`` for the well-known ``IConfiguration``. You can now call another ``AddOcelot`` method that adds the merged JSON directly from memory to the ``IConfigurationBuilder``, using ``AddJsonStream`` instead. See more details in :ref:`di-configuration-overview` of :doc:`../features/dependencyinjection`. - :doc:`../features/servicefabric`: Published old undocumented :ref:`sf-placeholders` feature of :doc:`../features/servicefabric` `service discovery provider `_. This feature by `@FelixBoers`_ is available starting from version `13.0.0 `_. - :doc:`../features/qualityofservice`: A brand new `Polly`_ v8 pipelines :ref:`qos-extensibility` feature by `@RaynaldM`_ Focus On ^^^^^^^^ Updates of the features """"""""""""""""""""""" - :doc:`../features/configuration`: New :ref:`config-merging-tomemory` feature by `@ebjornset`_ - :doc:`../features/dependencyinjection`: Added new overloaded :ref:`di-configuration-addocelot` by `@ebjornset`_ - :doc:`../features/qualityofservice`: Support of new `Polly`_ v8 syntax and new :ref:`qos-extensibility` feature by `@RaynaldM`_ Ocelot extra packages """"""""""""""""""""" - `Ocelot.Provider.Polly `_: Support of new `Polly`_ v8 syntax. | *Polly* `8.0+ `_ versions introduced the concept of `resilience pipelines `_. | All `AddPolly extensions `_ have been automatically migrated from **v7** to **v8**. | Please note that older **v7** extensions are marked with the ``[Obsolete]`` attribute and renamed using the ``V7`` suffix. And the old **v7** implementation has been moved to the `v7 namespace `_. | See more details in :ref:`qos-polly-v7-vs-v8` section of :doc:`../features/qualityofservice` chapter. Stabilization aka bug fixing """""""""""""""""""""""""""" - `683 `_ by PR `1927 `_. Thanks to `@AlyHKafoury`_! | `New rules `_ have been added to Ocelot's configuration validation logic to find duplicate placeholders in path templates. | See more in the `FileConfigurationFluentValidator `_ class. - `1518 `_ hotfix by PR `1986 `_. Thanks to `@ArwynFr`_! | Using the default ``IServiceCollection`` `DI extensions `_ to register Ocelot services resulted in the ``ServiceCollection`` provider being forced to be created by calling ``BuildServiceProvider()``. | This resulted in problems with dependency injection libraries, or worse, causing the Ocelot app to crash! | See more in the `ServiceCollectionExtensions `_ class. - See `all bugs `_ of the `February'24 `_ milestone Updated Documentation """"""""""""""""""""" - :doc:`../features/configuration` - :doc:`../features/dependencyinjection` - :doc:`../features/qualityofservice` - :doc:`../features/servicefabric` .. toctree:: :maxdepth: 2 :hidden: :caption: Introduction introduction/bigpicture introduction/gettingstarted introduction/contributing introduction/notsupported introduction/gotchas .. toctree:: :maxdepth: 2 :hidden: :caption: Features features/administration features/authentication features/authorization features/caching features/claimstransformation features/configuration features/delegatinghandlers features/dependencyinjection features/errorcodes features/graphql features/headerstransformation features/kubernetes features/loadbalancer features/logging features/methodtransformation features/middlewareinjection features/qualityofservice features/ratelimiting features/requestaggregation features/requestid features/routing features/servicediscovery features/servicefabric features/tracing features/websockets .. toctree:: :maxdepth: 2 :hidden: :caption: Building Ocelot building/overview building/building building/tests building/releaseprocess