kibana/docs/extend
Gerard Soldevila 8efc526314
APEX-72 Enforce Kibana >= 8.18.0; Remove switchToModelVersionAt (#220985)
## Summary

* Address https://github.com/elastic/kibana/issues/217145 - Put in place
a check to ensure we're upgrading from Kibana 8.18.0 or newer.
* Address https://github.com/elastic/kibana/issues/220521 - New attempt
at removing the `switchToModelVersionAt` property, inspired on
https://github.com/elastic/kibana/pull/219029.

The previous attempt caused a regression: index meta information started
storing _modelVersions_ that were older than the previously stored ones,
which were defaulting to 10.0.0 for SO types that did NOT define
`modelVersions`.

This was due to the removal of the applyTypeDefaults, which was ensuring
all SOs had the `switchToModelVersionAt` property set.

This flag was then used by
`src/core/packages/saved-objects/base-server-internal/src/model_version/version_map.ts`
to determine whether to use `modelVersions` or the legacy `migrations`
property in order to determine the latest model version for a given
type.

When removing the `switchToModelVersionAt` flag (and its default
backfill), the logic started defaulting to the latest `migrations`
version for those SO types that were not defining any `modelVersion`,
resulting in older versions that those stored in the SO indices. This
caused incident https://elasticco.atlassian.net/browse/INC-3818.

This regression has been shipped in 9.0.0 (the PR was
[backported](https://github.com/elastic/kibana/pull/219329)), so in top
of the cleanup, we now need to address
https://github.com/elastic/kibana/issues/220521 to ensure a smooth
transition _OnPrem => Serverless_.

---------

Co-authored-by: Christiane (Tina) Heiligers <christiane.heiligers@elastic.co>
Co-authored-by: kibanamachine <42973632+kibanamachine@users.noreply.github.com>
2025-06-20 16:41:54 +02:00
..
images Optimize existing image assets with lossless compression (#223998) 2025-06-19 16:44:13 +02:00
add-data-tutorials.md
advanced.md
application-service.md
building-kibana.md
ci-metrics.md
configuration-service.md
contributing.md
core-packages.md
dashboard-enhanced-plugin.md
dependencies-versions.md [Docs] Add link to dependencies page (#218588) 2025-04-21 14:54:05 -04:00
development-basepath.md
development-best-practices.md
development-documentation.md [docs] Fix various syntax and rendering errors (#218883) 2025-05-22 10:10:07 +02:00
development-getting-started.md
development-github.md
development-plugin-resources.md
development-pull-request.md
development-security.md [docs] Fix various syntax and rendering errors (#218883) 2025-05-22 10:10:07 +02:00
development-telemetry.md
development-tests.md [docs] Fix various syntax and rendering errors (#218883) 2025-05-22 10:10:07 +02:00
development-visualize-index.md
elasticsearch-service.md
enhanced-embeddables-plugin.md
external-plugin-development.md
external-plugin-functional-tests.md [docs] Fix various syntax and rendering errors (#218883) 2025-05-22 10:10:07 +02:00
external-plugin-localization.md [docs] Fix various syntax and rendering errors (#218883) 2025-05-22 10:10:07 +02:00
http-service.md
index.md [Docs] Add link to dependencies page (#218588) 2025-04-21 14:54:05 -04:00
interpreting-ci-failures.md [docs] Fix various syntax and rendering errors (#218883) 2025-05-22 10:10:07 +02:00
kibana-architecture.md
kibana-dashboard-plugin.md
kibana-debugging.md [docs] Fix image paths for docs-assembler (#218344) 2025-04-15 16:59:57 -05:00
kibana-expressions-plugin.md [docs] Fix image paths for docs-assembler (#218344) 2025-04-15 16:59:57 -05:00
kibana-issue-reporting.md
kibana-linting.md
kibana-navigation.md [docs] Miscellaneous docs clean up (#215260) 2025-03-25 12:57:00 +00:00
kibana-platform-api.md
kibana-platform-plugin-api.md
legacy-url-aliases.md
logging-config-changes.md
logging-service.md
monorepo-packages.md
patterns.md
plugin-list.md [Security Solution] Move threat intelligence to security solution (#214369) 2025-06-03 16:51:57 +02:00
plugin-performance.md
plugin-tooling.md
pr-review.md
reporting-integration.md
running-elasticsearch.md
running-kibana-advanced.md
sample-data.md [docs] Fix various syntax and rendering errors (#218883) 2025-05-22 10:10:07 +02:00
saved-objects-service.md APEX-72 Enforce Kibana >= 8.18.0; Remove switchToModelVersionAt (#220985) 2025-06-20 16:41:54 +02:00
security-best-practices.md
sharing-saved-objects.md [docs] Fix various syntax and rendering errors (#218883) 2025-05-22 10:10:07 +02:00
stability.md [docs] Fix various syntax and rendering errors (#218883) 2025-05-22 10:10:07 +02:00
testing-kibana-plugin.md
toc.yml [Docs] Add link to dependencies page (#218588) 2025-04-21 14:54:05 -04:00
translations-plugin.md
typescript.md
ui-settings-service.md
uiactions-plugin.md [docs] Remove jsx from typescript code blocks (#213955) 2025-03-11 15:48:24 +00:00
upgrading-nodejs.md