/opensearch-k8s-operator

OpenSearch k8s Operator

Primary LanguageGoApache License 2.0Apache-2.0

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.

To get all the capabilities of the Operator with a UI, you can use the free Opster Management Console. Beyond being able to easily carry out all of the actions provided by the Operator, it also include additional features like monitoring and more.

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.

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.
  • Auto scaler based on usage, load, and resources.

A full roadmap is available in the Development plan.

Installation

The Operator can be easily installed using Helm:

  1. Add the helm repo: helm repo add opensearch-operator https://opster.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

Manage OpenSearch on K8s through a single interface (UI)

To get all the capabilities of the Operator with a UI, you can use the free Opster Management Console. Beyond being able to easily carry out all of the actions provided by the Operator, it also include additional features like monitoring and more.

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.