Skip to content

opensearch-project/opensearch-k8s-operator

build test release Golang Lint Artifact Hub

OpenSearch Kubernetes Operator

The Kubernetes OpenSearch Operator is used for automating the deployment, provisioning, management, and orchestration of OpenSearch clusters and OpenSearch dashboards.

Getting started

The Operator can be easily installed using helm on any CNCF-certified Kubernetes cluster. Please refer to the User Guide for installation instructions.

Roadmap

  • Auto-Scaler.
  • OpenShift support.
  • Data-prepper support.

Current feature list

Features:

  • Deploy a new OS cluster.
  • Ability to deploy multiple clusters.
  • Spin up OS dashboards.
  • Configuration of all node roles (master, data, coordinating..).
  • Scale the cluster resources (manually), per nodes' role group.
  • Drain strategy for scale down.
  • Version updates.
  • Change nodes' memory allocation and limits.
  • Secured installation features.
  • Certificate management.
  • Rolling restarts - through API.
  • Scaling nodes' disks - increase disk size.
  • Cluster configurations and nodes' settings updates.
  • Operator Monitoring, with Prometheus and Grafana.

Installation

The Operator can be easily installed using Helm:

  1. Add the helm repo: helm repo add opensearch-operator https://opensearch-project.github.io/opensearch-k8s-operator/
  2. Install the Operator: helm install opensearch-operator opensearch-operator/opensearch-operator

OpenSearch Kubernetes Operator installation & demo video

Watch the video

Compatibility

The opensearch k8s operator aims to be compatible to all supported opensearch versions. Please check the table below for details:

Operator Version Min Supported Opensearch Version Max supported Opensearch version Comment
2.3 1.0 2.8
2.2 1.0 2.5
2.1 1.0 2.3
2.0 1.0 2.3
1.x 1.0 1.x
0.x 1.0 1.x Beta

This table only lists versions that have been explicitly tested with the operator, the operator will not prevent you from using other versions. Newer minor versions (2.x) not listed here generally also work but you should proceed with caution and test it our in a non-production environment first.

Development

If you want to develop the operator, please see the separate developer docs.

Contributions

We welcome contributions! See how you can get involved by reading CONTRIBUTING.md.