Skip to content
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
132 changes: 132 additions & 0 deletions packs/elastic-stack-0.19.1/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,132 @@
# Elastic Cloud on Kubernetes (ECK)

Elastic Cloud on Kubernetes automates the deployment, provisioning, management, and orchestration of Elasticsearch, Kibana, APM Server, Enterprise Search, Beats, Elastic Agent, Elastic Maps Server, and Logstash on Kubernetes based on the operator pattern.

Current features:

* Elasticsearch, Kibana, APM Server, Enterprise Search, and Beats deployments
* TLS Certificates management
* Safe Elasticsearch cluster configuration & topology changes
* Persistent volumes usage
* Custom node configuration and attributes
* Secure settings keystore updates

Supported versions:

* Kubernetes 1.25-1.29
* Elasticsearch, Kibana, APM Server: 6.8+, 7.1+, 8+, 9+
* Enterprise Search: 7.7+, 8+
* Beats: 7.0+, 8+, 9+
* Elastic Agent: 7.10+ (standalone), 7.14+, 8+ (Fleet), 9+
* Elastic Maps Server: 7.11+, 8+
* Logstash 8.7+, 9+

Check the [Quickstart](https://www.elastic.co/guide/en/cloud-on-k8s/current/k8s-quickstart.html) to deploy your first cluster with ECK.

For general questions, please see the Elastic [forums](https://discuss.elastic.co/c/eck).

# ECK-Stack

ECK Stack is a Helm chart to assist in the deployment of Elastic Stack components, which are
managed by the [ECK Operator](https://www.elastic.co/guide/en/cloud-on-k8s/current/index.html)

## Supported Elastic Stack Resources

The following Elastic Stack resources are currently supported.

- Elasticsearch
- Kibana
- Elastic Agent
- Fleet Server
- Beats
- Logstash
- APM Server

Additional resources will be supported in future releases of this Helm Chart.

## Upgrade

To upgrade the stack to a newer version, follow these general steps:

1. Check Compatibility: Ensure your Kubernetes cluster remains within the supported version range (1.25-1.29 for general ECK features).
2. Review CRDs: Verify if the new version of the ECK Operator requires updated Custom Resource Definitions.
3. Helm Upgrade: Run the standard upgrade command: helm upgrade <release-name> elastic/eck-stack

## Usage

The chart currently supports the deployment of the following resources:

- Elasticsearch & Kibana: Enabled by default for immediate cluster setup.
- Agents & Servers: Optional deployment of Elastic Agent, Fleet Server, Beats, Logstash, and APM Server.
- Security: Features include automated TLS Certificates management and secure settings via keystore updates.
- Persistence: Utilizes Persistent Volumes for data storage across cluster changes.

## Prerequisites

- Kubernetes 1.27+
- Elastic ECK Operator

## Installing the Chart

### Installing the ECK Operator

Before using this chart, the Elastic ECK Operator is required to be installed within the Kubernetes cluster.
Full installation instructions can be found within [our documentation](https://www.elastic.co/guide/en/cloud-on-k8s/current/k8s-installing-eck.html)

To install the ECK Operator using Helm.

```sh
# Add the Elastic Helm Repository
helm repo add elastic https://helm.elastic.co && helm repo update

# Install the ECK Operator cluster-wide
helm install elastic-operator elastic/eck-operator -n elastic-system --create-namespace
```

Additional ECK Operator Helm installation options can be found within [our documentation](https://www.elastic.co/guide/en/cloud-on-k8s/current/k8s-install-helm.html)

### Installing the ECK Stack Chart

The following will install the ECK-Stack chart using the default values, which will deploy an Elasticsearch [Quickstart Cluster](https://www.elastic.co/guide/en/cloud-on-k8s/current/k8s-deploy-elasticsearch.html), and a Kibana [Quickstart Instance](https://www.elastic.co/guide/en/cloud-on-k8s/current/k8s-deploy-kibana.html)

```sh
# Add the Elastic Helm Repository
helm repo add elastic https://helm.elastic.co && helm repo update

# Install the ECK-Stack helm chart
# This will setup a 'quickstart' Elasticsearch and Kibana resource in the 'elastic-stack' namespace
helm install my-release elastic/eck-stack -n elastic-stack --create-namespace
```

More information on the different ways to use the ECK Stack chart to deploy Elastic Stack resources
can be found in [our documentation](https://www.elastic.co/guide/en/cloud-on-k8s/current/index.html).

## Uninstalling the Chart

To uninstall/delete the `my-release` deployment from the 'elastic-stack' namespace:

```console
helm delete my-release -n elastic-stack
```

The command removes all the Elastic Stack resources associated with the chart and deletes the release.

## Configuration

The following table lists the configurable parameters of the eck-stack chart and their default values.

| Parameter | Description | Default |
| --------- | ----------- | ------- |
| `eck-elasticsearch.enabled` | If `true`, create an Elasticsearch resource (using the eck-elasticsearch Chart) | `true` |
| `eck-kibana.enabled` | If `true`, create a Kibana resource (using the eck-kibana Chart) | `true` |
| `eck-agent.enabled` | If `true`, create an Elastic Agent resource (using the eck-agent Chart) | `false` |
| `eck-fleet-server.enabled` | If `true`, create a Fleet Server resource (using the eck-fleet-server Chart) | `false` |
| `eck-logstash.enabled` | If `true`, create a Logstash resource (using the eck-logstash Chart) | `false` |
| `eck-apm-server.enabled` | If `true`, create a standalone Elastic APM Server resource (using the eck-apm-server Chart) | `false` |

## References

Quickstart Guide: https://www.elastic.co/guide/en/cloud-on-k8s/current/k8s-quickstart.html
Official Documentation: https://www.elastic.co/guide/en/cloud-on-k8s/current/index.html
Community Support: https://discuss.elastic.co/c/eck

Binary file not shown.
25 changes: 25 additions & 0 deletions packs/elastic-stack-0.19.1/charts/eck-stack/.helmignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
# Patterns to ignore when building packages.
# This supports shell glob matching, relative path matching, and
# negation (prefixed with !). Only one pattern per line.
.DS_Store
# Common VCS dirs
.git/
.gitignore
.bzr/
.bzrignore
.hg/
.hgignore
.svn/
# Common backup files
*.swp
*.bak
*.tmp
*.orig
*~
# Various IDEs
.project
.idea/
*.tmproj
.vscode/
templates/tests
charts/*/templates/tests
33 changes: 33 additions & 0 deletions packs/elastic-stack-0.19.1/charts/eck-stack/Chart.lock
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
dependencies:
- name: eck-elasticsearch
repository: ""
version: 0.19.1
- name: eck-kibana
repository: ""
version: 0.19.1
- name: eck-agent
repository: ""
version: 0.19.1
- name: eck-fleet-server
repository: ""
version: 0.19.1
- name: eck-beats
repository: ""
version: 0.19.1
- name: eck-logstash
repository: ""
version: 0.19.1
- name: eck-apm-server
repository: ""
version: 0.19.1
- name: eck-enterprise-search
repository: ""
version: 0.19.1
- name: eck-autoops-agent-policy
repository: ""
version: 0.19.1
- name: eck-package-registry
repository: ""
version: 0.19.1
digest: sha256:313a5d7fca710c7036a9fd22b6b89569accbcb9544b9a8b481985a79939539d3
generated: "2026-06-22T10:57:24.315993407Z"
47 changes: 47 additions & 0 deletions packs/elastic-stack-0.19.1/charts/eck-stack/Chart.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
apiVersion: v2
dependencies:
- condition: eck-elasticsearch.enabled
name: eck-elasticsearch
repository: ""
version: 0.19.1
- condition: eck-kibana.enabled
name: eck-kibana
repository: ""
version: 0.19.1
- condition: eck-agent.enabled
name: eck-agent
repository: ""
version: 0.19.1
- condition: eck-fleet-server.enabled
name: eck-fleet-server
repository: ""
version: 0.19.1
- condition: eck-beats.enabled
name: eck-beats
repository: ""
version: 0.19.1
- condition: eck-logstash.enabled
name: eck-logstash
repository: ""
version: 0.19.1
- condition: eck-apm-server.enabled
name: eck-apm-server
repository: ""
version: 0.19.1
- condition: eck-enterprise-search.enabled
name: eck-enterprise-search
repository: ""
version: 0.19.1
- condition: eck-autoops-agent-policy.enabled
name: eck-autoops-agent-policy
repository: ""
version: 0.19.1
- condition: eck-package-registry.enabled
name: eck-package-registry
repository: ""
version: 0.19.1
description: Elastic Stack managed by the ECK Operator
kubeVersion: '>= 1.21.0-0'
name: eck-stack
type: application
version: 0.19.1
93 changes: 93 additions & 0 deletions packs/elastic-stack-0.19.1/charts/eck-stack/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,93 @@
# ECK-Stack

ECK Stack is a Helm chart to assist in the deployment of Elastic Stack components, which are
managed by the [ECK Operator](https://www.elastic.co/guide/en/cloud-on-k8s/current/index.html)

## Supported Elastic Stack Resources

The following Elastic Stack resources are currently supported.

- Elasticsearch
- Kibana
- Elastic Agent
- Fleet Server
- Beats
- Logstash
- APM Server

Additional resources will be supported in future releases of this Helm Chart.

## Prerequisites

- Kubernetes 1.21+
- Elastic ECK Operator

## Installing the Chart

### Installing the ECK Operator

Before using this chart, the Elastic ECK Operator is required to be installed within the Kubernetes cluster.
Full installation instructions can be found within [our documentation](https://www.elastic.co/guide/en/cloud-on-k8s/current/k8s-installing-eck.html)

To install the ECK Operator using Helm.

```sh
# Add the Elastic Helm Repository
helm repo add elastic https://helm.elastic.co && helm repo update

# Install the ECK Operator cluster-wide
helm install elastic-operator elastic/eck-operator -n elastic-system --create-namespace
```

Additional ECK Operator Helm installation options can be found within [our documentation](https://www.elastic.co/guide/en/cloud-on-k8s/current/k8s-install-helm.html)

### Installing the ECK Stack Chart

The following will install the ECK-Stack chart using the default values, which will deploy an Elasticsearch [Quickstart Cluster](https://www.elastic.co/guide/en/cloud-on-k8s/current/k8s-deploy-elasticsearch.html), and a Kibana [Quickstart Instance](https://www.elastic.co/guide/en/cloud-on-k8s/current/k8s-deploy-kibana.html)

```sh
# Add the Elastic Helm Repository
helm repo add elastic https://helm.elastic.co && helm repo update

# Install the ECK-Stack helm chart
# This will setup a 'quickstart' Elasticsearch and Kibana resource in the 'elastic-stack' namespace
helm install my-release elastic/eck-stack -n elastic-stack --create-namespace
```

More information on the different ways to use the ECK Stack chart to deploy Elastic Stack resources
can be found in [our documentation](https://www.elastic.co/guide/en/cloud-on-k8s/current/index.html).

## Uninstalling the Chart

To uninstall/delete the `my-release` deployment from the 'elastic-stack' namespace:

```console
helm delete my-release -n elastic-stack
```

The command removes all the Elastic Stack resources associated with the chart and deletes the release.

## Configuration

The following table lists the configurable parameters of the eck-stack chart and their default values.

| Parameter | Description | Default |
| --------- | ----------- | ------- |
| `eck-elasticsearch.enabled` | If `true`, create an Elasticsearch resource (using the eck-elasticsearch Chart) | `true` |
| `eck-kibana.enabled` | If `true`, create a Kibana resource (using the eck-kibana Chart) | `true` |
| `eck-agent.enabled` | If `true`, create an Elastic Agent resource (using the eck-agent Chart) | `false` |
| `eck-fleet-server.enabled` | If `true`, create a Fleet Server resource (using the eck-fleet-server Chart) | `false` |
| `eck-logstash.enabled` | If `true`, create a Logstash resource (using the eck-logstash Chart) | `false` |
| `eck-apm-server.enabled` | If `true`, create a standalone Elastic APM Server resource (using the eck-apm-server Chart) | `false` |

Specify each parameter using the `--set key=value[,key=value]` argument to `helm install`.

Alternatively, a YAML file that specifies the values for the above parameters can be provided while installing the chart. For example,

```console
helm install my-release -f values.yaml .
```

## Contributing

This chart is maintained at [github.com/elastic/cloud-on-k8s](https://github.com/elastic/cloud-on-k8s/tree/main/deploy/eck-stack).
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
# Patterns to ignore when building packages.
# This supports shell glob matching, relative path matching, and
# negation (prefixed with !). Only one pattern per line.
.DS_Store
# Common VCS dirs
.git/
.gitignore
.bzr/
.bzrignore
.hg/
.hgignore
.svn/
# Common backup files
*.swp
*.bak
*.tmp
*.orig
*~
# Various IDEs
.project
.idea/
*.tmproj
.vscode/
templates/tests
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
apiVersion: v2
description: Elastic Agent managed by the ECK operator
icon: https://images.contentstack.io/v3/assets/bltefdd0b53724fa2ce/blt77c2da6e0198746e/620ac24e6662ca0a6f617114/icon-agent-32-color.svg
kubeVersion: '>= 1.21.0-0'
name: eck-agent
sources:
- https://github.com/elastic/cloud-on-k8s
- https://github.com/elastic/elastic-agent
type: application
version: 0.19.1
Loading
Loading