qpc-github / helm-charts-1

:wheel_of_dharma: A community repository for Helm Charts of OpenSearch Project.

• OpenSearch Project Helm-Charts
• Status
• Version and Branching
• Installation
• Change Logs
• Contributing
• Getting Help
• Code of Conduct
• Security
• License

Helm-Charts

A community repository for Helm Charts of OpenSearch Project.

Status

Version and Branching

As of now, this helm-charts repository maintains 3 branches:

• main (Version is 2.x.x for both version and appVersion in Chart.yaml)
• 1.x (Version is 1.x.x for both version and appVersion in Chart.yaml)
• gh-pages (Reserved branch for publishing helm-charts through github pages)

Contributors should choose the corresponding branch(es) when commiting their change(s):

• If you have a change for a specific version, only open PR to specific branch
• If you have a change for all available versions, first open a PR on main, then open a backport PR with [backport 1.x] in the title, with label backport 1.x, etc.
• No changes should be commited to gh-pages by any contributor, as this branch should be only changed by github actions chart-releaser

Kuvernetes Version Support

• This helm-chart repository is tested with kubernetes version 1.19 and above

Installation

To install the OpenSearch Helm charts, execute the following commands:

helm repo add opensearch https://opensearch-project.github.io/helm-charts/
helm repo update

Once the charts repository reference is added, you can run the following command to see the charts.

helm search repo opensearch

You can now deploy charts with this command.

helm install my-deployment opensearch/<chart name>

Please see the README.md in the OpenSearch and OpenSearch Dashboards directories for installation instructions.

Notes About Default Installation

By default, on startup, the install_demo_configuration.sh is runned via the opensearch-docker-entrypoint.sh script if DISABLE_INSTALL_DEMO_CONFIG is not true.

In case custom certificates are used and allow_unsafe_democertificates is set to false in the configuration, this can prevent pods to start with the following error: Demo certificates found but plugins.security.allow_unsafe_democertificates is set to false.

This can be solved by adding an environment variable in the value.yml:

extraEnvs:
  - name: DISABLE_INSTALL_DEMO_CONFIG
    value: "true"

Change Logs

Please review the OpenSearch and the OpenSearch Dashboards change logs for the latest release details.

Contributing

See developer guide and how to contribute to this project.

Getting Help

If you find a bug, or have a feature request, please don't hesitate to open an issue in this repository.

For more information, see project website and documentation. If you need help and are unsure where to open an issue, try forums.

Code of Conduct

This project has adopted the Amazon Open Source Code of Conduct. For more information see the Code of Conduct FAQ, or contact [email protected] with any additional questions or comments.

Security

If you discover a potential security issue in this project we ask that you notify AWS/Amazon Security via our vulnerability reporting page. Please do not create a public GitHub issue.

License

This project is licensed under the Apache v2.0 License.