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

6.8.9 Release #617

Merged
merged 4 commits into from
May 13, 2020
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
43 changes: 37 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,10 +2,19 @@

[![Build Status](https://img.shields.io/jenkins/s/https/devops-ci.elastic.co/job/elastic+helm-charts+6.8.svg)](https://devops-ci.elastic.co/job/elastic+helm-charts+6.8/)

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. Beta features are not subject to the support SLA of official GA
features.
<!-- START doctoc generated TOC please keep comment here to allow auto update -->
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->


- [Charts](#charts)
- [Supported Configurations](#supported-configurations)
- [Support Matrix](#support-matrix)
- [Kubernetes Versions](#kubernetes-versions)
- [Helm versions](#helm-versions)
- [ECK](#eck)

<!-- END doctoc generated TOC please keep comment here to allow auto update -->


## Charts

Expand All @@ -23,13 +32,33 @@ added below.
| [Logstash](./logstash/README.md) | https://www.elastic.co/guide/en/logstash/6.8/docker.html |
| [Metricbeat](./metricbeat/README.md) | https://www.elastic.co/guide/en/beats/metricbeat/6.8/running-on-docker.html |

## Kubernetes Versions
## Supported Configurations

Starting with 7.7.0 release, some charts are reaching GA.

Note that only the released charts coming from [Elastic Helm repo][] or
[GitHub releases][] are supported.

### Support Matrix

| | Elasticsearch | Kibana | Logstash | Filebeat | Metricbeat | APM Server |
|-----|---------------|--------|----------|----------|------------|------------|
| 7.0 | Alpha | Alpha | / | / | / | / |
| 7.1 | Beta | Beta | / | Beta | / | / |
| 7.2 | Beta | Beta | / | Beta | Beta | / |
| 7.3 | Beta | Beta | / | Beta | Beta | / |
| 7.4 | Beta | Beta | / | Beta | Beta | / |
| 7.5 | Beta | Beta | Beta | Beta | Beta | Alpha |
| 7.6 | Beta | Beta | Beta | Beta | Beta | Alpha |
| 7.7 | GA | GA | Beta | GA | GA | Beta |

### Kubernetes Versions

The charts are [currently tested][] against all GKE versions available. The
exact versions are defined under `KUBERNETES_VERSIONS` in
[helpers/matrix.yml][].

## Helm versions
### Helm versions

While we are checking backward compatibility, the charts are only tested with
Helm version mentioned in [helm-tester Dockerfile][] (currently 2.16.7).
Expand All @@ -45,6 +74,8 @@ Kubernetes.

[currently tested]: https://devops-ci.elastic.co/job/elastic+helm-charts+6.8/
[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 3]: https://v3.helm.sh
[helm-tester Dockerfile]: https://github.com/elastic/helm-charts/blob/6.8/helpers/helm-tester/Dockerfile
[helpers/matrix.yml]: https://github.com/elastic/helm-charts/blob/6.8/helpers/matrix.yml
Expand Down
4 changes: 2 additions & 2 deletions apm-server/Chart.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -5,8 +5,8 @@ maintainers:
- email: helm-charts@elastic.co
name: Elastic
name: apm-server
version: 6.8.9-SNAPSHOT
appVersion: 6.8.9-SNAPSHOT
version: 6.8.9
appVersion: 6.8.9
sources:
- https://github.com/elastic/apm
icon: https://helm.elastic.co/icons/apm.png
46 changes: 16 additions & 30 deletions apm-server/README.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,20 @@
# APM Server Helm Chart

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).


<!-- START doctoc generated TOC please keep comment here to allow auto update -->
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->


- [Requirements](#requirements)
- [Installing](#installing)
- [Using Helm repository](#using-helm-repository)
- [Using the 6.8 branch](#using-the-68-branch)
- [Upgrading](#upgrading)
- [Usage notes](#usage-notes)
- [Configuration](#configuration)
Expand All @@ -20,45 +28,21 @@
<!-- docker run --rm -it -v $(pwd):/usr/src jorgeandrada/doctoc --github -->


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.

This Helm chart is a lightweight way to configure and run our official
[APM Server Docker image][].


## Requirements

* Kubernetes >= 1.9
* [Helm][] >= 2.8.0

See [supported configurations][] for more details.

## Installing

This chart is tested with the latest 6.8.9-SNAPSHOT versions.

### Using Helm repository
## Installing

* Add the Elastic Helm charts repo:
`helm repo add elastic https://helm.elastic.co`

* Install the latest 6.8 release:
`helm install --name apm-server elastic/apm-server --version=6.8.9`

### Using the 6.8 branch

* Clone the git repo and checkout the right branch:

```shell
git clone git@github.com:elastic/helm-charts.git
cd helm-charts
git checkout -b 6.8 origin/6.8
````

* Install the latest 6.8.9-SNAPSHOT:
`helm install --name apm-server ./helm-charts/apm-server`
`helm install --name apm-server elastic/apm-server`


## Upgrading
Expand Down Expand Up @@ -96,7 +80,7 @@ as a reference. They are also used in the automated testing of this chart.
| `fullnameOverride` | Overrides the full name of the resources. If not set the name will default to `.Release.Name` - `.Values.nameOverride` or `.Chart.Name` | `""` |
| `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 | `6.8.9-SNAPSHOT` |
| `imageTag` | The APM Server Docker image tag | `6.8.9` |
| `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 | `{}` |
Expand Down Expand Up @@ -144,6 +128,7 @@ Please check [CONTRIBUTING.md][] before any contribution or for any questions
about our development and testing process.


[6.8.9]: https://github.com/elastic/helm-charts/blob/6.8.9/apm-server/README.md
[BREAKING_CHANGES.md]: https://github.com/elastic/helm-charts/blob/master/BREAKING_CHANGES.md
[CHANGELOG.md]: https://github.com/elastic/helm-charts/blob/master/CHANGELOG.md
[CONTRIBUTING.md]: https://github.com/elastic/helm-charts/blob/master/CONTRIBUTING.md
Expand Down Expand Up @@ -172,6 +157,7 @@ about our development and testing process.
[resources]: https://kubernetes.io/docs/concepts/configuration/manage-compute-resources-container/
[service]: https://kubernetes.io/docs/concepts/services-networking/service/
[serviceAccount]: https://kubernetes.io/docs/tasks/configure-pod-container/configure-service-account/
[supported configurations]: https://github.com/elastic/helm-charts/tree/6.8/README.md#supported-configurations
[tolerations]: https://kubernetes.io/docs/concepts/configuration/taint-and-toleration/
[updateStrategy]: https://kubernetes.io/docs/concepts/workloads/controllers/deployment/#updating-a-deployment
[values.yaml]: https://github.com/elastic/helm-charts/tree/6.8/apm-server/values.yaml
2 changes: 1 addition & 1 deletion apm-server/examples/default/README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Default

This example deploy APM Server 6.8.9-SNAPSHOT using [default values][].
This example deploy APM Server 6.8.9 using [default values][].


## Usage
Expand Down
2 changes: 1 addition & 1 deletion apm-server/examples/oss/README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# OSS

This example deploy APM Server 6.8.9-SNAPSHOT using [APM Server OSS][] version.
This example deploy APM Server 6.8.9 using [APM Server OSS][] version.


## Usage
Expand Down
2 changes: 1 addition & 1 deletion apm-server/examples/security/README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Security

This example deploy APM Server 6.8.9-SNAPSHOT using authentication and TLS to connect to
This example deploy APM Server 6.8.9 using authentication and TLS to connect to
Elasticsearch (see [values][]).


Expand Down
2 changes: 1 addition & 1 deletion apm-server/values.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -62,7 +62,7 @@ extraVolumes: []
# emptyDir: {}

image: "docker.elastic.co/apm/apm-server"
imageTag: "6.8.9-SNAPSHOT"
imageTag: "6.8.9"
imagePullPolicy: "IfNotPresent"
imagePullSecrets: []

Expand Down
4 changes: 2 additions & 2 deletions elasticsearch/Chart.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -5,8 +5,8 @@ maintainers:
- email: helm-charts@elastic.co
name: Elastic
name: elasticsearch
version: 6.8.9-SNAPSHOT
appVersion: 6.8.9-SNAPSHOT
version: 6.8.9
appVersion: 6.8.9
sources:
- https://github.com/elastic/elasticsearch
icon: https://helm.elastic.co/icons/elasticsearch.png
46 changes: 13 additions & 33 deletions elasticsearch/README.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,15 @@
# Elasticsearch Helm Chart

This Helm chart is a lightweight way to configure and run our official
[Elasticsearch Docker image][].


<!-- START doctoc generated TOC please keep comment here to allow auto update -->
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->


- [Requirements](#requirements)
- [Installing](#installing)
- [Using Helm repository](#using-helm-repository)
- [Using the 6.8 branch](#using-the-68-branch)
- [Upgrading](#upgrading)
- [Usage notes](#usage-notes)
- [Configuration](#configuration)
Expand All @@ -32,49 +35,25 @@
<!-- docker run --rm -it -v $(pwd):/usr/src jorgeandrada/doctoc --github -->


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. Beta features are not subject to the support SLA of official GA
features.

This Helm chart is a lightweight way to configure and run our official
[Elasticsearch Docker image][].


## Requirements

* [Helm][] >=2.8.0 and <3.0.0 (see [parent README][] for more details)
* [Helm][] >=2.8.0 and <3.0.0
* Kubernetes >=1.8
* Minimum cluster requirements include the following to run this chart with
default settings. All of these settings are configurable.
* Three Kubernetes nodes to respect the default "hard" affinity settings
* 1GB of RAM for the JVM heap

See [supported configurations][] for more details.

## Installing

This chart is tested with the latest 6.8.9-SNAPSHOT versions.

### Using Helm repository
## Installing

* Add the Elastic Helm charts repo:
`helm repo add elastic https://helm.elastic.co`

* Install the latest 6.8 release:
`helm install --name elasticsearch elastic/elasticsearch --version=6.8.9`

### Using the 6.8 branch

* Clone the git repo and checkout the right branch:

```shell
git clone git@github.com:elastic/helm-charts.git
cd helm-charts
git checkout -b 6.8 origin/6.8
````

* Install the latest 6.8.9-SNAPSHOT:
`helm install --name elasticsearch ./helm-charts/elasticsearch`
`helm install --name elasticsearch elastic/elasticsearch`


## Upgrading
Expand Down Expand Up @@ -129,7 +108,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 | `6.8.9-SNAPSHOT` |
| `imageTag` | The Elasticsearch Docker image tag | `6.8.9` |
| `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 | `{}` |
Expand Down Expand Up @@ -390,10 +369,11 @@ Please check [CONTRIBUTING.md][] before any contribution or for any questions
about our development and testing process.


[#63]: https://github.com/elastic/helm-charts/issues/63
[6.8.9]: https://github.com/elastic/helm-charts/blob/6.8.9/elasticsearch/README.md
[BREAKING_CHANGES.md]: https://github.com/elastic/helm-charts/blob/master/BREAKING_CHANGES.md
[CHANGELOG.md]: https://github.com/elastic/helm-charts/blob/master/CHANGELOG.md
[CONTRIBUTING.md]: https://github.com/elastic/helm-charts/blob/master/CONTRIBUTING.md
[#63]: https://github.com/elastic/helm-charts/issues/63
[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
Expand Down Expand Up @@ -443,7 +423,6 @@ about our development and testing process.
[nodes types]: https://www.elastic.co/guide/en/elasticsearch/reference/6.8/modules-node.html
[nodeSelector]: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/#nodeselector
[openshift]: https://github.com/elastic/helm-charts/tree/6.8/elasticsearch/examples/openshift
[parent readme]: https://github.com/elastic/helm-charts/tree/6.8/README.md
[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/
Expand All @@ -454,6 +433,7 @@ about our development and testing process.
[snapshot lifecycle management]: https://github.com/elastic/elasticsearch/issues/38461
[snapshot plugin]: https://www.elastic.co/guide/en/elasticsearch/plugins/6.8/repository.html
[snapshot repository]: https://www.elastic.co/guide/en/elasticsearch/reference/6.8/modules-snapshots.html
[supported configurations]: https://github.com/elastic/helm-charts/tree/6.8/README.md#supported-configurations
[sysctl vm.max_map_count]: https://www.elastic.co/guide/en/elasticsearch/reference/6.8/vm-max-map-count.html#vm-max-map-count
[terminationGracePeriod]: https://kubernetes.io/docs/concepts/workloads/pods/pod/#termination-of-pods
[tolerations]: https://kubernetes.io/docs/concepts/configuration/taint-and-toleration/
Expand Down
2 changes: 1 addition & 1 deletion elasticsearch/examples/config/README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Config

This example deploy a single node Elasticsearch 6.8.9-SNAPSHOT with authentication and
This example deploy a single node Elasticsearch 6.8.9 with authentication and
custom [values][].


Expand Down
2 changes: 1 addition & 1 deletion elasticsearch/examples/default/README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Default

This example deploy a 3 nodes Elasticsearch 6.8.9-SNAPSHOT cluster using
This example deploy a 3 nodes Elasticsearch 6.8.9 cluster using
[default values][].


Expand Down
2 changes: 1 addition & 1 deletion elasticsearch/examples/docker-for-mac/README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Docker for Mac

This example deploy a 3 nodes Elasticsearch 6.8.9-SNAPSHOT cluster on [Docker for Mac][]
This example deploy a 3 nodes Elasticsearch 6.8.9 cluster on [Docker for Mac][]
using [custom values][].

Note that this configuration should be used for test only and isn't recommended
Expand Down
2 changes: 1 addition & 1 deletion elasticsearch/examples/kubernetes-kind/README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# KIND

This example deploy a 3 nodes Elasticsearch 6.8.9-SNAPSHOT cluster on [Kind][]
This example deploy a 3 nodes Elasticsearch 6.8.9 cluster on [Kind][]
using [custom values][].

Note that this configuration should be used for test only and isn't recommended
Expand Down
2 changes: 1 addition & 1 deletion elasticsearch/examples/microk8s/README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# MicroK8S

This example deploy a 3 nodes Elasticsearch 6.8.9-SNAPSHOT cluster on [MicroK8S][]
This example deploy a 3 nodes Elasticsearch 6.8.9 cluster on [MicroK8S][]
using [custom values][].

Note that this configuration should be used for test only and isn't recommended
Expand Down
4 changes: 2 additions & 2 deletions elasticsearch/examples/migration/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -163,5 +163,5 @@ working correctly you can cleanup leftover resources from your old cluster.
[data.yml]: https://github.com/elastic/helm-charts/blob/6.8/elasticsearch/examples/migration/data.yml
[helm/charts]: https://github.com/helm/charts/tree/master/stable/elasticsearch
[master.yml]: https://github.com/elastic/helm-charts/blob/6.8/elasticsearch/examples/migration/master.yml
[restoring to a different cluster guide]: https://www.elastic.co/guide/en/elasticsearch/reference/6.6/modules-snapshots.html#_restoring_to_a_different_cluster
[rolling upgrades guide]: https://www.elastic.co/guide/en/elasticsearch/reference/6.6/rolling-upgrades.html
[restoring to a different cluster guide]: https://www.elastic.co/guide/en/elasticsearch/reference/6.8/modules-snapshots.html#_restoring_to_a_different_cluster
[rolling upgrades guide]: https://www.elastic.co/guide/en/elasticsearch/reference/6.8/rolling-upgrades.html
2 changes: 1 addition & 1 deletion elasticsearch/examples/minikube/README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Minikube

This example deploy a 3 nodes Elasticsearch 6.8.9-SNAPSHOT cluster on [Minikube][]
This example deploy a 3 nodes Elasticsearch 6.8.9 cluster on [Minikube][]
using [custom values][].

If helm or kubectl timeouts occur, you may consider creating a minikube VM with
Expand Down
2 changes: 1 addition & 1 deletion elasticsearch/examples/multi/README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Multi

This example deploy an Elasticsearch 6.8.9-SNAPSHOT cluster composed of 2 different Helm
This example deploy an Elasticsearch 6.8.9 cluster composed of 2 different Helm
releases:

- `helm-es-multi-master` for the 3 master nodes using [master values][]
Expand Down
Loading