From 0ae236bc033a05b9e43f1ae5c196186e0d1473ff Mon Sep 17 00:00:00 2001 From: Julien Mailleret <8582351+jmlrt@users.noreply.github.com> Date: Wed, 16 Nov 2022 16:00:52 +0100 Subject: [PATCH] 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 https://github.com/elastic/helm-charts/issues/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 --- BREAKING_CHANGES.md | 96 ++++++++++++++- CHANGELOG.md | 7 ++ README.md | 109 ++++++++++-------- apm-server/Chart.yaml | 4 +- apm-server/README.md | 48 +++++--- apm-server/examples/default/README.md | 2 +- apm-server/examples/default/test/goss.yaml | 2 +- apm-server/examples/security/README.md | 2 +- apm-server/examples/security/test/goss.yaml | 2 +- apm-server/examples/upgrade/test/goss.yaml | 2 +- apm-server/values.yaml | 2 +- elasticsearch/Chart.yaml | 4 +- elasticsearch/README.md | 47 ++++++-- elasticsearch/examples/config/README.md | 2 +- elasticsearch/examples/default/README.md | 2 +- elasticsearch/examples/default/test/goss.yaml | 2 +- .../examples/docker-for-mac/README.md | 2 +- .../examples/kubernetes-kind/README.md | 2 +- elasticsearch/examples/microk8s/README.md | 2 +- elasticsearch/examples/minikube/README.md | 2 +- elasticsearch/examples/multi/README.md | 2 +- elasticsearch/examples/openshift/README.md | 2 +- .../examples/openshift/test/goss.yaml | 2 +- elasticsearch/examples/security/README.md | 2 +- elasticsearch/examples/upgrade/test/goss.yaml | 2 +- elasticsearch/values.yaml | 2 +- filebeat/Chart.yaml | 4 +- filebeat/README.md | 45 ++++++-- filebeat/examples/default/README.md | 2 +- filebeat/examples/default/test/goss.yaml | 2 +- filebeat/examples/deployment/README.md | 2 +- filebeat/examples/deployment/test/goss.yaml | 2 +- filebeat/examples/oss/README.md | 2 +- filebeat/examples/oss/test/goss.yaml | 2 +- filebeat/examples/security/README.md | 2 +- filebeat/examples/security/test/goss.yaml | 2 +- filebeat/examples/upgrade/test/goss.yaml | 2 +- filebeat/values.yaml | 2 +- helpers/bumper.py | 2 +- helpers/examples.mk | 2 +- helpers/upgrade.sh | 2 +- kibana/Chart.yaml | 4 +- kibana/README.md | 43 +++++-- kibana/examples/default/README.md | 2 +- kibana/examples/default/test/goss.yaml | 2 +- kibana/examples/openshift/README.md | 2 +- kibana/examples/security/README.md | 2 +- kibana/examples/security/test/goss.yaml | 2 +- kibana/examples/upgrade/test/goss.yaml | 2 +- kibana/values.yaml | 2 +- logstash/Chart.yaml | 4 +- logstash/README.md | 54 ++++++--- logstash/examples/default/README.md | 2 +- logstash/examples/default/test/goss.yaml | 2 +- logstash/examples/elasticsearch/README.md | 2 +- .../examples/elasticsearch/test/goss.yaml | 2 +- logstash/examples/oss/README.md | 2 +- logstash/examples/oss/test/goss.yaml | 2 +- logstash/examples/security/README.md | 2 +- logstash/examples/security/test/goss.yaml | 2 +- logstash/examples/upgrade/test/goss.yaml | 2 +- logstash/values.yaml | 2 +- metricbeat/Chart.yaml | 4 +- metricbeat/README.md | 47 ++++++-- metricbeat/examples/default/README.md | 2 +- .../examples/default/test/goss-metrics.yaml | 2 +- metricbeat/examples/default/test/goss.yaml | 4 +- metricbeat/examples/oss/README.md | 2 +- .../examples/oss/test/goss-metrics.yaml | 2 +- metricbeat/examples/oss/test/goss.yaml | 2 +- metricbeat/examples/security/README.md | 2 +- .../examples/security/test/goss-metrics.yaml | 4 +- metricbeat/examples/security/test/goss.yaml | 4 +- .../examples/upgrade/test/goss-metrics.yaml | 2 +- metricbeat/examples/upgrade/test/goss.yaml | 2 +- metricbeat/values.yaml | 2 +- 76 files changed, 446 insertions(+), 202 deletions(-) diff --git a/BREAKING_CHANGES.md b/BREAKING_CHANGES.md index f6a48f230..4b7b4314e 100644 --- a/BREAKING_CHANGES.md +++ b/BREAKING_CHANGES.md @@ -3,6 +3,13 @@ + - [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 @@ +## 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 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: + +- +- +- +- +- +- +- +- +- +- +- +- +- +- + +### 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: + +- +- +- +- + +### 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: + +- +- + +### 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 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 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 index 31867589e..7b94311ef 100644 --- 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 index e0aefdbe7..af175ba44 100644 --- a/README.md +++ b/README.md @@ -6,27 +6,51 @@ -- [Charts](#charts) - [Supported Configurations](#supported-configurations) - [Stack Versions](#stack-versions) - [Kubernetes Versions](#kubernetes-versions) - [Helm Versions](#helm-versions) -- [ECK](#eck) - -## 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. @@ -34,31 +58,24 @@ 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 index 95b242182..c8abf8bfb 100644 --- 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 diff --git a/apm-server/README.md b/apm-server/README.md index bd6fe9182..b0ee3a565 100644 --- a/apm-server/README.md +++ b/apm-server/README.md @@ -5,13 +5,32 @@ This Helm chart is a lightweight way to configure and run our official [APM Server Docker image][]. -**Warning**: This functionality is in alpha and is subject to change. -The design and code is less mature than official GA features and is being -provided as-is with no warranties. Alpha features are not subject to the support -SLA of official GA features (see [supported configurations][] for more details). - - -**Warning**: This branch is used for development, please use the latest [7.x][] release for released version. +> **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 for more details. @@ -52,7 +71,7 @@ See [supported configurations][] for more details. * Clone the git repo: `git clone git@github.com:elastic/helm-charts.git` -* Install it: `helm install apm-server ./helm-charts/apm-server --set imageTag=8.4.1` +* Install it: `helm install apm-server ./helm-charts/apm-server --set imageTag=8.5.1` ## Upgrading @@ -91,7 +110,7 @@ reference. They are also used in the automated testing of this chart. | `hostAliases` | Configurable [hostAliases][] | `[]` | | `imagePullPolicy` | The Kubernetes [imagePullPolicy][] value | `IfNotPresent` | | `imagePullSecrets` | Configuration for [imagePullSecrets][] so that you can use a private registry for your image | `[]` | -| `imageTag` | The APM Server Docker image tag | `8.4.1` | +| `imageTag` | The APM Server Docker image tag | `8.5.1` | | `image` | The APM Server Docker image | `docker.elastic.co/apm/apm-server` | | `ingress` | Configurable [ingress][] to expose the APM Server service | see [values.yaml][] | | `labels` | Configurable [labels][] applied to all APM server pods | `{}` | @@ -131,15 +150,16 @@ An example can be found in [examples/security][]. Please check [CONTRIBUTING.md][] before any contribution or for any questions about our development and testing process. -[7.x]: https://github.com/elastic/helm-charts/releases -[BREAKING_CHANGES.md]: https://github.com/elastic/helm-charts/blob/main/BREAKING_CHANGES.md -[CHANGELOG.md]: https://github.com/elastic/helm-charts/blob/main/CHANGELOG.md -[CONTRIBUTING.md]: https://github.com/elastic/helm-charts/blob/main/CONTRIBUTING.md [affinity]: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/#affinity-and-anti-affinity [annotations]: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations/ [apm server docker image]: https://www.elastic.co/guide/en/apm/server/current/running-on-docker.html -[environment variables]: https://kubernetes.io/docs/tasks/inject-data-application/define-environment-variable-container/#using-environment-variables-inside-of-your-config +[BREAKING_CHANGES.md]: https://github.com/elastic/helm-charts/blob/main/BREAKING_CHANGES.md +[CHANGELOG.md]: https://github.com/elastic/helm-charts/blob/main/CHANGELOG.md +[CONTRIBUTING.md]: https://github.com/elastic/helm-charts/blob/main/CONTRIBUTING.md +[eck-charts]: https://github.com/elastic/cloud-on-k8s/tree/master/deploy +[elastic cloud on kubernetes]: https://github.com/elastic/cloud-on-k8s [environment from variables]: https://kubernetes.io/docs/tasks/configure-pod-container/configure-pod-configmap/#configure-all-key-value-pairs-in-a-configmap-as-container-environment-variables +[environment variables]: https://kubernetes.io/docs/tasks/inject-data-application/define-environment-variable-container/#using-environment-variables-inside-of-your-config [examples]: https://github.com/elastic/helm-charts/tree/main/apm-server/examples [examples/security]: https://github.com/elastic/helm-charts/tree/main/apm-server/examples/security [horizontal pod autoscaler]: https://kubernetes.io/docs/tasks/run-application/horizontal-pod-autoscale/ diff --git a/apm-server/examples/default/README.md b/apm-server/examples/default/README.md index 89afce3ec..5b3e9679a 100644 --- a/apm-server/examples/default/README.md +++ b/apm-server/examples/default/README.md @@ -1,6 +1,6 @@ # Default -This example deploy APM Server 8.4.1 using [default values][]. +This example deploy APM Server 8.5.1 using [default values][]. ## Usage diff --git a/apm-server/examples/default/test/goss.yaml b/apm-server/examples/default/test/goss.yaml index 2e6e82690..4569b0f38 100644 --- a/apm-server/examples/default/test/goss.yaml +++ b/apm-server/examples/default/test/goss.yaml @@ -3,4 +3,4 @@ http: status: 200 timeout: 2000 body: - - "8.4.1" + - "8.5.1" diff --git a/apm-server/examples/security/README.md b/apm-server/examples/security/README.md index 2ba9c06b9..00dba76cd 100644 --- a/apm-server/examples/security/README.md +++ b/apm-server/examples/security/README.md @@ -1,6 +1,6 @@ # Security -This example deploy APM Server 8.4.1 using authentication and TLS to connect to +This example deploy APM Server 8.5.1 using authentication and TLS to connect to Elasticsearch (see [values][]). diff --git a/apm-server/examples/security/test/goss.yaml b/apm-server/examples/security/test/goss.yaml index 2e6e82690..4569b0f38 100644 --- a/apm-server/examples/security/test/goss.yaml +++ b/apm-server/examples/security/test/goss.yaml @@ -3,4 +3,4 @@ http: status: 200 timeout: 2000 body: - - "8.4.1" + - "8.5.1" diff --git a/apm-server/examples/upgrade/test/goss.yaml b/apm-server/examples/upgrade/test/goss.yaml index 2e6e82690..4569b0f38 100644 --- a/apm-server/examples/upgrade/test/goss.yaml +++ b/apm-server/examples/upgrade/test/goss.yaml @@ -3,4 +3,4 @@ http: status: 200 timeout: 2000 body: - - "8.4.1" + - "8.5.1" diff --git a/apm-server/values.yaml b/apm-server/values.yaml index 53ca70ba7..075a468f2 100644 --- a/apm-server/values.yaml +++ b/apm-server/values.yaml @@ -66,7 +66,7 @@ hostAliases: [] # - "bar.local" image: "docker.elastic.co/apm/apm-server" -imageTag: "8.4.1" +imageTag: "8.5.1" imagePullPolicy: "IfNotPresent" imagePullSecrets: [] diff --git a/elasticsearch/Chart.yaml b/elasticsearch/Chart.yaml index 0d10900c0..713c6de81 100644 --- a/elasticsearch/Chart.yaml +++ b/elasticsearch/Chart.yaml @@ -5,8 +5,8 @@ maintainers: - email: helm-charts@elastic.co name: Elastic name: elasticsearch -version: 8.4.1 -appVersion: 8.4.1 +version: 8.5.1 +appVersion: 8.5.1 sources: - https://github.com/elastic/elasticsearch icon: https://helm.elastic.co/icons/elasticsearch.png diff --git a/elasticsearch/README.md b/elasticsearch/README.md index 6136087bb..a4948bda4 100644 --- a/elasticsearch/README.md +++ b/elasticsearch/README.md @@ -5,8 +5,32 @@ This Helm chart is a lightweight way to configure and run our official [Elasticsearch Docker image][]. - -**Warning**: This branch is used for development, please use the latest [7.x][] release for released version. +> **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 for more details. @@ -63,7 +87,7 @@ See [supported configurations][] for more details. * Clone the git repo: `git clone git@github.com:elastic/helm-charts.git` -* Install it: `helm install elasticsearch ./helm-charts/elasticsearch --set imageTag=8.4.1` +* Install it: `helm install elasticsearch ./helm-charts/elasticsearch --set imageTag=8.5.1` ## Upgrading @@ -122,7 +146,7 @@ support multiple versions with minimal changes. | `httpPort` | The http port that Kubernetes will use for the healthchecks and the service. If you change this you will also need to set [http.port][] in `extraEnvs` | `9200` | | `imagePullPolicy` | The Kubernetes [imagePullPolicy][] value | `IfNotPresent` | | `imagePullSecrets` | Configuration for [imagePullSecrets][] so that you can use a private registry for your image | `[]` | -| `imageTag` | The Elasticsearch Docker image tag | `8.4.1` | +| `imageTag` | The Elasticsearch Docker image tag | `8.5.1` | | `image` | The Elasticsearch Docker image | `docker.elastic.co/elasticsearch/elasticsearch` | | `ingress` | Configurable [ingress][] to expose the Elasticsearch service. See [values.yaml][] for an example | see [values.yaml][] | | `initResources` | Allows you to set the [resources][] for the `initContainer` in the StatefulSet | `{}` | @@ -393,32 +417,34 @@ lifecycle: Please check [CONTRIBUTING.md][] before any contribution or for any questions about our development and testing process. -[7.x]: https://github.com/elastic/helm-charts/releases [#1186 (comment)]: https://github.com/elastic/helm-charts/pull/1186#discussion_r631166442 -[BREAKING_CHANGES.md]: https://github.com/elastic/helm-charts/blob/main/BREAKING_CHANGES.md -[CHANGELOG.md]: https://github.com/elastic/helm-charts/blob/main/CHANGELOG.md -[CONTRIBUTING.md]: https://github.com/elastic/helm-charts/blob/main/CONTRIBUTING.md [alternate scheduler]: https://kubernetes.io/docs/tasks/administer-cluster/configure-multiple-schedulers/#specify-schedulers-for-pods [annotations]: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations/ [anti-affinity]: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/#affinity-and-anti-affinity +[BREAKING_CHANGES.md]: https://github.com/elastic/helm-charts/blob/main/BREAKING_CHANGES.md +[CHANGELOG.md]: https://github.com/elastic/helm-charts/blob/main/CHANGELOG.md [cluster.name]: https://www.elastic.co/guide/en/elasticsearch/reference/current/cluster.name.html [clustering and node discovery]: https://github.com/elastic/helm-charts/blob/main/elasticsearch/README.md#clustering-and-node-discovery [config example]: https://github.com/elastic/helm-charts/blob/main/elasticsearch/examples/config/values.yaml +[CONTRIBUTING.md]: https://github.com/elastic/helm-charts/blob/main/CONTRIBUTING.md [curator]: https://www.elastic.co/guide/en/elasticsearch/client/curator/current/snapshot.html [custom docker image]: https://www.elastic.co/guide/en/elasticsearch/reference/current/docker.html#_c_customized_image [deploys statefulsets serially]: https://kubernetes.io/docs/concepts/workloads/controllers/statefulset/#pod-management-policies [discovery.zen.minimum_master_nodes]: https://www.elastic.co/guide/en/elasticsearch/reference/current/discovery-settings.html#minimum_master_nodes [docker for mac]: https://github.com/elastic/helm-charts/tree/main/elasticsearch/examples/docker-for-mac +[eck-charts]: https://github.com/elastic/cloud-on-k8s/tree/master/deploy +[elastic cloud on kubernetes]: https://github.com/elastic/cloud-on-k8s [elasticsearch cluster health status params]: https://www.elastic.co/guide/en/elasticsearch/reference/current/cluster-health.html#request-params [elasticsearch docker image]: https://www.elastic.co/guide/en/elasticsearch/reference/current/docker.html -[environment variables]: https://kubernetes.io/docs/tasks/inject-data-application/define-environment-variable-container/#using-environment-variables-inside-of-your-config [environment from variables]: https://kubernetes.io/docs/tasks/configure-pod-container/configure-pod-configmap/#configure-all-key-value-pairs-in-a-configmap-as-container-environment-variables +[environment variables]: https://kubernetes.io/docs/tasks/inject-data-application/define-environment-variable-container/#using-environment-variables-inside-of-your-config [examples]: https://github.com/elastic/helm-charts/tree/main/elasticsearch/examples/ [examples/multi]: https://github.com/elastic/helm-charts/tree/main/elasticsearch/examples/multi [examples/security]: https://github.com/elastic/helm-charts/tree/main/elasticsearch/examples/security [gke]: https://cloud.google.com/kubernetes-engine [helm]: https://helm.sh [helm/charts stable]: https://github.com/helm/charts/tree/master/stable/elasticsearch/ +[hostAliases]: https://kubernetes.io/docs/concepts/services-networking/add-entries-to-pod-etc-hosts-with-host-aliases/ [how to install plugins guide]: https://github.com/elastic/helm-charts/blob/main/elasticsearch/README.md#how-to-install-plugins [how to use the keystore]: https://github.com/elastic/helm-charts/blob/main/elasticsearch/README.md#how-to-use-the-keystore [http.port]: https://www.elastic.co/guide/en/elasticsearch/reference/current/modules-http.html#_settings @@ -427,7 +453,6 @@ about our development and testing process. [ingress]: https://kubernetes.io/docs/concepts/services-networking/ingress/ [java options]: https://www.elastic.co/guide/en/elasticsearch/reference/current/jvm-options.html [jvm heap size]: https://www.elastic.co/guide/en/elasticsearch/reference/current/heap-size.html -[hostAliases]: https://kubernetes.io/docs/concepts/services-networking/add-entries-to-pod-etc-hosts-with-host-aliases/ [kind]: https://github.com/elastic/helm-charts/tree/main//elasticsearch/examples/kubernetes-kind [labels]: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/ [lifecycle hooks]: https://kubernetes.io/docs/concepts/containers/container-lifecycle-hooks/ @@ -435,9 +460,9 @@ about our development and testing process. [loadBalancer externalTrafficPolicy]: https://kubernetes.io/docs/tasks/access-application-cluster/create-external-load-balancer/#preserving-the-client-source-ip [loadBalancer]: https://kubernetes.io/docs/concepts/services-networking/service/#loadbalancer [maxUnavailable]: https://kubernetes.io/docs/tasks/run-application/configure-pdb/#specifying-a-poddisruptionbudget +[microk8s]: https://github.com/elastic/helm-charts/tree/main/elasticsearch/examples/microk8s [migration guide]: https://github.com/elastic/helm-charts/blob/main/elasticsearch/examples/migration/README.md [minikube]: https://github.com/elastic/helm-charts/tree/main/elasticsearch/examples/minikube -[microk8s]: https://github.com/elastic/helm-charts/tree/main/elasticsearch/examples/microk8s [multi]: https://github.com/elastic/helm-charts/tree/main/elasticsearch/examples/multi/ [network.host elasticsearch setting]: https://www.elastic.co/guide/en/elasticsearch/reference/current/network.host.html [node affinity settings]: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/#node-affinity-beta-feature diff --git a/elasticsearch/examples/config/README.md b/elasticsearch/examples/config/README.md index e2ce8b1fc..76dd0451b 100644 --- a/elasticsearch/examples/config/README.md +++ b/elasticsearch/examples/config/README.md @@ -1,6 +1,6 @@ # Config -This example deploy a single node Elasticsearch 8.4.1 with authentication and +This example deploy a single node Elasticsearch 8.5.1 with authentication and custom [values][]. diff --git a/elasticsearch/examples/default/README.md b/elasticsearch/examples/default/README.md index 23824c15d..6a82ee200 100644 --- a/elasticsearch/examples/default/README.md +++ b/elasticsearch/examples/default/README.md @@ -1,6 +1,6 @@ # Default -This example deploy a 3 nodes Elasticsearch 8.4.1 cluster using +This example deploy a 3 nodes Elasticsearch 8.5.1 cluster using [default values][]. diff --git a/elasticsearch/examples/default/test/goss.yaml b/elasticsearch/examples/default/test/goss.yaml index c6ff486ca..925203b46 100644 --- a/elasticsearch/examples/default/test/goss.yaml +++ b/elasticsearch/examples/default/test/goss.yaml @@ -21,7 +21,7 @@ http: username: elastic password: "{{ .Env.ELASTIC_PASSWORD }}" body: - - '"number" : "8.4.1"' + - '"number" : "8.5.1"' - '"cluster_name" : "elasticsearch"' - "You Know, for Search" diff --git a/elasticsearch/examples/docker-for-mac/README.md b/elasticsearch/examples/docker-for-mac/README.md index ddf07ad49..3fec05d1f 100644 --- a/elasticsearch/examples/docker-for-mac/README.md +++ b/elasticsearch/examples/docker-for-mac/README.md @@ -1,6 +1,6 @@ # Docker for Mac -This example deploy a 3 nodes Elasticsearch 8.4.1 cluster on [Docker for Mac][] +This example deploy a 3 nodes Elasticsearch 8.5.1 cluster on [Docker for Mac][] using [custom values][]. Note that this configuration should be used for test only and isn't recommended diff --git a/elasticsearch/examples/kubernetes-kind/README.md b/elasticsearch/examples/kubernetes-kind/README.md index 4a9bdc60c..431cde3ad 100644 --- a/elasticsearch/examples/kubernetes-kind/README.md +++ b/elasticsearch/examples/kubernetes-kind/README.md @@ -1,6 +1,6 @@ # KIND -This example deploy a 3 nodes Elasticsearch 8.4.1 cluster on [Kind][] +This example deploy a 3 nodes Elasticsearch 8.5.1 cluster on [Kind][] using [custom values][]. Note that this configuration should be used for test only and isn't recommended diff --git a/elasticsearch/examples/microk8s/README.md b/elasticsearch/examples/microk8s/README.md index a717ba997..db5d65882 100644 --- a/elasticsearch/examples/microk8s/README.md +++ b/elasticsearch/examples/microk8s/README.md @@ -1,6 +1,6 @@ # MicroK8S -This example deploy a 3 nodes Elasticsearch 8.4.1 cluster on [MicroK8S][] +This example deploy a 3 nodes Elasticsearch 8.5.1 cluster on [MicroK8S][] using [custom values][]. Note that this configuration should be used for test only and isn't recommended diff --git a/elasticsearch/examples/minikube/README.md b/elasticsearch/examples/minikube/README.md index 6c84728ef..5d7e6e2fd 100644 --- a/elasticsearch/examples/minikube/README.md +++ b/elasticsearch/examples/minikube/README.md @@ -1,6 +1,6 @@ # Minikube -This example deploy a 3 nodes Elasticsearch 8.4.1 cluster on [Minikube][] +This example deploy a 3 nodes Elasticsearch 8.5.1 cluster on [Minikube][] using [custom values][]. If helm or kubectl timeouts occur, you may consider creating a minikube VM with diff --git a/elasticsearch/examples/multi/README.md b/elasticsearch/examples/multi/README.md index 2347c705f..bfc5e30f9 100644 --- a/elasticsearch/examples/multi/README.md +++ b/elasticsearch/examples/multi/README.md @@ -1,6 +1,6 @@ # Multi -This example deploy an Elasticsearch 8.4.1 cluster composed of 3 different Helm +This example deploy an Elasticsearch 8.5.1 cluster composed of 3 different Helm releases: - `helm-es-multi-master` for the 3 master nodes using [master values][] diff --git a/elasticsearch/examples/openshift/README.md b/elasticsearch/examples/openshift/README.md index d71093d51..22ccf72d0 100644 --- a/elasticsearch/examples/openshift/README.md +++ b/elasticsearch/examples/openshift/README.md @@ -1,6 +1,6 @@ # OpenShift -This example deploy a 3 nodes Elasticsearch 8.4.1 cluster on [OpenShift][] +This example deploy a 3 nodes Elasticsearch 8.5.1 cluster on [OpenShift][] using [custom values][]. ## Usage diff --git a/elasticsearch/examples/openshift/test/goss.yaml b/elasticsearch/examples/openshift/test/goss.yaml index 0948fb558..af536ec7f 100644 --- a/elasticsearch/examples/openshift/test/goss.yaml +++ b/elasticsearch/examples/openshift/test/goss.yaml @@ -15,6 +15,6 @@ http: username: elastic password: "{{ .Env.ELASTIC_PASSWORD }}" body: - - '"number" : "8.4.1"' + - '"number" : "8.5.1"' - '"cluster_name" : "elasticsearch"' - "You Know, for Search" diff --git a/elasticsearch/examples/security/README.md b/elasticsearch/examples/security/README.md index 012356f15..328fefa7a 100644 --- a/elasticsearch/examples/security/README.md +++ b/elasticsearch/examples/security/README.md @@ -1,6 +1,6 @@ # Security -This example deploy a 3 nodes Elasticsearch 8.4.1 with authentication and +This example deploy a 3 nodes Elasticsearch 8.5.1 with authentication and autogenerated certificates for TLS (see [values][]). Note that this configuration should be used for test only. For a production diff --git a/elasticsearch/examples/upgrade/test/goss.yaml b/elasticsearch/examples/upgrade/test/goss.yaml index 8a3c0ef64..b730456cc 100644 --- a/elasticsearch/examples/upgrade/test/goss.yaml +++ b/elasticsearch/examples/upgrade/test/goss.yaml @@ -17,6 +17,6 @@ http: allow-insecure: true timeout: 2000 body: - - '"number" : "8.4.1"' + - '"number" : "8.5.1"' - '"cluster_name" : "upgrade"' - "You Know, for Search" diff --git a/elasticsearch/values.yaml b/elasticsearch/values.yaml index 04e509f19..4143d619c 100644 --- a/elasticsearch/values.yaml +++ b/elasticsearch/values.yaml @@ -76,7 +76,7 @@ hostAliases: [] # - "bar.local" image: "docker.elastic.co/elasticsearch/elasticsearch" -imageTag: "8.4.1" +imageTag: "8.5.1" imagePullPolicy: "IfNotPresent" podAnnotations: {} diff --git a/filebeat/Chart.yaml b/filebeat/Chart.yaml index cb3e8e40b..ad563c42d 100644 --- a/filebeat/Chart.yaml +++ b/filebeat/Chart.yaml @@ -5,8 +5,8 @@ maintainers: - email: helm-charts@elastic.co name: Elastic name: filebeat -version: 8.4.1 -appVersion: 8.4.1 +version: 8.5.1 +appVersion: 8.5.1 sources: - https://github.com/elastic/beats icon: https://helm.elastic.co/icons/beats.png diff --git a/filebeat/README.md b/filebeat/README.md index 351b14865..f2285e852 100644 --- a/filebeat/README.md +++ b/filebeat/README.md @@ -5,8 +5,32 @@ This Helm chart is a lightweight way to configure and run our official [Filebeat Docker image][]. - -**Warning**: This branch is used for development, please use the latest [7.x][] release for released version. +> **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 for more details. @@ -51,7 +75,7 @@ See [supported configurations][] for more details. * Clone the git repo: `git clone git@github.com:elastic/helm-charts.git` -* Install it: `helm install filebeat ./helm-charts/filebeat --set imageTag=8.4.1` +* Install it: `helm install filebeat ./helm-charts/filebeat --set imageTag=8.5.1` ## Upgrading @@ -128,7 +152,7 @@ as a reference. They are also used in the automated testing of this chart. | `hostPathRoot` | Fully-qualified [hostPath][] that will be used to persist filebeat registry data | `/var/lib` | | `imagePullPolicy` | The Kubernetes [imagePullPolicy][] value | `IfNotPresent` | | `imagePullSecrets` | Configuration for [imagePullSecrets][] so that you can use a private registry for your image | `[]` | -| `imageTag` | The filebeat Docker image tag | `8.4.1` | +| `imageTag` | The filebeat Docker image tag | `8.5.1` | | `image` | The filebeat Docker image | `docker.elastic.co/beats/filebeat` | | `livenessProbe` | Parameters to pass to liveness [probe][] checks for values such as timeouts and thresholds | see [values.yaml][] | | `managedServiceAccount` | Whether the `serviceAccount` should be managed by this helm chart. Set this to `false` in order to manage your own service account and related roles | `true` | @@ -209,15 +233,16 @@ readinessProbe: Please check [CONTRIBUTING.md][] before any contribution or for any questions about our development and testing process. -[7.x]: https://github.com/elastic/helm-charts/releases -[BREAKING_CHANGES.md]: https://github.com/elastic/helm-charts/blob/main/BREAKING_CHANGES.md -[CHANGELOG.md]: https://github.com/elastic/helm-charts/blob/main/CHANGELOG.md -[CONTRIBUTING.md]: https://github.com/elastic/helm-charts/blob/main/CONTRIBUTING.md [affinity]: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/#affinity-and-anti-affinity [annotations]: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations/ +[BREAKING_CHANGES.md]: https://github.com/elastic/helm-charts/blob/main/BREAKING_CHANGES.md +[CHANGELOG.md]: https://github.com/elastic/helm-charts/blob/main/CHANGELOG.md [cluster role rules]: https://kubernetes.io/docs/reference/access-authn-authz/rbac/#role-and-clusterrole -[environment variables]: https://kubernetes.io/docs/tasks/inject-data-application/define-environment-variable-container/#using-environment-variables-inside-of-your-config +[CONTRIBUTING.md]: https://github.com/elastic/helm-charts/blob/main/CONTRIBUTING.md +[eck-charts]: https://github.com/elastic/cloud-on-k8s/tree/master/deploy +[elastic cloud on kubernetes]: https://github.com/elastic/cloud-on-k8s [environment from variables]: https://kubernetes.io/docs/tasks/configure-pod-container/configure-pod-configmap/#configure-all-key-value-pairs-in-a-configmap-as-container-environment-variables +[environment variables]: https://kubernetes.io/docs/tasks/inject-data-application/define-environment-variable-container/#using-environment-variables-inside-of-your-config [examples]: https://github.com/elastic/helm-charts/tree/main/filebeat/examples [examples/oss]: https://github.com/elastic/helm-charts/tree/main/filebeat/examples/oss [examples/security]: https://github.com/elastic/helm-charts/tree/main/filebeat/examples/security @@ -238,8 +263,8 @@ about our development and testing process. [priorityClass]: https://kubernetes.io/docs/concepts/configuration/pod-priority-preemption/#priorityclass [probe]: https://kubernetes.io/docs/tasks/configure-pod-container/configure-liveness-readiness-probes/ [resources]: https://kubernetes.io/docs/concepts/configuration/manage-compute-resources-container/ -[supported configurations]: https://github.com/elastic/helm-charts/tree/main/README.md#supported-configurations [serviceAccount]: https://kubernetes.io/docs/tasks/configure-pod-container/configure-service-account/ +[supported configurations]: https://github.com/elastic/helm-charts/tree/main/README.md#supported-configurations [tolerations]: https://kubernetes.io/docs/concepts/configuration/taint-and-toleration/ [updateStrategy]: https://kubernetes.io/docs/tasks/manage-daemon/update-daemon-set/#daemonset-update-strategy [values.yaml]: https://github.com/elastic/helm-charts/tree/main/filebeat/values.yaml diff --git a/filebeat/examples/default/README.md b/filebeat/examples/default/README.md index 84ea21ac5..8a40b32f2 100644 --- a/filebeat/examples/default/README.md +++ b/filebeat/examples/default/README.md @@ -1,6 +1,6 @@ # Default -This example deploy Filebeat 8.4.1 using [default values][]. +This example deploy Filebeat 8.5.1 using [default values][]. ## Usage diff --git a/filebeat/examples/default/test/goss.yaml b/filebeat/examples/default/test/goss.yaml index c2f96a1a6..2362a1f4f 100644 --- a/filebeat/examples/default/test/goss.yaml +++ b/filebeat/examples/default/test/goss.yaml @@ -32,7 +32,7 @@ http: username: "{{ .Env.ELASTICSEARCH_USERNAME }}" password: "{{ .Env.ELASTICSEARCH_PASSWORD }}" body: - - "filebeat-8.4.1" + - "filebeat-8.5.1" file: /usr/share/filebeat/filebeat.yml: diff --git a/filebeat/examples/deployment/README.md b/filebeat/examples/deployment/README.md index fe99b8490..1bdf3faa6 100644 --- a/filebeat/examples/deployment/README.md +++ b/filebeat/examples/deployment/README.md @@ -1,6 +1,6 @@ # Default -This example deploy Filebeat 8.4.1 using [default values][] as a Kubernetes Deployment. +This example deploy Filebeat 8.5.1 using [default values][] as a Kubernetes Deployment. ## Usage diff --git a/filebeat/examples/deployment/test/goss.yaml b/filebeat/examples/deployment/test/goss.yaml index 6cd7bf22a..a16db96d7 100644 --- a/filebeat/examples/deployment/test/goss.yaml +++ b/filebeat/examples/deployment/test/goss.yaml @@ -6,4 +6,4 @@ http: username: "{{ .Env.ELASTICSEARCH_USERNAME }}" password: "{{ .Env.ELASTICSEARCH_PASSWORD }}" body: - - "filebeat-8.4.1" + - "filebeat-8.5.1" diff --git a/filebeat/examples/oss/README.md b/filebeat/examples/oss/README.md index 25c3530cb..ad417e06e 100644 --- a/filebeat/examples/oss/README.md +++ b/filebeat/examples/oss/README.md @@ -1,6 +1,6 @@ # OSS -This example deploy Filebeat 8.4.1 using [Filebeat OSS][] version. +This example deploy Filebeat 8.5.1 using [Filebeat OSS][] version. ## Usage diff --git a/filebeat/examples/oss/test/goss.yaml b/filebeat/examples/oss/test/goss.yaml index 08001334a..adba6b686 100644 --- a/filebeat/examples/oss/test/goss.yaml +++ b/filebeat/examples/oss/test/goss.yaml @@ -22,4 +22,4 @@ http: username: "{{ .Env.ELASTICSEARCH_USERNAME }}" password: "{{ .Env.ELASTICSEARCH_PASSWORD }}" body: - - "filebeat-oss-8.4.1" + - "filebeat-oss-8.5.1" diff --git a/filebeat/examples/security/README.md b/filebeat/examples/security/README.md index c2246ed05..3f22091fa 100644 --- a/filebeat/examples/security/README.md +++ b/filebeat/examples/security/README.md @@ -1,6 +1,6 @@ # Security -This example deploy Filebeat 8.4.1 using authentication and TLS to connect to +This example deploy Filebeat 8.5.1 using authentication and TLS to connect to Elasticsearch (see [values][]). diff --git a/filebeat/examples/security/test/goss.yaml b/filebeat/examples/security/test/goss.yaml index fb283c11f..daf4656cf 100644 --- a/filebeat/examples/security/test/goss.yaml +++ b/filebeat/examples/security/test/goss.yaml @@ -3,7 +3,7 @@ http: status: 200 timeout: 2000 body: - - "filebeat-8.4.1" + - "filebeat-8.5.1" allow-insecure: true username: "{{ .Env.ELASTICSEARCH_USERNAME }}" password: "{{ .Env.ELASTICSEARCH_PASSWORD }}" diff --git a/filebeat/examples/upgrade/test/goss.yaml b/filebeat/examples/upgrade/test/goss.yaml index 90d0a1b40..33713ac62 100644 --- a/filebeat/examples/upgrade/test/goss.yaml +++ b/filebeat/examples/upgrade/test/goss.yaml @@ -30,7 +30,7 @@ http: allow-insecure: true timeout: 2000 body: - - "filebeat-8.4.1" + - "filebeat-8.5.1" username: "{{ .Env.ELASTICSEARCH_USERNAME }}" password: "{{ .Env.ELASTICSEARCH_PASSWORD }}" diff --git a/filebeat/values.yaml b/filebeat/values.yaml index 05a363fa4..f27bd0c07 100644 --- a/filebeat/values.yaml +++ b/filebeat/values.yaml @@ -177,7 +177,7 @@ hostAliases: [] # - "foo.local" # - "bar.local" image: "docker.elastic.co/beats/filebeat" -imageTag: "8.4.1" +imageTag: "8.5.1" imagePullPolicy: "IfNotPresent" imagePullSecrets: [] diff --git a/helpers/bumper.py b/helpers/bumper.py index e3c44a975..786f71bac 100755 --- a/helpers/bumper.py +++ b/helpers/bumper.py @@ -16,7 +16,7 @@ os.chdir(os.path.join(os.path.dirname(__file__), "..")) -version = "8.4.1" +version = "8.5.1" major = "8" chart_version = version diff --git a/helpers/examples.mk b/helpers/examples.mk index e7957dcb2..4e03f84e3 100644 --- a/helpers/examples.mk +++ b/helpers/examples.mk @@ -2,7 +2,7 @@ SHELL := /bin/bash GOSS_VERSION := v0.3.18 GOSS_FILE ?= goss.yaml GOSS_SELECTOR ?= release=$(RELEASE) -STACK_VERSION := 8.4.1 +STACK_VERSION := 8.5.1 TIMEOUT := 900s .PHONY: help diff --git a/helpers/upgrade.sh b/helpers/upgrade.sh index 44c925e51..6dbd66ac4 100755 --- a/helpers/upgrade.sh +++ b/helpers/upgrade.sh @@ -5,7 +5,7 @@ # # An optional version can be specified for Docker image tag to use for upgrade. # This is required for main branch because upgrade from Elasticsearch 7.X -# to 8.4.1 doesn't work. +# to 8.5.1 doesn't work. # set -euo pipefail diff --git a/kibana/Chart.yaml b/kibana/Chart.yaml index 4be23c7ea..fd4cc4472 100644 --- a/kibana/Chart.yaml +++ b/kibana/Chart.yaml @@ -5,8 +5,8 @@ maintainers: - email: helm-charts@elastic.co name: Elastic name: kibana -version: 8.4.1 -appVersion: 8.4.1 +version: 8.5.1 +appVersion: 8.5.1 sources: - https://github.com/elastic/kibana icon: https://helm.elastic.co/icons/kibana.png diff --git a/kibana/README.md b/kibana/README.md index ee7a9097e..f8603dccd 100644 --- a/kibana/README.md +++ b/kibana/README.md @@ -5,8 +5,32 @@ This Helm chart is a lightweight way to configure and run our official [Kibana Docker image][]. - -**Warning**: This branch is used for development, please use the latest [7.x][] release for released version. +> **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 for more details. @@ -50,7 +74,7 @@ See [supported configurations][] for more details. * Clone the git repo: `git clone git@github.com:elastic/helm-charts.git` -* Install it: `helm install kibana ./helm-charts/kibana --set imageTag=8.4.1` +* Install it: `helm install kibana ./helm-charts/kibana --set imageTag=8.5.1` ## Upgrading @@ -90,7 +114,7 @@ as a reference. They are also used in the automated testing of this chart. | `httpPort` | The http port that Kubernetes will use for the healthchecks and the service | `5601` | | `imagePullPolicy` | The Kubernetes [imagePullPolicy][]value | `IfNotPresent` | | `imagePullSecrets` | Configuration for [imagePullSecrets][] so that you can use a private registry for your image | `[]` | -| `imageTag` | The Kibana Docker image tag | `8.4.1` | +| `imageTag` | The Kibana Docker image tag | `8.5.1` | | `image` | The Kibana Docker image | `docker.elastic.co/kibana/kibana` | | `ingress` | Configurable [ingress][] to expose the Kibana service. | see [values.yaml][] | | `kibanaConfig` | Allows you to add any config files in `/usr/share/kibana/config/` such as `kibana.yml` See [values.yaml][] for an example of the formatting | `{}` | @@ -203,16 +227,17 @@ lifecycle: Please check [CONTRIBUTING.md][] before any contribution or for any questions about our development and testing process. -[7.x]: https://github.com/elastic/helm-charts/releases -[BREAKING_CHANGES.md]: https://github.com/elastic/helm-charts/blob/main/BREAKING_CHANGES.md -[CHANGELOG.md]: https://github.com/elastic/helm-charts/blob/main/CHANGELOG.md -[CONTRIBUTING.md]: https://github.com/elastic/helm-charts/blob/main/CONTRIBUTING.md [affinity]: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/#affinity-and-anti-affinity [annotations]: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations/ +[BREAKING_CHANGES.md]: https://github.com/elastic/helm-charts/blob/main/BREAKING_CHANGES.md +[CHANGELOG.md]: https://github.com/elastic/helm-charts/blob/main/CHANGELOG.md [chart notes]: https://github.com/elastic/helm-charts/tree/main/kibana/templates/NOTES.txt +[CONTRIBUTING.md]: https://github.com/elastic/helm-charts/blob/main/CONTRIBUTING.md [default elasticsearch helm chart]: https://github.com/elastic/helm-charts/tree/main/elasticsearch/README.md#default -[environment variables]: https://kubernetes.io/docs/tasks/inject-data-application/define-environment-variable-container/#using-environment-variables-inside-of-your-config +[eck-charts]: https://github.com/elastic/cloud-on-k8s/tree/master/deploy +[elastic cloud on kubernetes]: https://github.com/elastic/cloud-on-k8s [environment from variables]: https://kubernetes.io/docs/tasks/configure-pod-container/configure-pod-configmap/#configure-all-key-value-pairs-in-a-configmap-as-container-environment-variables +[environment variables]: https://kubernetes.io/docs/tasks/inject-data-application/define-environment-variable-container/#using-environment-variables-inside-of-your-config [examples]: https://github.com/elastic/helm-charts/tree/main/kibana/examples [examples/security]: https://github.com/elastic/helm-charts/tree/main/kibana/examples/security [gke]: https://cloud.google.com/kubernetes-engine diff --git a/kibana/examples/default/README.md b/kibana/examples/default/README.md index 30b0db53e..1293583b0 100644 --- a/kibana/examples/default/README.md +++ b/kibana/examples/default/README.md @@ -1,6 +1,6 @@ # Default -This example deploy Kibana 8.4.1 using [default values][]. +This example deploy Kibana 8.5.1 using [default values][]. ## Usage diff --git a/kibana/examples/default/test/goss.yaml b/kibana/examples/default/test/goss.yaml index c998a98d1..4686f7923 100644 --- a/kibana/examples/default/test/goss.yaml +++ b/kibana/examples/default/test/goss.yaml @@ -5,7 +5,7 @@ http: request-headers: - "Authorization: Bearer {{ .Env.ELASTICSEARCH_SERVICEACCOUNTTOKEN}}" body: - - '"number":"8.4.1"' + - '"number":"8.5.1"' http://localhost:5601/app/kibana: status: 200 diff --git a/kibana/examples/openshift/README.md b/kibana/examples/openshift/README.md index 470716a0f..8a7a655cb 100644 --- a/kibana/examples/openshift/README.md +++ b/kibana/examples/openshift/README.md @@ -1,6 +1,6 @@ # OpenShift -This example deploy Kibana 8.4.1 on [OpenShift][] using [custom values][]. +This example deploy Kibana 8.5.1 on [OpenShift][] using [custom values][]. ## Usage diff --git a/kibana/examples/security/README.md b/kibana/examples/security/README.md index e499b354c..2ea8056b2 100644 --- a/kibana/examples/security/README.md +++ b/kibana/examples/security/README.md @@ -1,6 +1,6 @@ # Security -This example deploy Kibana 8.4.1 using authentication and TLS to connect to +This example deploy Kibana 8.5.1 using authentication and TLS to connect to Elasticsearch (see [values][]). diff --git a/kibana/examples/security/test/goss.yaml b/kibana/examples/security/test/goss.yaml index c0be5562b..8cfcc70fe 100644 --- a/kibana/examples/security/test/goss.yaml +++ b/kibana/examples/security/test/goss.yaml @@ -6,7 +6,7 @@ http: request-headers: - "Authorization: Bearer {{ .Env.ELASTICSEARCH_SERVICEACCOUNTTOKEN}}" body: - - '"number":"8.4.1"' + - '"number":"8.5.1"' file: /usr/share/kibana/config/kibana.yml: diff --git a/kibana/examples/upgrade/test/goss.yaml b/kibana/examples/upgrade/test/goss.yaml index ad8364268..13db4c48b 100644 --- a/kibana/examples/upgrade/test/goss.yaml +++ b/kibana/examples/upgrade/test/goss.yaml @@ -5,7 +5,7 @@ http: request-headers: - "Authorization: Bearer {{ .Env.ELASTICSEARCH_SERVICEACCOUNTTOKEN}}" body: - - '"number":"8.4.1"' + - '"number":"8.5.1"' http://localhost:5601/app/kibana: status: 200 diff --git a/kibana/values.yaml b/kibana/values.yaml index 4fd7364bb..f0a9d80ed 100644 --- a/kibana/values.yaml +++ b/kibana/values.yaml @@ -38,7 +38,7 @@ hostAliases: [] # - "bar.local" image: "docker.elastic.co/kibana/kibana" -imageTag: "8.4.1" +imageTag: "8.5.1" imagePullPolicy: "IfNotPresent" # additionals labels diff --git a/logstash/Chart.yaml b/logstash/Chart.yaml index 80bab8af2..b8806b8bb 100644 --- a/logstash/Chart.yaml +++ b/logstash/Chart.yaml @@ -5,8 +5,8 @@ maintainers: - email: helm-charts@elastic.co name: Elastic name: logstash -version: 8.4.1 -appVersion: 8.4.1 +version: 8.5.1 +appVersion: 8.5.1 sources: - https://github.com/elastic/logstash icon: https://helm.elastic.co/icons/logstash.png diff --git a/logstash/README.md b/logstash/README.md index 6abc9674b..bf6c30709 100644 --- a/logstash/README.md +++ b/logstash/README.md @@ -5,13 +5,32 @@ This Helm chart is a lightweight way to configure and run our official [Logstash Docker image][]. -**Warning**: This functionality is in beta and is subject to change. -The design and code is less mature than official GA features and is being -provided as-is with no warranties. Alpha features are not subject to the support -SLA of official GA features (see [supported configurations][] for more details). - - -**Warning**: This branch is used for development, please use the latest [7.x][] release for released version. +> **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 for more details. @@ -51,7 +70,7 @@ See [supported configurations][] for more details. * Clone the git repo: `git clone git@github.com:elastic/helm-charts.git` -* Install it: `helm install logstash ./helm-charts/logstash --set imageTag=8.4.1` +* Install it: `helm install logstash ./helm-charts/logstash --set imageTag=8.5.1` ## Upgrading @@ -108,7 +127,7 @@ useful for the [http input plugin][], for instance. | `httpPort` | The http port that Kubernetes will use for the healthchecks and the service | `9600` | | `imagePullPolicy` | The Kubernetes [imagePullPolicy][] value | `IfNotPresent` | | `imagePullSecrets` | Configuration for [imagePullSecrets][] so that you can use a private registry for your image | `[]` | -| `imageTag` | The Logstash Docker image tag | `8.4.1` | +| `imageTag` | The Logstash Docker image tag | `8.5.1` | | `image` | The Logstash Docker image | `docker.elastic.co/logstash/logstash` | | `labels` | Configurable [labels][] applied to all Logstash pods | `{}` | | `ingress` | Configurable [ingress][] for external access to Logstash HTTP port. | see [values.yaml][] | @@ -185,17 +204,18 @@ against best practices of containers and immutable infrastructure. Please check [CONTRIBUTING.md][] before any contribution or for any questions about our development and testing process. -[7.x]: https://github.com/elastic/helm-charts/releases -[BREAKING_CHANGES.md]: https://github.com/elastic/helm-charts/blob/main/BREAKING_CHANGES.md -[CHANGELOG.md]: https://github.com/elastic/helm-charts/blob/main/CHANGELOG.md -[CONTRIBUTING.md]: https://github.com/elastic/helm-charts/blob/main/CONTRIBUTING.md [alternate scheduler]: https://kubernetes.io/docs/tasks/administer-cluster/configure-multiple-schedulers/#specify-schedulers-for-pods [annotations]: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations/ [anti-affinity]: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/#affinity-and-anti-affinity -[deploys statefulsets serially]: https://kubernetes.io/docs/concepts/workloads/controllers/statefulset/#pod-management-policies +[BREAKING_CHANGES.md]: https://github.com/elastic/helm-charts/blob/main/BREAKING_CHANGES.md +[CHANGELOG.md]: https://github.com/elastic/helm-charts/blob/main/CHANGELOG.md +[CONTRIBUTING.md]: https://github.com/elastic/helm-charts/blob/main/CONTRIBUTING.md [custom docker image]: https://www.elastic.co/guide/en/logstash/current/docker-config.html#_custom_images -[environment variables]: https://kubernetes.io/docs/tasks/inject-data-application/define-environment-variable-container/#using-environment-variables-inside-of-your-config +[deploys statefulsets serially]: https://kubernetes.io/docs/concepts/workloads/controllers/statefulset/#pod-management-policies +[eck-charts]: https://github.com/elastic/cloud-on-k8s/tree/master/deploy +[elastic cloud on kubernetes]: https://github.com/elastic/cloud-on-k8s [environment from variables]: https://kubernetes.io/docs/tasks/configure-pod-container/configure-pod-configmap/#configure-all-key-value-pairs-in-a-configmap-as-container-environment-variables +[environment variables]: https://kubernetes.io/docs/tasks/inject-data-application/define-environment-variable-container/#using-environment-variables-inside-of-your-config [examples]: https://github.com/elastic/helm-charts/tree/main/logstash/examples [examples/oss]: https://github.com/elastic/helm-charts/tree/main/logstash/examples/oss [hostAliases]: https://kubernetes.io/docs/concepts/services-networking/add-entries-to-pod-etc-hosts-with-host-aliases/ @@ -208,17 +228,17 @@ about our development and testing process. [logstash oss docker image]: https://www.docker.elastic.co/r/logstash/logstash-oss [maxUnavailable]: https://kubernetes.io/docs/tasks/run-application/configure-pdb/#specifying-a-poddisruptionbudget [node affinity settings]: https://kubernetes.io/docs/tasks/configure-pod-container/assign-pods-nodes-using-node-affinity/ -[pod affinity settings]: https://kubernetes.io/docs/concepts/scheduling-eviction/assign-pod-node/#inter-pod-affinity-and-anti-affinity [nodeSelector]: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/#nodeselector [note]: https://www.elastic.co/guide/en/logstash/current/docker-config.html#docker-env-config +[pod affinity settings]: https://kubernetes.io/docs/concepts/scheduling-eviction/assign-pod-node/#inter-pod-affinity-and-anti-affinity [priorityClass]: https://kubernetes.io/docs/concepts/configuration/pod-priority-preemption/#priorityclass [probe]: https://kubernetes.io/docs/tasks/configure-pod-container/configure-liveness-readiness-probes/ [resources]: https://kubernetes.io/docs/concepts/configuration/manage-compute-resources-container/ -[updateStrategy]: https://kubernetes.io/docs/concepts/workloads/controllers/statefulset/ [securityContext]: https://kubernetes.io/docs/tasks/configure-pod-container/security-context/#set-the-security-context-for-a-pod [service]: https://kubernetes.io/docs/concepts/services-networking/service/ [supported configurations]: https://github.com/elastic/helm-charts/tree/main/README.md#supported-configurations [terminationGracePeriod]: https://kubernetes.io/docs/concepts/workloads/pods/pod/#termination-of-pods [tolerations]: https://kubernetes.io/docs/concepts/configuration/taint-and-toleration/ +[updateStrategy]: https://kubernetes.io/docs/concepts/workloads/controllers/statefulset/ [values.yaml]: https://github.com/elastic/helm-charts/tree/main/logstash/values.yaml [volumeClaimTemplate for statefulsets]: https://kubernetes.io/docs/concepts/workloads/controllers/statefulset/#stable-storage diff --git a/logstash/examples/default/README.md b/logstash/examples/default/README.md index 4e6675ab9..b6bbec1eb 100644 --- a/logstash/examples/default/README.md +++ b/logstash/examples/default/README.md @@ -1,6 +1,6 @@ # Default -This example deploy Logstash 8.4.1 using [default values][]. +This example deploy Logstash 8.5.1 using [default values][]. ## Usage diff --git a/logstash/examples/default/test/goss.yaml b/logstash/examples/default/test/goss.yaml index 98e679e42..b7b18c75a 100644 --- a/logstash/examples/default/test/goss.yaml +++ b/logstash/examples/default/test/goss.yaml @@ -9,7 +9,7 @@ http: status: 200 timeout: 2000 body: - - '"version" : "8.4.1"' + - '"version" : "8.5.1"' - '"http_address" : "0.0.0.0:9600"' - '"status" : "green"' - '"workers" : 1' diff --git a/logstash/examples/elasticsearch/README.md b/logstash/examples/elasticsearch/README.md index 9395765a7..7163350ec 100644 --- a/logstash/examples/elasticsearch/README.md +++ b/logstash/examples/elasticsearch/README.md @@ -1,6 +1,6 @@ # Elasticsearch -This example deploy Logstash 8.4.1 which connects to Elasticsearch (see +This example deploy Logstash 8.5.1 which connects to Elasticsearch (see [values][]). diff --git a/logstash/examples/elasticsearch/test/goss.yaml b/logstash/examples/elasticsearch/test/goss.yaml index 0fb989515..21c96a419 100644 --- a/logstash/examples/elasticsearch/test/goss.yaml +++ b/logstash/examples/elasticsearch/test/goss.yaml @@ -21,7 +21,7 @@ http: status: 200 timeout: 2000 body: - - '"version" : "8.4.1"' + - '"version" : "8.5.1"' - '"http_address" : "0.0.0.0:9600"' - '"status" : "green"' - '"workers" : 1' diff --git a/logstash/examples/oss/README.md b/logstash/examples/oss/README.md index 942ec3bc0..af5d5ec64 100644 --- a/logstash/examples/oss/README.md +++ b/logstash/examples/oss/README.md @@ -1,6 +1,6 @@ # OSS -This example deploy Logstash 8.4.1 using [Logstash OSS][] version. +This example deploy Logstash 8.5.1 using [Logstash OSS][] version. ## Usage diff --git a/logstash/examples/oss/test/goss.yaml b/logstash/examples/oss/test/goss.yaml index 2a5957719..80369dbfb 100644 --- a/logstash/examples/oss/test/goss.yaml +++ b/logstash/examples/oss/test/goss.yaml @@ -9,7 +9,7 @@ http: status: 200 timeout: 2000 body: - - '"version" : "8.4.1"' + - '"version" : "8.5.1"' - '"http_address" : "0.0.0.0:9600"' - '"status" : "green"' - '"workers" : 1' diff --git a/logstash/examples/security/README.md b/logstash/examples/security/README.md index cffb78fb0..c6ce27eed 100644 --- a/logstash/examples/security/README.md +++ b/logstash/examples/security/README.md @@ -1,6 +1,6 @@ # Security -This example deploy Logstash 8.4.1 which connects to Elasticsearch using TLS +This example deploy Logstash 8.5.1 which connects to Elasticsearch using TLS (see [values][]). diff --git a/logstash/examples/security/test/goss.yaml b/logstash/examples/security/test/goss.yaml index 52a9f4a4b..923a81412 100644 --- a/logstash/examples/security/test/goss.yaml +++ b/logstash/examples/security/test/goss.yaml @@ -21,7 +21,7 @@ http: status: 200 timeout: 2000 body: - - '"version" : "8.4.1"' + - '"version" : "8.5.1"' - '"http_address" : "0.0.0.0:9600"' - '"status" : "green"' - '"workers" : 1' diff --git a/logstash/examples/upgrade/test/goss.yaml b/logstash/examples/upgrade/test/goss.yaml index 98e679e42..b7b18c75a 100644 --- a/logstash/examples/upgrade/test/goss.yaml +++ b/logstash/examples/upgrade/test/goss.yaml @@ -9,7 +9,7 @@ http: status: 200 timeout: 2000 body: - - '"version" : "8.4.1"' + - '"version" : "8.5.1"' - '"http_address" : "0.0.0.0:9600"' - '"status" : "green"' - '"workers" : 1' diff --git a/logstash/values.yaml b/logstash/values.yaml index e40e43768..026c13d03 100644 --- a/logstash/values.yaml +++ b/logstash/values.yaml @@ -71,7 +71,7 @@ hostAliases: [] # - "bar.local" image: "docker.elastic.co/logstash/logstash" -imageTag: "8.4.1" +imageTag: "8.5.1" imagePullPolicy: "IfNotPresent" imagePullSecrets: [] diff --git a/metricbeat/Chart.yaml b/metricbeat/Chart.yaml index a6bf44c64..0bbcc60ac 100644 --- a/metricbeat/Chart.yaml +++ b/metricbeat/Chart.yaml @@ -5,8 +5,8 @@ maintainers: - email: helm-charts@elastic.co name: Elastic name: metricbeat -version: 8.4.1 -appVersion: 8.4.1 +version: 8.5.1 +appVersion: 8.5.1 sources: - https://github.com/elastic/beats icon: https://helm.elastic.co/icons/beats.png diff --git a/metricbeat/README.md b/metricbeat/README.md index 83d243a87..70ce9ded4 100644 --- a/metricbeat/README.md +++ b/metricbeat/README.md @@ -5,8 +5,32 @@ This Helm chart is a lightweight way to configure and run our official [Metricbeat Docker image][]. - -**Warning**: This branch is used for development, please use the latest [7.x][] release for released version. +> **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 for more details. @@ -56,7 +80,7 @@ See [supported configurations][] for more details. * Add the Prometheus community Helm charts repo (required for kube-state-metrics chart dependency): `helm repo add prometheus-community https://prometheus-community.github.io/helm-charts` -* Install it: `helm install metricbeat ./helm-charts/metricbeat --set imageTag=8.4.1` +* Install it: `helm install metricbeat ./helm-charts/metricbeat --set imageTag=8.5.1` ## Upgrading @@ -128,7 +152,7 @@ as a reference. They are also used in the automated testing of this chart. | `hostPathRoot` | Fully-qualified [hostPath][] that will be used to persist Metricbeat registry data | `/var/lib` | | `imagePullPolicy` | The Kubernetes [imagePullPolicy][] value | `IfNotPresent` | | `imagePullSecrets` | Configuration for [imagePullSecrets][] so that you can use a private registry for your image | `[]` | -| `imageTag` | The Metricbeat Docker image tag | `8.4.1` | +| `imageTag` | The Metricbeat Docker image tag | `8.5.1` | | `image` | The Metricbeat Docker image | `docker.elastic.co/beats/metricbeat` | | `kube_state_metrics.enabled` | Install [kube-state-metrics][] chart as a dependency | `true` | | `kube_state_metrics.host` | Define kube-state-metrics endpoint for an existing deployment. Works only if `kube_state_metrics.enabled: false` | `""` | @@ -203,22 +227,23 @@ to use a different port. Please check [CONTRIBUTING.md][] before any contribution or for any questions about our development and testing process. -[7.x]: https://github.com/elastic/helm-charts/releases [#471]: https://github.com/elastic/helm-charts/pull/471 -[BREAKING_CHANGES.md]: https://github.com/elastic/helm-charts/blob/main/BREAKING_CHANGES.md -[CHANGELOG.md]: https://github.com/elastic/helm-charts/blob/main/CHANGELOG.md -[CONTRIBUTING.md]: https://github.com/elastic/helm-charts/blob/main/CONTRIBUTING.md [affinity]: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/#affinity-and-anti-affinity [annotations]: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations/ +[BREAKING_CHANGES.md]: https://github.com/elastic/helm-charts/blob/main/BREAKING_CHANGES.md +[CHANGELOG.md]: https://github.com/elastic/helm-charts/blob/main/CHANGELOG.md [cluster role rules]: https://kubernetes.io/docs/reference/access-authn-authz/rbac/#role-and-clusterrole -[environment variables]: https://kubernetes.io/docs/tasks/inject-data-application/define-environment-variable-container/#using-environment-variables-inside-of-your-config +[CONTRIBUTING.md]: https://github.com/elastic/helm-charts/blob/main/CONTRIBUTING.md +[eck-charts]: https://github.com/elastic/cloud-on-k8s/tree/master/deploy +[elastic cloud on kubernetes]: https://github.com/elastic/cloud-on-k8s [environment from variables]: https://kubernetes.io/docs/tasks/configure-pod-container/configure-pod-configmap/#configure-all-key-value-pairs-in-a-configmap-as-container-environment-variables +[environment variables]: https://kubernetes.io/docs/tasks/inject-data-application/define-environment-variable-container/#using-environment-variables-inside-of-your-config [examples]: https://github.com/elastic/helm-charts/tree/main/metricbeat/examples [examples/oss]: https://github.com/elastic/helm-charts/tree/main/metricbeat/examples/oss [examples/security]: https://github.com/elastic/helm-charts/tree/main/metricbeat/examples/security [hostAliases]: https://kubernetes.io/docs/concepts/services-networking/add-entries-to-pod-etc-hosts-with-host-aliases/ -[hostPath]: https://kubernetes.io/docs/concepts/storage/volumes/#hostpath [hostNetwork]: https://kubernetes.io/docs/concepts/policy/pod-security-policy/#host-namespaces +[hostPath]: https://kubernetes.io/docs/concepts/storage/volumes/#hostpath [imagePullPolicy]: https://kubernetes.io/docs/concepts/containers/images/#updating-images [imagePullSecrets]: https://kubernetes.io/docs/tasks/configure-pod-container/pull-image-private-registry/#create-a-pod-that-uses-your-secret [kube-state-metrics]: https://github.com/prometheus-community/helm-charts/tree/main/charts/kube-state-metrics @@ -226,8 +251,8 @@ about our development and testing process. [labels]: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/ [metricbeat docker image]: https://www.elastic.co/guide/en/beats/metricbeat/current/running-on-docker.html [metricbeat oss docker image]: https://www.docker.elastic.co/r/beats/metricbeat-oss -[priorityClass]: https://kubernetes.io/docs/concepts/configuration/pod-priority-preemption/#priorityclass [nodeSelector]: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/#nodeselector +[priorityClass]: https://kubernetes.io/docs/concepts/configuration/pod-priority-preemption/#priorityclass [probe]: https://kubernetes.io/docs/tasks/configure-pod-container/configure-liveness-readiness-probes [resources]: https://kubernetes.io/docs/concepts/configuration/manage-compute-resources-container/ [securityContext]: https://kubernetes.io/docs/tasks/configure-pod-container/security-context/ diff --git a/metricbeat/examples/default/README.md b/metricbeat/examples/default/README.md index 9b2cbf4c3..5d9015f05 100644 --- a/metricbeat/examples/default/README.md +++ b/metricbeat/examples/default/README.md @@ -1,6 +1,6 @@ # Default -This example deploy Metricbeat 8.4.1 using [default values][]. +This example deploy Metricbeat 8.5.1 using [default values][]. ## Usage diff --git a/metricbeat/examples/default/test/goss-metrics.yaml b/metricbeat/examples/default/test/goss-metrics.yaml index 7a7b09a92..f5b9d6ffe 100644 --- a/metricbeat/examples/default/test/goss-metrics.yaml +++ b/metricbeat/examples/default/test/goss-metrics.yaml @@ -24,7 +24,7 @@ http: username: "{{ .Env.ELASTICSEARCH_USERNAME }}" password: "{{ .Env.ELASTICSEARCH_PASSWORD }}" body: - - "metricbeat-8.4.1" + - "metricbeat-8.5.1" https://elasticsearch-master:9200/_search?q=metricset.name:state_deployment: status: 200 allow-insecure: true diff --git a/metricbeat/examples/default/test/goss.yaml b/metricbeat/examples/default/test/goss.yaml index 6ab3dd6a5..d4c290370 100644 --- a/metricbeat/examples/default/test/goss.yaml +++ b/metricbeat/examples/default/test/goss.yaml @@ -28,12 +28,12 @@ http: username: "{{ .Env.ELASTICSEARCH_USERNAME }}" password: "{{ .Env.ELASTICSEARCH_PASSWORD }}" body: - - "metricbeat-8.4.1" + - "metricbeat-8.5.1" https://elasticsearch-master:9200/_search?q=metricset.name:container: status: 200 timeout: 2000 body: - - "metricbeat-8.4.1" + - "metricbeat-8.5.1" allow-insecure: true username: "{{ .Env.ELASTICSEARCH_USERNAME }}" password: "{{ .Env.ELASTICSEARCH_PASSWORD }}" diff --git a/metricbeat/examples/oss/README.md b/metricbeat/examples/oss/README.md index 60fc8f435..90cc035be 100644 --- a/metricbeat/examples/oss/README.md +++ b/metricbeat/examples/oss/README.md @@ -1,6 +1,6 @@ # OSS -This example deploy Metricbeat 8.4.1 using [Metricbeat OSS][] version. +This example deploy Metricbeat 8.5.1 using [Metricbeat OSS][] version. ## Usage diff --git a/metricbeat/examples/oss/test/goss-metrics.yaml b/metricbeat/examples/oss/test/goss-metrics.yaml index f5d024d86..ed0f18884 100644 --- a/metricbeat/examples/oss/test/goss-metrics.yaml +++ b/metricbeat/examples/oss/test/goss-metrics.yaml @@ -24,7 +24,7 @@ http: username: "{{ .Env.ELASTICSEARCH_USERNAME }}" password: "{{ .Env.ELASTICSEARCH_PASSWORD }}" body: - - "metricbeat-oss-8.4.1" + - "metricbeat-oss-8.5.1" https://elasticsearch-master:9200/_search?q=metricset.name:state_deployment: allow-insecure: true status: 200 diff --git a/metricbeat/examples/oss/test/goss.yaml b/metricbeat/examples/oss/test/goss.yaml index a90d1e3a6..d7cdec744 100644 --- a/metricbeat/examples/oss/test/goss.yaml +++ b/metricbeat/examples/oss/test/goss.yaml @@ -28,7 +28,7 @@ http: username: "{{ .Env.ELASTICSEARCH_USERNAME }}" password: "{{ .Env.ELASTICSEARCH_PASSWORD }}" body: - - "metricbeat-oss-8.4.1" + - "metricbeat-oss-8.5.1" file: /usr/share/metricbeat/metricbeat.yml: diff --git a/metricbeat/examples/security/README.md b/metricbeat/examples/security/README.md index f275ef2ce..d74328a05 100644 --- a/metricbeat/examples/security/README.md +++ b/metricbeat/examples/security/README.md @@ -1,6 +1,6 @@ # Security -This example deploy Metricbeat 8.4.1 using authentication and TLS to connect to +This example deploy Metricbeat 8.5.1 using authentication and TLS to connect to Elasticsearch (see [values][]). diff --git a/metricbeat/examples/security/test/goss-metrics.yaml b/metricbeat/examples/security/test/goss-metrics.yaml index 5c6dbdaf9..9c5871aec 100644 --- a/metricbeat/examples/security/test/goss-metrics.yaml +++ b/metricbeat/examples/security/test/goss-metrics.yaml @@ -21,7 +21,7 @@ http: status: 200 timeout: 2000 body: - - "metricbeat-8.4.1" + - "metricbeat-8.5.1" allow-insecure: true username: "{{ .Env.ELASTICSEARCH_USERNAME }}" password: "{{ .Env.ELASTICSEARCH_PASSWORD }}" @@ -29,7 +29,7 @@ http: status: 200 timeout: 2000 body: - - "metricbeat-8.4.1" + - "metricbeat-8.5.1" allow-insecure: true username: "{{ .Env.ELASTICSEARCH_USERNAME }}" password: "{{ .Env.ELASTICSEARCH_PASSWORD }}" diff --git a/metricbeat/examples/security/test/goss.yaml b/metricbeat/examples/security/test/goss.yaml index c99d73f96..ea3607859 100644 --- a/metricbeat/examples/security/test/goss.yaml +++ b/metricbeat/examples/security/test/goss.yaml @@ -25,7 +25,7 @@ http: status: 200 timeout: 2000 body: - - "metricbeat-8.4.1" + - "metricbeat-8.5.1" allow-insecure: true username: "{{ .Env.ELASTICSEARCH_USERNAME }}" password: "{{ .Env.ELASTICSEARCH_PASSWORD }}" @@ -33,7 +33,7 @@ http: status: 200 timeout: 2000 body: - - "metricbeat-8.4.1" + - "metricbeat-8.5.1" allow-insecure: true username: "{{ .Env.ELASTICSEARCH_USERNAME }}" password: "{{ .Env.ELASTICSEARCH_PASSWORD }}" diff --git a/metricbeat/examples/upgrade/test/goss-metrics.yaml b/metricbeat/examples/upgrade/test/goss-metrics.yaml index 1040f7017..336e1aa7c 100644 --- a/metricbeat/examples/upgrade/test/goss-metrics.yaml +++ b/metricbeat/examples/upgrade/test/goss-metrics.yaml @@ -24,7 +24,7 @@ http: username: "{{ .Env.ELASTICSEARCH_USERNAME }}" password: "{{ .Env.ELASTICSEARCH_PASSWORD }}" body: - - "metricbeat-8.4.1" + - "metricbeat-8.5.1" ? https://upgrade-master:9200/_search?q=metricset.name:state_container%20AND%20kubernetes.container.name:metricbeat : status: 200 timeout: 2000 diff --git a/metricbeat/examples/upgrade/test/goss.yaml b/metricbeat/examples/upgrade/test/goss.yaml index e6d4910d4..77834f5d5 100644 --- a/metricbeat/examples/upgrade/test/goss.yaml +++ b/metricbeat/examples/upgrade/test/goss.yaml @@ -28,7 +28,7 @@ http: status: 200 timeout: 2000 body: - - "metricbeat-8.4.1" + - "metricbeat-8.5.1" ? https://upgrade-master:9200/_search?q=metricset.name:container%20AND%20kubernetes.container.name:metricbeat : allow-insecure: true username: "{{ .Env.ELASTICSEARCH_USERNAME }}" diff --git a/metricbeat/values.yaml b/metricbeat/values.yaml index 9abb5bdb3..bc3e8b4d7 100644 --- a/metricbeat/values.yaml +++ b/metricbeat/values.yaml @@ -214,7 +214,7 @@ extraInitContainers: "" hostPathRoot: /var/lib image: "docker.elastic.co/beats/metricbeat" -imageTag: "8.4.1" +imageTag: "8.5.1" imagePullPolicy: "IfNotPresent" imagePullSecrets: []