8.5.1 release (#1729)

This PR will be used for the first 8.x Helm chart release, that will also be the last official Helm chart release (see #1731). This release will be directly done from the `main` branch and no `8.x` or `8.5` branchs will be created as we don't expect to update the charts for new versions in the future. - [x] bump version from 8.4.1 to 8.5.1 - [x] remove disclamer on chart README pages - [x] add a new 8.x column to the list of supported versions in the global README page - [x] add the official message for the last release - [x] update the changelog and breaking changes files
elastic · Nov 16, 2022 · 0ae236b · 0ae236b
1 parent aa5e8d6
commit 0ae236b
Show file tree

Hide file tree

Showing 76 changed files with 446 additions and 202 deletions.
diff --git a/BREAKING_CHANGES.md b/BREAKING_CHANGES.md
@@ -3,6 +3,13 @@
 <!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
 
 
+  - [8.5.1](#851)
+    - [Last Elastic Helm charts release](#last-elastic-helm-charts-release)
+    - [Security by default for Elasticsearch](#security-by-default-for-elasticsearch)
+    - [Kibana use a Service Account Token to connect to Elasticsearch](#kibana-use-a-service-account-token-to-connect-to-elasticsearch)
+    - [Elasticsearch new node.roles settings](#elasticsearch-new-noderoles-settings)
+    - [APM Server OSS removal](#apm-server-oss-removal)
+    - [Supported K8S versions](#supported-k8s-versions)
   - [7.17.1](#7171)
     - [Metricbeat kube-state-metrics upgrade](#metricbeat-kube-state-metrics-upgrade)
   - [7.11.1](#7111)
@@ -50,6 +57,86 @@
 <!-- Use this to update TOC: -->
 <!-- docker run --entrypoint doctoc --rm -it -v $(pwd):/usr/src jorgeandrada/doctoc BREAKING_CHANGES.md --github --no-title -->
 
+## 8.5.1
+
+### Last Elastic Helm charts release
+
+8.5.1 is expected to be the last Elastic Helm chart release. This repository will stay active for 6
+months before being archived.
+
+See <https://github.com/elastic/helm-charts/issues/1731> for more details.
+
+### Security by default for Elasticsearch
+
+Starting with 8.0.0, Elasticsearch comes with security (TLS + authentication) enabled and
+auto-configured by default.
+Therefore, the Elasticsearch chart has been updated to generate credentials and TLS certificate by
+default.
+Similarly, all charts have been updated to connect to a secured Elasticsearch deployed by the
+Elasticsearch chart by default.
+
+Consequently, running the Elasticsearch chart with security disabled isn't anymore supported.
+The other charts are also not supporting anymore connection to an Elasticsearch without security.
+
+Note that in addition to the security configured by default, it is still possible to use your own
+TLS certificates, credentials and security configurations (see the `security` examples for each
+chart).
+
+See the related PRs for more details:
+
+- <https://github.com/elastic/helm-charts/pull/1384>
+- <https://github.com/elastic/helm-charts/pull/1399>
+- <https://github.com/elastic/helm-charts/pull/1400>
+- <https://github.com/elastic/helm-charts/pull/1401>
+- <https://github.com/elastic/helm-charts/pull/1402>
+- <https://github.com/elastic/helm-charts/pull/1403>
+- <https://github.com/elastic/helm-charts/pull/1519>
+- <https://github.com/elastic/helm-charts/pull/1623>
+- <https://github.com/elastic/helm-charts/pull/1624>
+- <https://github.com/elastic/helm-charts/pull/1625>
+- <https://github.com/elastic/helm-charts/pull/1627>
+- <https://github.com/elastic/helm-charts/pull/1628>
+- <https://github.com/elastic/helm-charts/pull/1677>
+- <https://github.com/elastic/helm-charts/pull/1691>
+
+### Kibana use a Service Account Token to connect to Elasticsearch
+
+In addition to the changes related to security by default, starting with 8.0.0, Kibana can't anymore
+use the `elastic` super user to connect to Elasticsearch but needs to use service account token
+instead. The Kibana chart is now using a `pre-install` Helm chart hook to request the creation of
+this service account and register it in a K8S Secret that can be used by the Kibana pods.
+
+See the related PRs for more details:
+
+- <https://github.com/elastic/helm-charts/pull/1679>
+- <https://github.com/elastic/helm-charts/pull/1695>
+- <https://github.com/elastic/helm-charts/pull/1720>
+- <https://github.com/elastic/helm-charts/pull/1727>
+
+### Elasticsearch new node.roles settings
+
+Starting with 8.5.1, the `roles` values in Elasticsearch chart support a simple list of the roles
+to configure, instead of a dictionnary. All roles defined in the [Elasticsearch node roles doc][]
+are now supported.
+
+See the related PRs for more details:
+
+- <https://github.com/elastic/helm-charts/pull/1186>
+- <https://github.com/elastic/helm-charts/pull/1693>
+
+### APM Server OSS removal
+
+Starting with 8.0.0, APM Server doesn't provide anymore OSS version. Consequently this option
+is removed from the APM Server chart.
+
+See <https://github.com/elastic/helm-charts/pull/1442> for more details.
+
+### Supported K8S versions
+
+This release remove the support of K8S 1.19 and 1.20, and add the support of 1.23 and 1.24.
+
+See <https://github.com/elastic/helm-charts/pull/1703> for more details.
+
 ## 7.17.1
 
 ### Metricbeat kube-state-metrics upgrade
@@ -413,7 +500,7 @@ volumeClaimTemplate:
 ```
 
 
-[#94]: https://github.com/elastic/helm-charts/pull/94
+[#1524]: https://github.com/elastic/helm-charts/pull/1524
 [#352]: https://github.com/elastic/helm-charts/pull/352
 [#437]: https://github.com/elastic/helm-charts/pull/437
 [#458]: https://github.com/elastic/helm-charts/pull/458
@@ -431,16 +518,17 @@ volumeClaimTemplate:
 [#807]: https://github.com/elastic/helm-charts/issues/807
 [#839]: https://github.com/elastic/helm-charts/issues/839
 [#916]: https://github.com/elastic/helm-charts/pull/916
-[#1524]: https://github.com/elastic/helm-charts/pull/1524
+[#94]: https://github.com/elastic/helm-charts/pull/94
 [container input]: https://www.elastic.co/guide/en/beats/filebeat/7.7/filebeat-input-container.html
 [docker input]: https://www.elastic.co/guide/en/beats/filebeat/7.7/filebeat-input-docker.html
 [elastic blog post]: https://www.elastic.co/blog/licensing-change
 [elastic elasticsearch chart]: https://github.com/elastic/helm-charts/tree/main/elasticsearch
 [elastic helm repo]: https://helm.elastic.co
+[elasticsearch node roles doc]: https://www.elastic.co/guide/en/elasticsearch/reference/current/modules-node.html#node-roles
 [github releases]: https://github.com/elastic/helm-charts/releases
 [helm 2to3]: https://helm.sh/blog/migrate-from-helm-v2-to-helm-v3/
+[kube-state-metrics]: https://github.com/helm/charts/tree/master/stable/kube-state-metrics
 [migration guide]: https://github.com/elastic/helm-charts/blob/main/elasticsearch/examples/migration/README.md
 [new branching model]: https://github.com/elastic/helm-charts/blob/main/CONTRIBUTING.md#branching
-[kube-state-metrics]: https://github.com/helm/charts/tree/master/stable/kube-state-metrics
-[stable elasticsearch chart]: https://github.com/helm/charts/tree/master/stable/elasticsearch
 [stable elasticsearch chart notice]: https://github.com/helm/charts/tree/master/stable#elasticsearch#this-helm-chart-is-deprecated
+[stable elasticsearch chart]: https://github.com/helm/charts/tree/master/stable/elasticsearch
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,12 @@
 # Changelog
 
+## 8.5.1
+
+* 8.5.1 as default version
+* See the [Breaking changes](./BREAKING_CHANGES.md) for a detailed list of changes.
+* Thanks for everyone that contributed to this release, especially [@framsouza](https://github.com/framsouza), [@jmlrt](https://github.com/jmlrt),[@ebuildy](https://github.com/ebuildy), [@pjaak](https://github.com/pjaak), [@azasypkin](https://github.com/azasypkin),[@jbudz](https://github.com/jbudz),[@jkakavas](https://github.com/jkakavas), [@mark-vieira](https://github.com/mark-vieira), [@mgreau](https://github.com/mgreau), [@nkammah](https://github.com/nkammah), [@pugnascotia](https://github.com/pugnascotia), [@rjernst](https://github.com/rjernst), and everyone else who wasn't mentionned here...
+
+
 ## 7.17.3
 
 * 7.17.3 as default version.

diff --git a/README.md b/README.md
@@ -6,59 +6,76 @@
 <!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
 
 
-- [Charts](#charts)
 - [Supported Configurations](#supported-configurations)
   - [Stack Versions](#stack-versions)
   - [Kubernetes Versions](#kubernetes-versions)
   - [Helm Versions](#helm-versions)
-- [ECK](#eck)
 
 <!-- END doctoc generated TOC please keep comment here to allow auto update -->
 <!-- Use this to update TOC: -->
 <!-- docker run --entrypoint doctoc --rm -it -v $(pwd):/usr/src jorgeandrada/doctoc README.md --github --no-title -->
 
-
-## Charts
-
 These Helm charts are designed to be a lightweight way to configure Elastic
 official Docker images.
 
+> **Warning**
+> When it comes to running the Elastic on Kubernetes infrastructure, we
+> recommend [Elastic Cloud on Kubernetes][] (ECK) as the best way to run and manage
+> the Elastic Stack.
+>
+> ECK offers many operational benefits for both our basic-tier and our
+> enterprise-tier customers, such as spinning up cluster nodes that were lost on
+> failed infrastructure, seamless upgrades, rolling cluster changes, and much
+> much more.
+>
+> With the release of the Elastic Stack Helm charts for Elastic version 8.5.1,
+> we are handing over the ongoing maintenance of our Elastic Stack Helm charts
+> to the community and contributors. This repository will finally be archived
+> after 6 months time. Elastic Stacks deployed on Kubernetes through Helm charts
+> will still be fully supported under EOL limitations.
+>
+> Since we want to provide an even better experience for our customers by
+> running the Elastic Stack on Kubernetes, we will continue maintaining the
+> Helm charts applicable to ECK Custom Resources. These charts can be found in
+> the [ECK repository][eck-charts].
+>
+> Helm charts will currently be maintained for ECK Enterprise-tier customers,
+> however, we encourage the community to engage with the existing Helm charts
+> for the Elastic Stack and continue supporting their ongoing maintenance.
+>
+> See https://github.com/elastic/helm-charts/issues/1731 for more details.
+
+
 ## Supported Configurations
 
 We recommend that the Helm chart version is aligned to the version of the
-product you want to deploy. This will ensure that you are using a chart version
+product you want to deploy, when a chart release exists for the given stack
+version. This will ensure that you are using a chart version
 that has been tested against the corresponding production version.
 This will also ensure that the documentation and examples for the chart will
 work with the version of the product, you are installing.
 
 For example, if you want to deploy an Elasticsearch `7.7.1` cluster, use the
 corresponding `7.7.1` [tag][elasticsearch-771].
 
-However, we are not releasing new charts versions for each new patch version of
-the Elastic products, so if a chart for the latest patch version doesn't exist,
-you can use the latest chart with the same **MAJOR.MINOR** version and override
-the Docker image tag to the latest patch version with the `imageTag` value.
+However, we don't expect to release new charts versions, so if a chart for the
+latest patch version doesn't exist, you can use the latest chart with the same
+**MAJOR.MINOR** version and override the Docker image tag to the latest patch
+version with the `imageTag` value.
 
 For example, if you want to deploy an Elasticsearch `7.17.5` cluster, use the
 corresponding `7.17.3` [tag][elasticsearch-7173], with `imageTag=7.17.5` value.
 
-The `master` version of these charts is intended to support the latest
-pre-release versions of our products, and therefore may or may not work with
-current released versions.
-Note that only the released charts coming from [Elastic Helm repo][] or
-[GitHub releases][] are supported.
-
-
 ### Stack Versions
 
-| Chart                                      | Latest 7 Version                             | Latest 6 Version                   |
-|--------------------------------------------|----------------------------------------------|------------------------------------|
-| [APM-Server](./apm-server/README.md)       | [`7.17.3`][apm-7] (Beta since 7.7.0)         | [`6.8.22`][apm-6] (Alpha)          |
-| [Elasticsearch](./elasticsearch/README.md) | [`7.17.3`][elasticsearch-7] (GA since 7.7.0) | [`6.8.22`][elasticsearch-6] (Beta) |
-| [Filebeat](./filebeat/README.md)           | [`7.17.3`][filebeat-7] (GA since 7.7.0)      | [`6.8.22`][filebeat-6] (Beta)      |
-| [Kibana](./kibana/README.md)               | [`7.17.3`][kibana-7] (GA since 7.7.0)        | [`6.8.22`][kibana-6] (Beta)        |
-| [Logstash](./logstash/README.md)           | [`7.17.3`][logstash-7] (Beta since 7.5.0)    | [`6.8.22`][logstash-6] (Beta)      |
-| [Metricbeat](./metricbeat/README.md)       | [`7.17.3`][metricbeat-7] (GA since 7.7.0)    | [`6.8.22`][metricbeat-6] (Beta)    |
+| Chart                                      | Latest 8 Version                            | Latest 7 Version                             | Latest 6 Version                   |
+|--------------------------------------------|---------------------------------------------|----------------------------------------------|------------------------------------|
+| [APM Server](./apm-server/README.md)       | [`8.5.1`][apm-8] (Beta since 7.7.0)         | [`7.17.3`][apm-7] (Beta since 7.7.0)         | [`6.8.22`][apm-6] (Alpha)          |
+| [Elasticsearch](./elasticsearch/README.md) | [`8.5.1`][elasticsearch-8] (GA since 7.7.0) | [`7.17.3`][elasticsearch-7] (GA since 7.7.0) | [`6.8.22`][elasticsearch-6] (Beta) |
+| [Filebeat](./filebeat/README.md)           | [`8.5.1`][filebeat-8] (GA since 7.7.0)      | [`7.17.3`][filebeat-7] (GA since 7.7.0)      | [`6.8.22`][filebeat-6] (Beta)      |
+| [Kibana](./kibana/README.md)               | [`8.5.1`][kibana-8] (GA since 7.7.0)        | [`7.17.3`][kibana-7] (GA since 7.7.0)        | [`6.8.22`][kibana-6] (Beta)        |
+| [Logstash](./logstash/README.md)           | [`8.5.1`][logstash-8] (Beta since 7.5.0)    | [`7.17.3`][logstash-7] (Beta since 7.5.0)    | [`6.8.22`][logstash-6] (Beta)      |
+| [Metricbeat](./metricbeat/README.md)       | [`8.5.1`][metricbeat-8] (GA since 7.7.0)    | [`7.17.3`][metricbeat-7] (GA since 7.7.0)    | [`6.8.22`][metricbeat-6] (Beta)    |
 
 ### Kubernetes Versions
 
@@ -71,36 +88,28 @@ exact versions are defined under `KUBERNETES_VERSIONS` in
 While we are checking backward compatibility, the charts are only tested with
 Helm version mentioned in [helm-tester Dockerfile][] (currently 3.10.2).
 
-
-## ECK
-
-In addition to these Helm charts, Elastic also provides
-[Elastic Cloud on Kubernetes][] which is based on [Operator pattern][] and is
-Elastic recommended way to deploy Elasticsearch, Kibana, and APM Server on
-Kubernetes. There is a dedicated Helm chart for ECK which can be found
-[in ECK repo][eck-chart] ([documentation][eck-chart-doc]).
-
-
+[apm-6]: https://github.com/elastic/helm-charts/tree/6.8/apm-server/README.md
+[apm-7]: https://github.com/elastic/helm-charts/tree/7.17/apm-server/README.md
+[apm-8]: https://github.com/elastic/helm-charts/tree/main/apm-server/README.md
 [currently tested]: https://devops-ci.elastic.co/job/elastic+helm-charts+main/
-[eck-chart]: https://github.com/elastic/cloud-on-k8s/tree/master/deploy
-[eck-chart-doc]: https://www.elastic.co/guide/en/cloud-on-k8s/current/k8s-install-helm.html
+[eck-charts]: https://github.com/elastic/cloud-on-k8s/tree/master/deploy
 [elastic cloud on kubernetes]: https://github.com/elastic/cloud-on-k8s
-[elastic helm repo]: https://helm.elastic.co
-[github releases]: https://github.com/elastic/helm-charts/releases
-[helm-tester Dockerfile]: https://github.com/elastic/helm-charts/blob/main/helpers/helm-tester/Dockerfile
-[helpers/matrix.yml]: https://github.com/elastic/helm-charts/blob/main/helpers/matrix.yml
-[operator pattern]: https://kubernetes.io/docs/concepts/extend-kubernetes/operator/
+[elasticsearch-6]: https://github.com/elastic/helm-charts/tree/6.8/elasticsearch/README.md
+[elasticsearch-7]: https://github.com/elastic/helm-charts/tree/7.17/elasticsearch/README.md
 [elasticsearch-7173]: https://github.com/elastic/helm-charts/tree/7.17.3/elasticsearch/
 [elasticsearch-771]: https://github.com/elastic/helm-charts/tree/7.7.1/elasticsearch/
-[apm-7]: https://github.com/elastic/helm-charts/tree/7.17/apm-server/README.md
-[apm-6]: https://github.com/elastic/helm-charts/tree/6.8/apm-server/README.md
-[elasticsearch-7]: https://github.com/elastic/helm-charts/tree/7.17/elasticsearch/README.md
-[elasticsearch-6]: https://github.com/elastic/helm-charts/tree/6.8/elasticsearch/README.md
-[filebeat-7]: https://github.com/elastic/helm-charts/tree/7.17/filebeat/README.md
+[elasticsearch-8]: https://github.com/elastic/helm-charts/tree/main/elasticsearch/README.md
 [filebeat-6]: https://github.com/elastic/helm-charts/tree/6.8/filebeat/README.md
-[kibana-7]: https://github.com/elastic/helm-charts/tree/7.17/kibana/README.md
+[filebeat-7]: https://github.com/elastic/helm-charts/tree/7.17/filebeat/README.md
+[filebeat-8]: https://github.com/elastic/helm-charts/tree/main/filebeat/README.md
+[helm-tester Dockerfile]: https://github.com/elastic/helm-charts/blob/main/helpers/helm-tester/Dockerfile
+[helpers/matrix.yml]: https://github.com/elastic/helm-charts/blob/main/helpers/matrix.yml
 [kibana-6]: https://github.com/elastic/helm-charts/tree/6.8/kibana/README.md
-[logstash-7]: https://github.com/elastic/helm-charts/tree/7.17/logstash/README.md
+[kibana-7]: https://github.com/elastic/helm-charts/tree/7.17/kibana/README.md
+[kibana-8]: https://github.com/elastic/helm-charts/tree/main/kibana/README.md
 [logstash-6]: https://github.com/elastic/helm-charts/tree/6.8/logstash/README.md
-[metricbeat-7]: https://github.com/elastic/helm-charts/tree/7.17/metricbeat/README.md
+[logstash-7]: https://github.com/elastic/helm-charts/tree/7.17/logstash/README.md
+[logstash-8]: https://github.com/elastic/helm-charts/tree/main/logstash/README.md
 [metricbeat-6]: https://github.com/elastic/helm-charts/tree/6.8/metricbeat/README.md
+[metricbeat-7]: https://github.com/elastic/helm-charts/tree/7.17/metricbeat/README.md
+[metricbeat-8]: https://github.com/elastic/helm-charts/tree/main/metricbeat/README.md
diff --git a/apm-server/Chart.yaml b/apm-server/Chart.yaml
@@ -5,8 +5,8 @@ maintainers:
   - email: helm-charts@elastic.co
     name: Elastic
 name: apm-server
-version: 8.4.1
-appVersion: 8.4.1
+version: 8.5.1
+appVersion: 8.5.1
 sources:
   - https://github.com/elastic/apm
 icon: https://helm.elastic.co/icons/apm.png