Skip to content
This repository was archived by the owner on May 16, 2023. It is now read-only.

Commit 0ae236b

Browse files
jmlrtjmlrt
authored
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
1 parent aa5e8d6 commit 0ae236b

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

76 files changed

+446
-202
lines changed

‎BREAKING_CHANGES.md

+92-4
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,13 @@
33
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
44

55

6+
- [8.5.1](#851)
7+
- [Last Elastic Helm charts release](#last-elastic-helm-charts-release)
8+
- [Security by default for Elasticsearch](#security-by-default-for-elasticsearch)
9+
- [Kibana use a Service Account Token to connect to Elasticsearch](#kibana-use-a-service-account-token-to-connect-to-elasticsearch)
10+
- [Elasticsearch new node.roles settings](#elasticsearch-new-noderoles-settings)
11+
- [APM Server OSS removal](#apm-server-oss-removal)
12+
- [Supported K8S versions](#supported-k8s-versions)
613
- [7.17.1](#7171)
714
- [Metricbeat kube-state-metrics upgrade](#metricbeat-kube-state-metrics-upgrade)
815
- [7.11.1](#7111)
@@ -50,6 +57,86 @@
5057
<!-- Use this to update TOC: -->
5158
<!-- docker run --entrypoint doctoc --rm -it -v $(pwd):/usr/src jorgeandrada/doctoc BREAKING_CHANGES.md --github --no-title -->
5259

60+
## 8.5.1
61+
62+
### Last Elastic Helm charts release
63+
64+
8.5.1 is expected to be the last Elastic Helm chart release. This repository will stay active for 6
65+
months before being archived.
66+
67+
See <https://github.com/elastic/helm-charts/issues/1731> for more details.
68+
69+
### Security by default for Elasticsearch
70+
71+
Starting with 8.0.0, Elasticsearch comes with security (TLS + authentication) enabled and
72+
auto-configured by default.
73+
Therefore, the Elasticsearch chart has been updated to generate credentials and TLS certificate by
74+
default.
75+
Similarly, all charts have been updated to connect to a secured Elasticsearch deployed by the
76+
Elasticsearch chart by default.
77+
78+
Consequently, running the Elasticsearch chart with security disabled isn't anymore supported.
79+
The other charts are also not supporting anymore connection to an Elasticsearch without security.
80+
81+
Note that in addition to the security configured by default, it is still possible to use your own
82+
TLS certificates, credentials and security configurations (see the `security` examples for each
83+
chart).
84+
85+
See the related PRs for more details:
86+
87+
- <https://github.com/elastic/helm-charts/pull/1384>
88+
- <https://github.com/elastic/helm-charts/pull/1399>
89+
- <https://github.com/elastic/helm-charts/pull/1400>
90+
- <https://github.com/elastic/helm-charts/pull/1401>
91+
- <https://github.com/elastic/helm-charts/pull/1402>
92+
- <https://github.com/elastic/helm-charts/pull/1403>
93+
- <https://github.com/elastic/helm-charts/pull/1519>
94+
- <https://github.com/elastic/helm-charts/pull/1623>
95+
- <https://github.com/elastic/helm-charts/pull/1624>
96+
- <https://github.com/elastic/helm-charts/pull/1625>
97+
- <https://github.com/elastic/helm-charts/pull/1627>
98+
- <https://github.com/elastic/helm-charts/pull/1628>
99+
- <https://github.com/elastic/helm-charts/pull/1677>
100+
- <https://github.com/elastic/helm-charts/pull/1691>
101+
102+
### Kibana use a Service Account Token to connect to Elasticsearch
103+
104+
In addition to the changes related to security by default, starting with 8.0.0, Kibana can't anymore
105+
use the `elastic` super user to connect to Elasticsearch but needs to use service account token
106+
instead. The Kibana chart is now using a `pre-install` Helm chart hook to request the creation of
107+
this service account and register it in a K8S Secret that can be used by the Kibana pods.
108+
109+
See the related PRs for more details:
110+
111+
- <https://github.com/elastic/helm-charts/pull/1679>
112+
- <https://github.com/elastic/helm-charts/pull/1695>
113+
- <https://github.com/elastic/helm-charts/pull/1720>
114+
- <https://github.com/elastic/helm-charts/pull/1727>
115+
116+
### Elasticsearch new node.roles settings
117+
118+
Starting with 8.5.1, the `roles` values in Elasticsearch chart support a simple list of the roles
119+
to configure, instead of a dictionnary. All roles defined in the [Elasticsearch node roles doc][]
120+
are now supported.
121+
122+
See the related PRs for more details:
123+
124+
- <https://github.com/elastic/helm-charts/pull/1186>
125+
- <https://github.com/elastic/helm-charts/pull/1693>
126+
127+
### APM Server OSS removal
128+
129+
Starting with 8.0.0, APM Server doesn't provide anymore OSS version. Consequently this option
130+
is removed from the APM Server chart.
131+
132+
See <https://github.com/elastic/helm-charts/pull/1442> for more details.
133+
134+
### Supported K8S versions
135+
136+
This release remove the support of K8S 1.19 and 1.20, and add the support of 1.23 and 1.24.
137+
138+
See <https://github.com/elastic/helm-charts/pull/1703> for more details.
139+
53140
## 7.17.1
54141

55142
### Metricbeat kube-state-metrics upgrade
@@ -413,7 +500,7 @@ volumeClaimTemplate:
413500
```
414501
415502
416-
[#94]: https://github.com/elastic/helm-charts/pull/94
503+
[#1524]: https://github.com/elastic/helm-charts/pull/1524
417504
[#352]: https://github.com/elastic/helm-charts/pull/352
418505
[#437]: https://github.com/elastic/helm-charts/pull/437
419506
[#458]: https://github.com/elastic/helm-charts/pull/458
@@ -431,16 +518,17 @@ volumeClaimTemplate:
431518
[#807]: https://github.com/elastic/helm-charts/issues/807
432519
[#839]: https://github.com/elastic/helm-charts/issues/839
433520
[#916]: https://github.com/elastic/helm-charts/pull/916
434-
[#1524]: https://github.com/elastic/helm-charts/pull/1524
521+
[#94]: https://github.com/elastic/helm-charts/pull/94
435522
[container input]: https://www.elastic.co/guide/en/beats/filebeat/7.7/filebeat-input-container.html
436523
[docker input]: https://www.elastic.co/guide/en/beats/filebeat/7.7/filebeat-input-docker.html
437524
[elastic blog post]: https://www.elastic.co/blog/licensing-change
438525
[elastic elasticsearch chart]: https://github.com/elastic/helm-charts/tree/main/elasticsearch
439526
[elastic helm repo]: https://helm.elastic.co
527+
[elasticsearch node roles doc]: https://www.elastic.co/guide/en/elasticsearch/reference/current/modules-node.html#node-roles
440528
[github releases]: https://github.com/elastic/helm-charts/releases
441529
[helm 2to3]: https://helm.sh/blog/migrate-from-helm-v2-to-helm-v3/
530+
[kube-state-metrics]: https://github.com/helm/charts/tree/master/stable/kube-state-metrics
442531
[migration guide]: https://github.com/elastic/helm-charts/blob/main/elasticsearch/examples/migration/README.md
443532
[new branching model]: https://github.com/elastic/helm-charts/blob/main/CONTRIBUTING.md#branching
444-
[kube-state-metrics]: https://github.com/helm/charts/tree/master/stable/kube-state-metrics
445-
[stable elasticsearch chart]: https://github.com/helm/charts/tree/master/stable/elasticsearch
446533
[stable elasticsearch chart notice]: https://github.com/helm/charts/tree/master/stable#elasticsearch#this-helm-chart-is-deprecated
534+
[stable elasticsearch chart]: https://github.com/helm/charts/tree/master/stable/elasticsearch

‎CHANGELOG.md

+7
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,12 @@
11
# Changelog
22

3+
## 8.5.1
4+
5+
* 8.5.1 as default version
6+
* See the [Breaking changes](./BREAKING_CHANGES.md) for a detailed list of changes.
7+
* 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...
8+
9+
310
## 7.17.3
411

512
* 7.17.3 as default version.

‎README.md

+59-50
Original file line numberDiff line numberDiff line change
@@ -6,59 +6,76 @@
66
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
77

88

9-
- [Charts](#charts)
109
- [Supported Configurations](#supported-configurations)
1110
- [Stack Versions](#stack-versions)
1211
- [Kubernetes Versions](#kubernetes-versions)
1312
- [Helm Versions](#helm-versions)
14-
- [ECK](#eck)
1513

1614
<!-- END doctoc generated TOC please keep comment here to allow auto update -->
1715
<!-- Use this to update TOC: -->
1816
<!-- docker run --entrypoint doctoc --rm -it -v $(pwd):/usr/src jorgeandrada/doctoc README.md --github --no-title -->
1917

20-
21-
## Charts
22-
2318
These Helm charts are designed to be a lightweight way to configure Elastic
2419
official Docker images.
2520

21+
> **Warning**
22+
> When it comes to running the Elastic on Kubernetes infrastructure, we
23+
> recommend [Elastic Cloud on Kubernetes][] (ECK) as the best way to run and manage
24+
> the Elastic Stack.
25+
>
26+
> ECK offers many operational benefits for both our basic-tier and our
27+
> enterprise-tier customers, such as spinning up cluster nodes that were lost on
28+
> failed infrastructure, seamless upgrades, rolling cluster changes, and much
29+
> much more.
30+
>
31+
> With the release of the Elastic Stack Helm charts for Elastic version 8.5.1,
32+
> we are handing over the ongoing maintenance of our Elastic Stack Helm charts
33+
> to the community and contributors. This repository will finally be archived
34+
> after 6 months time. Elastic Stacks deployed on Kubernetes through Helm charts
35+
> will still be fully supported under EOL limitations.
36+
>
37+
> Since we want to provide an even better experience for our customers by
38+
> running the Elastic Stack on Kubernetes, we will continue maintaining the
39+
> Helm charts applicable to ECK Custom Resources. These charts can be found in
40+
> the [ECK repository][eck-charts].
41+
>
42+
> Helm charts will currently be maintained for ECK Enterprise-tier customers,
43+
> however, we encourage the community to engage with the existing Helm charts
44+
> for the Elastic Stack and continue supporting their ongoing maintenance.
45+
>
46+
> See https://github.com/elastic/helm-charts/issues/1731 for more details.
47+
48+
2649
## Supported Configurations
2750

2851
We recommend that the Helm chart version is aligned to the version of the
29-
product you want to deploy. This will ensure that you are using a chart version
52+
product you want to deploy, when a chart release exists for the given stack
53+
version. This will ensure that you are using a chart version
3054
that has been tested against the corresponding production version.
3155
This will also ensure that the documentation and examples for the chart will
3256
work with the version of the product, you are installing.
3357

3458
For example, if you want to deploy an Elasticsearch `7.7.1` cluster, use the
3559
corresponding `7.7.1` [tag][elasticsearch-771].
3660

37-
However, we are not releasing new charts versions for each new patch version of
38-
the Elastic products, so if a chart for the latest patch version doesn't exist,
39-
you can use the latest chart with the same **MAJOR.MINOR** version and override
40-
the Docker image tag to the latest patch version with the `imageTag` value.
61+
However, we don't expect to release new charts versions, so if a chart for the
62+
latest patch version doesn't exist, you can use the latest chart with the same
63+
**MAJOR.MINOR** version and override the Docker image tag to the latest patch
64+
version with the `imageTag` value.
4165

4266
For example, if you want to deploy an Elasticsearch `7.17.5` cluster, use the
4367
corresponding `7.17.3` [tag][elasticsearch-7173], with `imageTag=7.17.5` value.
4468

45-
The `master` version of these charts is intended to support the latest
46-
pre-release versions of our products, and therefore may or may not work with
47-
current released versions.
48-
Note that only the released charts coming from [Elastic Helm repo][] or
49-
[GitHub releases][] are supported.
50-
51-
5269
### Stack Versions
5370

54-
| Chart | Latest 7 Version | Latest 6 Version |
55-
|--------------------------------------------|----------------------------------------------|------------------------------------|
56-
| [APM-Server](./apm-server/README.md) | [`7.17.3`][apm-7] (Beta since 7.7.0) | [`6.8.22`][apm-6] (Alpha) |
57-
| [Elasticsearch](./elasticsearch/README.md) | [`7.17.3`][elasticsearch-7] (GA since 7.7.0) | [`6.8.22`][elasticsearch-6] (Beta) |
58-
| [Filebeat](./filebeat/README.md) | [`7.17.3`][filebeat-7] (GA since 7.7.0) | [`6.8.22`][filebeat-6] (Beta) |
59-
| [Kibana](./kibana/README.md) | [`7.17.3`][kibana-7] (GA since 7.7.0) | [`6.8.22`][kibana-6] (Beta) |
60-
| [Logstash](./logstash/README.md) | [`7.17.3`][logstash-7] (Beta since 7.5.0) | [`6.8.22`][logstash-6] (Beta) |
61-
| [Metricbeat](./metricbeat/README.md) | [`7.17.3`][metricbeat-7] (GA since 7.7.0) | [`6.8.22`][metricbeat-6] (Beta) |
71+
| Chart | Latest 8 Version | Latest 7 Version | Latest 6 Version |
72+
|--------------------------------------------|---------------------------------------------|----------------------------------------------|------------------------------------|
73+
| [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) |
74+
| [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) |
75+
| [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) |
76+
| [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) |
77+
| [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) |
78+
| [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) |
6279

6380
### Kubernetes Versions
6481

@@ -71,36 +88,28 @@ exact versions are defined under `KUBERNETES_VERSIONS` in
7188
While we are checking backward compatibility, the charts are only tested with
7289
Helm version mentioned in [helm-tester Dockerfile][] (currently 3.10.2).
7390

74-
75-
## ECK
76-
77-
In addition to these Helm charts, Elastic also provides
78-
[Elastic Cloud on Kubernetes][] which is based on [Operator pattern][] and is
79-
Elastic recommended way to deploy Elasticsearch, Kibana, and APM Server on
80-
Kubernetes. There is a dedicated Helm chart for ECK which can be found
81-
[in ECK repo][eck-chart] ([documentation][eck-chart-doc]).
82-
83-
91+
[apm-6]: https://github.com/elastic/helm-charts/tree/6.8/apm-server/README.md
92+
[apm-7]: https://github.com/elastic/helm-charts/tree/7.17/apm-server/README.md
93+
[apm-8]: https://github.com/elastic/helm-charts/tree/main/apm-server/README.md
8494
[currently tested]: https://devops-ci.elastic.co/job/elastic+helm-charts+main/
85-
[eck-chart]: https://github.com/elastic/cloud-on-k8s/tree/master/deploy
86-
[eck-chart-doc]: https://www.elastic.co/guide/en/cloud-on-k8s/current/k8s-install-helm.html
95+
[eck-charts]: https://github.com/elastic/cloud-on-k8s/tree/master/deploy
8796
[elastic cloud on kubernetes]: https://github.com/elastic/cloud-on-k8s
88-
[elastic helm repo]: https://helm.elastic.co
89-
[github releases]: https://github.com/elastic/helm-charts/releases
90-
[helm-tester Dockerfile]: https://github.com/elastic/helm-charts/blob/main/helpers/helm-tester/Dockerfile
91-
[helpers/matrix.yml]: https://github.com/elastic/helm-charts/blob/main/helpers/matrix.yml
92-
[operator pattern]: https://kubernetes.io/docs/concepts/extend-kubernetes/operator/
97+
[elasticsearch-6]: https://github.com/elastic/helm-charts/tree/6.8/elasticsearch/README.md
98+
[elasticsearch-7]: https://github.com/elastic/helm-charts/tree/7.17/elasticsearch/README.md
9399
[elasticsearch-7173]: https://github.com/elastic/helm-charts/tree/7.17.3/elasticsearch/
94100
[elasticsearch-771]: https://github.com/elastic/helm-charts/tree/7.7.1/elasticsearch/
95-
[apm-7]: https://github.com/elastic/helm-charts/tree/7.17/apm-server/README.md
96-
[apm-6]: https://github.com/elastic/helm-charts/tree/6.8/apm-server/README.md
97-
[elasticsearch-7]: https://github.com/elastic/helm-charts/tree/7.17/elasticsearch/README.md
98-
[elasticsearch-6]: https://github.com/elastic/helm-charts/tree/6.8/elasticsearch/README.md
99-
[filebeat-7]: https://github.com/elastic/helm-charts/tree/7.17/filebeat/README.md
101+
[elasticsearch-8]: https://github.com/elastic/helm-charts/tree/main/elasticsearch/README.md
100102
[filebeat-6]: https://github.com/elastic/helm-charts/tree/6.8/filebeat/README.md
101-
[kibana-7]: https://github.com/elastic/helm-charts/tree/7.17/kibana/README.md
103+
[filebeat-7]: https://github.com/elastic/helm-charts/tree/7.17/filebeat/README.md
104+
[filebeat-8]: https://github.com/elastic/helm-charts/tree/main/filebeat/README.md
105+
[helm-tester Dockerfile]: https://github.com/elastic/helm-charts/blob/main/helpers/helm-tester/Dockerfile
106+
[helpers/matrix.yml]: https://github.com/elastic/helm-charts/blob/main/helpers/matrix.yml
102107
[kibana-6]: https://github.com/elastic/helm-charts/tree/6.8/kibana/README.md
103-
[logstash-7]: https://github.com/elastic/helm-charts/tree/7.17/logstash/README.md
108+
[kibana-7]: https://github.com/elastic/helm-charts/tree/7.17/kibana/README.md
109+
[kibana-8]: https://github.com/elastic/helm-charts/tree/main/kibana/README.md
104110
[logstash-6]: https://github.com/elastic/helm-charts/tree/6.8/logstash/README.md
105-
[metricbeat-7]: https://github.com/elastic/helm-charts/tree/7.17/metricbeat/README.md
111+
[logstash-7]: https://github.com/elastic/helm-charts/tree/7.17/logstash/README.md
112+
[logstash-8]: https://github.com/elastic/helm-charts/tree/main/logstash/README.md
106113
[metricbeat-6]: https://github.com/elastic/helm-charts/tree/6.8/metricbeat/README.md
114+
[metricbeat-7]: https://github.com/elastic/helm-charts/tree/7.17/metricbeat/README.md
115+
[metricbeat-8]: https://github.com/elastic/helm-charts/tree/main/metricbeat/README.md

‎apm-server/Chart.yaml

+2-2
Original file line numberDiff line numberDiff line change
@@ -5,8 +5,8 @@ maintainers:
55
- email: [email protected]
66
name: Elastic
77
name: apm-server
8-
version: 8.4.1
9-
appVersion: 8.4.1
8+
version: 8.5.1
9+
appVersion: 8.5.1
1010
sources:
1111
- https://github.com/elastic/apm
1212
icon: https://helm.elastic.co/icons/apm.png

0 commit comments

Comments
 (0)