diff --git a/docs/source/docset.yml b/docs/source/docset.yml index 7ff9426..c092f9f 100644 --- a/docs/source/docset.yml +++ b/docs/source/docset.yml @@ -46,3 +46,16 @@ toc: - folder: content - file: index.md - folder: versioning + - folder: upgrade-mockup + children: + - file: index.md + - folder: plan-upgrade + - folder: prepare-upgrade + - folder: breaking-changes + - folder: elastic-cloud + - folder: on-prem + - folder: elasticsearch + - folder: kibana + + + diff --git a/docs/source/upgrade-mockup/breaking-changes/APM.md b/docs/source/upgrade-mockup/breaking-changes/APM.md new file mode 100644 index 0000000..65ccd99 --- /dev/null +++ b/docs/source/upgrade-mockup/breaking-changes/APM.md @@ -0,0 +1,3 @@ +--- +title: APM +--- \ No newline at end of file diff --git a/docs/source/upgrade-mockup/breaking-changes/beats.md b/docs/source/upgrade-mockup/breaking-changes/beats.md new file mode 100644 index 0000000..b441ea4 --- /dev/null +++ b/docs/source/upgrade-mockup/breaking-changes/beats.md @@ -0,0 +1,3 @@ +--- +title: Beats +--- \ No newline at end of file diff --git a/docs/source/upgrade-mockup/breaking-changes/elasticsearch.md b/docs/source/upgrade-mockup/breaking-changes/elasticsearch.md new file mode 100644 index 0000000..dec04bd --- /dev/null +++ b/docs/source/upgrade-mockup/breaking-changes/elasticsearch.md @@ -0,0 +1,375 @@ +--- +title: Elasticsearch +--- + +The following changes in Elasticsearch might affect your applications and prevent them from operating normally. Before upgrading, review these changes and take the described steps to mitigate the impact. + +Deprecations refer to functionality has been deprecated in the specified Elasticsearch version and will be removed in a future version. While this won’t have an immediate impact on your applications, we strongly encourage you to take the described steps to update your code after upgrading. + +## 9.0 + +Review the following breaking changes and deprecations for v. 9.0. + +### Breaking changes + +#### Analysis changes + +```{dropdown} This is a breaking change +**Details** +These are the details of the breaking change. For more information, refer to #12345. + +**Impact** +This is the impact of the breaking change. +``` + +#### Mapping changes + +```{dropdown} This is another breaking change +**Details** +These are the details of the second breaking change. For more information, refer to #67890. + +**Impact** +This is the impact of the second breaking change. +``` + +### Deprecations + +#### Analysis deprecations + +```{dropdown} This is a deprecation +**Details** +These are the details of the deprecation. For more information, refer to #12345. + +**Impact** +This is the impact of the deprecation. +``` + +#### Mapping deprecations + +```{dropdown} This is another deprecation +**Details** +These are the details of the second deprecation. For more information, refer to #67890. + +**Impact** +This is the impact of the second deprecation. +``` + +## 8.18 + +Review the following breaking changes and deprecations for v. 8.18. + +### Breaking changes + +```{dropdown} This is another breaking change +**Details** +These are the details of the second breaking change. For more information, refer to #67890. + +**Impact** +This is the impact of the second breaking change. +``` + +```{dropdown} This is another breaking change +**Details** +These are the details of the second breaking change. For more information, refer to #67890. + +**Impact** +This is the impact of the second breaking change. +``` + +### Deprecations + +```{dropdown} This is a deprecation +**Details** +These are the details of the deprecation. For more information, refer to #12345. + +**Impact** +This is the impact of the deprecation. +``` + +```{dropdown} This is a deprecation +**Details** +These are the details of the deprecation. For more information, refer to #12345. + +**Impact** +This is the impact of the deprecation. +``` + +## 8.17 + +Review the following breaking changes and deprecations for v. 8.17. + +### Breaking changes + +```{dropdown} This is another breaking change +**Details** +These are the details of the second breaking change. For more information, refer to #67890. + +**Impact** +This is the impact of the second breaking change. +``` + +```{dropdown} This is another breaking change +**Details** +These are the details of the second breaking change. For more information, refer to #67890. + +**Impact** +This is the impact of the second breaking change. +``` + +### Deprecations + +```{dropdown} This is a deprecation +**Details** +These are the details of the deprecation. For more information, refer to #12345. + +**Impact** +This is the impact of the deprecation. +``` + +```{dropdown} This is a deprecation +**Details** +These are the details of the deprecation. For more information, refer to #12345. + +**Impact** +This is the impact of the deprecation. +``` + +## 8.16 + +Review the following breaking changes and deprecations for v. 8.16. + +### Breaking changes + +```{dropdown} This is another breaking change +**Details** +These are the details of the second breaking change. For more information, refer to #67890. + +**Impact** +This is the impact of the second breaking change. +``` + +```{dropdown} This is another breaking change +**Details** +These are the details of the second breaking change. For more information, refer to #67890. + +**Impact** +This is the impact of the second breaking change. +``` + +### Deprecations + +```{dropdown} This is a deprecation +**Details** +These are the details of the deprecation. For more information, refer to #12345. + +**Impact** +This is the impact of the deprecation. +``` + +```{dropdown} This is a deprecation +**Details** +These are the details of the deprecation. For more information, refer to #12345. + +**Impact** +This is the impact of the deprecation. +``` + +## 8.15 + +Review the following breaking changes and deprecations for v. 8.15. + +### Breaking changes + +```{dropdown} This is another breaking change +**Details** +These are the details of the second breaking change. For more information, refer to #67890. + +**Impact** +This is the impact of the second breaking change. +``` + +```{dropdown} This is another breaking change +**Details** +These are the details of the second breaking change. For more information, refer to #67890. + +**Impact** +This is the impact of the second breaking change. +``` + +### Deprecations + +```{dropdown} This is a deprecation +**Details** +These are the details of the deprecation. For more information, refer to #12345. + +**Impact** +This is the impact of the deprecation. +``` + +```{dropdown} This is a deprecation +**Details** +These are the details of the deprecation. For more information, refer to #12345. + +**Impact** +This is the impact of the deprecation. +``` + +## 8.14 + +Review the following breaking changes and deprecations for v. 8.14. + +### Breaking changes + +```{dropdown} This is another breaking change +**Details** +These are the details of the second breaking change. For more information, refer to #67890. + +**Impact** +This is the impact of the second breaking change. +``` + +```{dropdown} This is another breaking change +**Details** +These are the details of the second breaking change. For more information, refer to #67890. + +**Impact** +This is the impact of the second breaking change. +``` + +### Deprecations + +```{dropdown} This is a deprecation +**Details** +These are the details of the deprecation. For more information, refer to #12345. + +**Impact** +This is the impact of the deprecation. +``` + +```{dropdown} This is a deprecation +**Details** +These are the details of the deprecation. For more information, refer to #12345. + +**Impact** +This is the impact of the deprecation. +``` + +## 8.13 + +Review the following breaking changes and deprecations for v. 8.13. + +### Breaking changes + +```{dropdown} This is another breaking change +**Details** +These are the details of the second breaking change. For more information, refer to #67890. + +**Impact** +This is the impact of the second breaking change. +``` + +```{dropdown} This is another breaking change +**Details** +These are the details of the second breaking change. For more information, refer to #67890. + +**Impact** +This is the impact of the second breaking change. +``` + +### Deprecations + +```{dropdown} This is a deprecation +**Details** +These are the details of the deprecation. For more information, refer to #12345. + +**Impact** +This is the impact of the deprecation. +``` + +```{dropdown} This is a deprecation +**Details** +These are the details of the deprecation. For more information, refer to #12345. + +**Impact** +This is the impact of the deprecation. +``` + +## 8.12 + +Review the following breaking changes and deprecations for v. 8.12. + +### Breaking changes + +```{dropdown} This is another breaking change +**Details** +These are the details of the second breaking change. For more information, refer to #67890. + +**Impact** +This is the impact of the second breaking change. +``` + +```{dropdown} This is another breaking change +**Details** +These are the details of the second breaking change. For more information, refer to #67890. + +**Impact** +This is the impact of the second breaking change. +``` + +### Deprecations + +```{dropdown} This is a deprecation +**Details** +These are the details of the deprecation. For more information, refer to #12345. + +**Impact** +This is the impact of the deprecation. +``` + +```{dropdown} This is a deprecation +**Details** +These are the details of the deprecation. For more information, refer to #12345. + +**Impact** +This is the impact of the deprecation. +``` + +## 8.11 + +Review the following breaking changes and deprecations for v. 8.11. + +### Breaking changes + +```{dropdown} This is another breaking change +**Details** +These are the details of the second breaking change. For more information, refer to #67890. + +**Impact** +This is the impact of the second breaking change. +``` + +```{dropdown} This is another breaking change +**Details** +These are the details of the second breaking change. For more information, refer to #67890. + +**Impact** +This is the impact of the second breaking change. +``` + +### Deprecations + +```{dropdown} This is a deprecation +**Details** +These are the details of the deprecation. For more information, refer to #12345. + +**Impact** +This is the impact of the deprecation. +``` + +```{dropdown} This is a deprecation +**Details** +These are the details of the deprecation. For more information, refer to #12345. + +**Impact** +This is the impact of the deprecation. +``` \ No newline at end of file diff --git a/docs/source/upgrade-mockup/breaking-changes/fleet-agent.md b/docs/source/upgrade-mockup/breaking-changes/fleet-agent.md new file mode 100644 index 0000000..5d7ab29 --- /dev/null +++ b/docs/source/upgrade-mockup/breaking-changes/fleet-agent.md @@ -0,0 +1,3 @@ +--- +title: Fleet and Agent +--- \ No newline at end of file diff --git a/docs/source/upgrade-mockup/breaking-changes/index.md b/docs/source/upgrade-mockup/breaking-changes/index.md new file mode 100644 index 0000000..6488c9e --- /dev/null +++ b/docs/source/upgrade-mockup/breaking-changes/index.md @@ -0,0 +1,3 @@ +--- +title: Breaking changes and deprecations +--- \ No newline at end of file diff --git a/docs/source/upgrade-mockup/breaking-changes/kibana.md b/docs/source/upgrade-mockup/breaking-changes/kibana.md new file mode 100644 index 0000000..f85a67b --- /dev/null +++ b/docs/source/upgrade-mockup/breaking-changes/kibana.md @@ -0,0 +1,3 @@ +--- +title: Kibana +--- \ No newline at end of file diff --git a/docs/source/upgrade-mockup/breaking-changes/logstash.md b/docs/source/upgrade-mockup/breaking-changes/logstash.md new file mode 100644 index 0000000..4426286 --- /dev/null +++ b/docs/source/upgrade-mockup/breaking-changes/logstash.md @@ -0,0 +1,3 @@ +--- +title: Logstash +--- \ No newline at end of file diff --git a/docs/source/upgrade-mockup/breaking-changes/security.md b/docs/source/upgrade-mockup/breaking-changes/security.md new file mode 100644 index 0000000..6302d7b --- /dev/null +++ b/docs/source/upgrade-mockup/breaking-changes/security.md @@ -0,0 +1,3 @@ +--- +title: Security +--- \ No newline at end of file diff --git a/docs/source/upgrade-mockup/elastic-cloud/index.md b/docs/source/upgrade-mockup/elastic-cloud/index.md new file mode 100644 index 0000000..7fbd701 --- /dev/null +++ b/docs/source/upgrade-mockup/elastic-cloud/index.md @@ -0,0 +1,3 @@ +--- +title: Upgrade on Elastic Cloud +--- \ No newline at end of file diff --git a/docs/source/upgrade-mockup/elasticsearch/index.md b/docs/source/upgrade-mockup/elasticsearch/index.md new file mode 100644 index 0000000..71d31e8 --- /dev/null +++ b/docs/source/upgrade-mockup/elasticsearch/index.md @@ -0,0 +1,3 @@ +--- +title: Upgrade Elasticsearch +--- \ No newline at end of file diff --git a/docs/source/upgrade-mockup/index.md b/docs/source/upgrade-mockup/index.md new file mode 100644 index 0000000..ffb462a --- /dev/null +++ b/docs/source/upgrade-mockup/index.md @@ -0,0 +1,9 @@ +--- +title: Upgrade +--- + +This will include an intro paragraph of what this guide covers. + +## Why it’s important to upgrade + +Sample text: Upgrading provides you access to Elastic’s latest features, enhancements, and bug fixes, many of which enable you to save your organization money, respond faster to potential threats, and improve the tools you use to investigate and analyze your data. Also, it’s important to ensure that your deployment is fully maintained and supported. For more information, refer to [Elastic’s Product End of Life Dates](https://www.elastic.co/support/eol). \ No newline at end of file diff --git a/docs/source/upgrade-mockup/kibana/index.md b/docs/source/upgrade-mockup/kibana/index.md new file mode 100644 index 0000000..1212f37 --- /dev/null +++ b/docs/source/upgrade-mockup/kibana/index.md @@ -0,0 +1,3 @@ +--- +title: Upgrade Kibana +--- \ No newline at end of file diff --git a/docs/source/upgrade-mockup/on-prem/index.md b/docs/source/upgrade-mockup/on-prem/index.md new file mode 100644 index 0000000..4b02bd3 --- /dev/null +++ b/docs/source/upgrade-mockup/on-prem/index.md @@ -0,0 +1,3 @@ +--- +title: Upgrade Elastic on-prem +--- \ No newline at end of file diff --git a/docs/source/upgrade-mockup/plan-upgrade/index.md b/docs/source/upgrade-mockup/plan-upgrade/index.md new file mode 100644 index 0000000..6493e84 --- /dev/null +++ b/docs/source/upgrade-mockup/plan-upgrade/index.md @@ -0,0 +1,5 @@ +--- +title: Plan for your upgrade +--- + +Sample text: Before upgrading to 9.x, consider the following recommendations… diff --git a/docs/source/upgrade-mockup/prepare-upgrade/index.md b/docs/source/upgrade-mockup/prepare-upgrade/index.md new file mode 100644 index 0000000..4d9cf67 --- /dev/null +++ b/docs/source/upgrade-mockup/prepare-upgrade/index.md @@ -0,0 +1,7 @@ +--- +title: Prepare to upgrade +--- + +To prepare for the upgrade process, follow these steps before you start… Can also include things like: +* Review breaking changes +* Test the upgrade in an isolated environment before upgrading your production cluster.