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

Commit

Permalink
8.5.1 release (#1729)
Browse files Browse the repository at this point in the history 
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
  • Loading branch information
@jmlrt
jmlrt authored Nov 16, 2022
1 parent aa5e8d6 commit 0ae236b
Show file tree
Hide file tree
Showing 76 changed files with 446 additions and 202 deletions.
96 changes: 92 additions & 4 deletions BREAKING_CHANGES.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -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
Expand All @@ -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
7 changes: 7 additions & 0 deletions CHANGELOG.md
View file
Original file line number Diff line number Diff line change
@@ -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.
Expand Down
109 changes: 59 additions & 50 deletions README.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand All @@ -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
4 changes: 2 additions & 2 deletions apm-server/Chart.yaml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -5,8 +5,8 @@ maintainers:
- email: [email protected]
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
Loading

0 comments on commit 0ae236b

Please sign in to comment.