Skip to content

docs: note Kibana 7→8 migration known issue on 3.21 and 3.22 release notes#2729

Open
tianfeng92 wants to merge 1 commit into
tigera:mainfrom
tianfeng92:kibana-7-8-migration-known-issue
Open

docs: note Kibana 7→8 migration known issue on 3.21 and 3.22 release notes#2729
tianfeng92 wants to merge 1 commit into
tigera:mainfrom
tianfeng92:kibana-7-8-migration-known-issue

Conversation

@tianfeng92
Copy link
Copy Markdown
Contributor

@tianfeng92 tianfeng92 commented May 15, 2026

Summary

  • Add an upgrade note on the 3.21.8 and 3.22.5 release sections calling out the known Kibana 7→8 saved-object migration issue when upgrading from Calico Enterprise 3.20 or earlier.
  • The fix shipped in 3.21.8 and 3.22.5 — the note is placed on those releases to direct readers to use them (or later).

Test plan

  • Verify the rendered note appears on the 3.21.8 section on the 3.21 release-notes page.
  • Verify the rendered note appears on the 3.22.5 section on the 3.22 release-notes page.

🤖 Generated with Claude Code

@tianfeng92 tianfeng92 requested a review from a team as a code owner May 15, 2026 23:47
@netlify
Copy link
Copy Markdown

netlify Bot commented May 15, 2026

Deploy Preview for calico-docs-preview-next ready!

Name Link
🔨 Latest commit 6a57482
🔍 Latest deploy log https://app.netlify.com/projects/calico-docs-preview-next/deploys/6a161c398fed9f00084f0f38
😎 Deploy Preview https://deploy-preview-2729--calico-docs-preview-next.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@netlify
Copy link
Copy Markdown

netlify Bot commented May 15, 2026

Deploy Preview succeeded!

Built without sensitive environment variables

Name Link
🔨 Latest commit 6a57482
🔍 Latest deploy log https://app.netlify.com/projects/tigera/deploys/6a161c3881e2bb0007187431
😎 Deploy Preview https://deploy-preview-2729--tigera.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 95 (🟢 up 9 from production)
Accessibility: 98 (no change from production)
Best Practices: 92 (🟢 up 9 from production)
SEO: 100 (no change from production)
PWA: -
View the detailed breakdown and full score reports

To edit notification comments on pull requests, go to your Netlify project configuration.

Comment thread calico-enterprise_versioned_docs/version-3.21-2/release-notes/index.mdx Outdated
@ctauchen
Copy link
Copy Markdown
Collaborator

@tianfeng92 Can you provide more information about this? This seems ultimately to be a bug fix statement, so I'm not sure why we need to add a special admonition.

Comment thread calico-enterprise_versioned_docs/version-3.22-2/release-notes/index.mdx Outdated
@tianfeng92
Copy link
Copy Markdown
Contributor Author

tianfeng92 commented May 22, 2026

@tianfeng92 Can you provide more information about this? This seems ultimately to be a bug fix statement, so I'm not sure why we need to add a special admonition.

@ctauchen The admonition is intentional because this is an upgrade-path hazard, not a typical runtime bug. Users upgrading from 3.20 or earlier will hit a Kibana crashloop during the saved-object migration — by the time they see it, they're already stuck in a broken state. The note is placed at the top of the release section so it's visible before someone starts the upgrade, rather than buried in the bug-fix list where it reads like a post-facto fix. Once 3.21.8 / 3.22.5 ship with the fix included, we can remove the admonition and leave just the bug-fix line item.

@CLAassistant
Copy link
Copy Markdown

CLAassistant commented May 26, 2026

CLA assistant check
All committers have signed the CLA.

@tianfeng92 tianfeng92 force-pushed the kibana-7-8-migration-known-issue branch from 9984c85 to f4af653 Compare May 26, 2026 22:14
…notes

Add upgrade notes on the 3.21.7, 3.22.3, and 3.22.4 release sections
warning about the known Kibana 7→8 saved-object migration issue when
upgrading from Calico Enterprise 3.20 or earlier. The fix shipped in
3.21.8 and 3.22.5.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@tianfeng92 tianfeng92 force-pushed the kibana-7-8-migration-known-issue branch from f4af653 to 6a57482 Compare May 26, 2026 22:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants