Skip to content

4.5 release notes #2077

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.

Sign up for GitHub

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

Merged
merged 8 commits into from
Oct 5, 2023
Merged

4.5 release notes #2077

Show file tree
Hide file tree
Changes from 5 commits
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
43e3805
docs: release notes for 4.5
csviri Oct 4, 2023
162a2d0
format
csviri Oct 4, 2023
87c1801
wording
csviri Oct 4, 2023
da2ee06
more wording
csviri Oct 4, 2023
d7bc34e
wording
csviri Oct 4, 2023
22d5501
docs: rewording
metacosm Oct 5, 2023
9470f0e
improvements
csviri Oct 5, 2023
46e6ce3
docs: rewording
metacosm Oct 5, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 3 additions & 1 deletion docs/_data/sidebar.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -30,4 +30,6 @@
- title: Migrating from v4.2 to v4.3
url: /docs/v4-3-migration
- title: Migrating from v4.3 to v4.4
url: /docs/v4-4-migration
url: /docs/v4-4-migration
- title: Migrating from v4.4 to v4.5
url: /docs/v4-5-migration
26 changes: 26 additions & 0 deletions docs/documentation/v4-5-migration.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
---
title: Migrating from v4.4 to v4.5
description: Migrating from v4.4 to v4.5
layout: docs
permalink: /docs/v4-5-migration
---

# Migrating from v4.4 to v4.5

Version 4.5 introduces improvements related to event handling for Dependent Resources, more precisely the
[caching and event handling](https://javaoperatorsdk.io/docs/dependent-resources#caching-and-event-handling-in-kubernetesdependentresource)
features. As a result the kubernetes resources managed using the
[KubernetesDependentResource](https://github.com/java-operator-sdk/java-operator-sdk/blob/73b1d8db926a24502c3a70da34f6bcac4f66b4eb/operator-framework-core/src/main/java/io/javaoperatorsdk/operator/processing/event/source/informer/InformerEventSource.java#L72-L72)
or subclasses, will add an annotation to the resource containing the resource version during and update or create.
This can be turned off by feature a
[feature flag](https://github.com/java-operator-sdk/java-operator-sdk/blob/73b1d8db926a24502c3a70da34f6bcac4f66b4eb/operator-framework-core/src/main/java/io/javaoperatorsdk/operator/api/config/ConfigurationService.java#L375-L375)
if causes some issues in your use case.

This functionality by default - in order to cover some corner cases - will also parse resource version.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Which corner cases? It would be useful to add them here so that people can decide whether they need the feature or not.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

described the situation

While resource version in metadata of a Kubernetes resource should be considered as a string, it is consistently
a monotonically increasing decimal number in the background.
While this against of recommendations in Kubernetes helps to cover some corner cases.
If in some rare circumstances or some special usages
of Kubernetes this would cause a problem, it can be turned off by the
[following feature flag](https://github.com/java-operator-sdk/java-operator-sdk/blob/73b1d8db926a24502c3a70da34f6bcac4f66b4eb/operator-framework-core/src/main/java/io/javaoperatorsdk/operator/api/config/ConfigurationService.java#L390-L390).