TheSolr Operatoris the official way of managing an Apache Solr ecosystem within Kubernetes. It is built on top of theKube Builderframework. Please visit theofficial sitefor more information.
The project isProduction Ready,and has been successfully used to manage production SolrClouds for some of the largest users of Solr.
The API Version is still beta (v1beta1
), and minor versions can have backwards-incompatible API changes.
However, the Solr Operator will always have upgrade paths that are backwards-compatible.
Please check theversion compatibility and upgrade/deprecation notesfor more information.
If you run into issues using the Solr Operator, please:
- Reference theversion compatibility and upgrade/deprecation notesprovided below
- Create a GitHub Issue in this repo, describing your problem with as much detail as possible
- Reach out on our Slack channel!
Join us on the#solr-operatorchannel in the official Kubernetes slack workspace.
- Documentation
- Version Compatibility and Upgrade Notes
- Contributions
- License
- Code of Conduct
- Security Vulnerability Reporting
Please visit the following pages for documentation on using and developing the Solr Operator:
- Local Tutorial
- Helm Instructions via Artifact Hub
- The released helm charts and their instructions should be used for all safe and stable deployments.
The charts found in
helm/
are not guaranteed to be compatible with the last stable release, and should only be used for development purposes.
- The released helm charts and their instructions should be used for all safe and stable deployments.
The charts found in
- Running the Solr Operator
- Known Issues
- Available Solr Resources
- Development
Example uses of each CRD have beenprovided.
Make sure to check theSolr Operator Upgrade notes,before upgrading the Solr Operator or CRDs in your Kubernetes cluster.
This page also containsVersion Compatibility Matrixes,which detail the compatible Solr versions and Kubernetes versions for each release of the Solr Operator.
We ❤️ contributions.
Have you had a good experience with theSolr Operator?Why not share some love and contribute code, or just let us know about any issues you had with it?
We welcome issue reportshere;be sure to choose the proper issue template for your issue, so that we can be sure you're providing the necessary information.
Before submitting a PR, please be sure to runmake prepare
before committing.
Otherwise the GitHub checks are likely to fail.
If you are trying to run tests locally in IntelliJ/GoLand, refer tothe IDEA tests docs.
Please refer to theE2E/Integration Testing guidefor information on how to run full integration tests for your changes.
Please read theLICENSEfile here.
The Solr Operator docker image contains NOTICE and LICENSE information in the/etc/licenses
directory.
This is different from the source release LICENSE and NOTICE files, so make sure to familiarize yourself when using the image.
This space applies the ASFCode of Conduct If you have any concerns about the Code, or behavior which you have experienced in the project, please contact us at[email protected].
If you believe you have identified a security vulnerability in this project, please send email to the ASF security team at[email protected],detailing the suspected issue and any methods you've found to reproduce it. More details can be foundhere
Please do NOT open an issue in the GitHub repository, as we'd prefer to keep vulnerability reports private until we've had an opportunity to review and address them.
The Solr Operator was donated to Apache Solr by Bloomberg, after the v0.2.8 release. Many thanks to their contributions over the years!