Skip to content

Backport upgrade docs for v1.19#43957

Merged
joestringer merged 5 commits intov1.19from
pr/joe/v1.19-upgrade-docs
Jan 23, 2026
Merged

Backport upgrade docs for v1.19#43957
joestringer merged 5 commits intov1.19from
pr/joe/v1.19-upgrade-docs

Conversation

@joestringer
Copy link
Copy Markdown
Member

Partial backport of #43913. I dropped the v1.20-specific changes.

Once this PR is merged, a GitHub action will update the labels of these PRs:

 43913

[ upstream commit 7508733 ]

The FromRequires / ToRequires fields were not removed, but instead the
length of these fields was restricted to length 0. This allows us to
avoid making a breaking change to the format of the resource while still
enforcing that users do not use this unsupported field. Fix the upgrade
note to conform with this behavior.

Fixes: 4fbbc8b ("policy: Reintroduce From/ToRequires but mark them as deprecated")

Signed-off-by: Joe Stringer <joe@cilium.io>
[ upstream commit ee738da ]

This commit creates some stronger structure around the upgrade notes in
the hopes of more clearly communicating to users what is changing and
when they may need to take action. The high level categories are:

* Action Required
* Informational Notes
* Changes to Features
* Changes to Metrics

Furthermore, for feature flags and metrics they are now sorted in the
following order: new, changed, deprecated, removed.

This commit doesn't modify the text of the release notes, only
rearranges the ordering.

Signed-off-by: Joe Stringer <joe@cilium.io>
[ upstream commit 5ef8dd6 ]

This commit clarifies the action required from users when interacting
with network policies during the v1.18 -> v1.19 upgrade.

Signed-off-by: Joe Stringer <joe@cilium.io>
[ upstream commit 1914ca9 ]

Clarify general wording in the upgrade notes and rearrange some of the
items for new features into the relevant docs section.

Signed-off-by: Joe Stringer <joe@cilium.io>
[ upstream commit f30efc6 ]

Per out-of-band discussion with Robin, update this release note to
clarify when there might be packet loss related to the new encryption
strict mode feature.

Three changes here:
- Drops could happen any time the feature is turned on or off
- The disruption is only known to occur during the upgrade period
- We can simplify the language to address the reader more directly.

Signed-off-by: Joe Stringer <joe@cilium.io>
@joestringer joestringer requested a review from a team as a code owner January 23, 2026 17:10
@maintainer-s-little-helper maintainer-s-little-helper bot added backport/1.19 This PR represents a backport for Cilium 1.19.x of a PR that was merged to main. kind/backports This PR provides functionality previously merged into master. labels Jan 23, 2026
@joestringer joestringer added the release-blocker/1.19 This issue will prevent the release of the next version of Cilium. label Jan 23, 2026
@joestringer
Copy link
Copy Markdown
Member Author

/test

@joestringer joestringer moved this from Proposed to Active in Release blockers Jan 23, 2026
Copy link
Copy Markdown
Member

@qmonnet qmonnet left a comment

Choose a reason for hiding this comment

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

Thanks!

@maintainer-s-little-helper maintainer-s-little-helper bot added ready-to-merge This PR has passed all tests and received consensus from code owners to merge. labels Jan 23, 2026
@joestringer joestringer added this pull request to the merge queue Jan 23, 2026
Merged via the queue into v1.19 with commit 81e0512 Jan 23, 2026
75 checks passed
@joestringer joestringer deleted the pr/joe/v1.19-upgrade-docs branch January 23, 2026 17:45
@github-project-automation github-project-automation bot moved this from Active to Done in Release blockers Jan 23, 2026
@cilium-release-bot cilium-release-bot bot moved this to Released in cilium v1.19.0 Feb 3, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

backport/1.19 This PR represents a backport for Cilium 1.19.x of a PR that was merged to main. kind/backports This PR provides functionality previously merged into master. ready-to-merge This PR has passed all tests and received consensus from code owners to merge. release-blocker/1.19 This issue will prevent the release of the next version of Cilium.

Projects

Archived in project
Status: Released

Development

Successfully merging this pull request may close these issues.

2 participants