Skip to content

Latest commit

 

History

History
29 lines (15 loc) · 2.25 KB

Update_v0_24_0.md

File metadata and controls

29 lines (15 loc) · 2.25 KB

FusionCache logo

🆙 Update to v0.24.0

With the v0.24.0 release, the feature known as Backplane Auto-Recovery has become, simply, Auto-Recovery.

To do all of this I basically rewrote the entire part that handles distributed operations, meaning the handling of distributed cache operations and backplane operations so that they now work together in a more harmonious way, allowing the interaction between the two parts to be more in unison.

So, a couple of breaking changes were needed: in a lot of scenarios this will not affect an update to this new version, but it's better to know what will happen.

⚠ Breaking Change

First thing: if your app or service does not use the distributed cache or the backplane, the update will be totally seamless.

If instead you are using them, you need to know that the internal structure of the cache entries for the distributed cache is slightly changed: because of this the so called internal "wire format cache key modifier" that is used when pre-processing the cache key for the distributed cache, via prefix/suffix, had to be changed. The same thing is true for the backplane, where a wire format modifier is used to build the channel name.

To read more about "Wire Format Versioning" there are chapters in the respective docs for the distributed cache and for the backplane.

Moral of the story: when updating to v0.24.0 the suggestion is to update all the apps and services that use same distributed cache.

The other main thing is that, as said, the auto-recovery feature changed from being "Backplane Auto-Recovery" to just "Auto-Recovery": this means that existing options like EnableBackplaneAutoRecovery is now simply EnableAutoRecovery, BackplaneAutoRecoveryMaxItems is now simply AutoRecoveryMaxItems and so on.

Don't worry though, all the old ones are still there, they still works as before (by acting as an adapter from/to the new ones) and are marked with the [Obsolete] attribute with useful instructions on what to do.

Basically after you update just recompile your project, look for a couple of warnings, change the property names and... that's it, very easy.