Solr Operator Documentation

Solr Clouds

Child Pages:

The Solr Operator supports creating and managing Solr Clouds.

This page outlines how to create, update and delete a SolrCloud in Kubernetes.

Creating an example SolrCloud

Make sure that the Solr Operator and a Zookeeper Operator are running.

Create an example Solr cloud, with the following configuration.

$ cat example/test_solrcloud.yaml

kind: SolrCloud
  name: example
  replicas: 4
    tag: 8.1.1

Apply it to your Kubernetes cluster.

$ kubectl apply -f example/test_solrcloud.yaml
$ kubectl get solrclouds

example   8.1.1     4              2       1            2m

$ kubectl get solrclouds

example   8.1.1     4              4       4            8m

What actually gets created when you start a Solr Cloud though? Refer to the dependencies outline to see what dependent Kuberenetes resources are created in order to run a Solr Cloud.

Scaling a SolrCloud

The SolrCloud CRD support the Kubernetes scale operation, to increase and decrease the number of Solr Nodes that are running within the cloud.

# Issue the scale command
kubectl scale --replicas=5 solrcloud/example

For more information on SolrCloud scaling, refer to the scaling page.

After issuing the scale command, start hitting the “Refresh” button in the Admin UI. You will see how the new Solr nodes are added. You can also watch the status via the kubectl get solrclouds command:

watch -dc kubectl get solrclouds

# Hit Control-C when done

Deleting the example SolrCloud

Delete the example SolrCloud

$ kubectl delete solrcloud example

Solr Images

Official Solr Images

The Solr Operator is only guaranteed to work with official Solr images. However, as long as your custom image is built to be compatible with the official image, things should go smoothly. This is especially true starting with Solr 9, where the docker image creation is bundled within Solr. Run ./gradlew docker in the Solr repository, and your custom Solr additions will be packaged into an officially compliant Solr Docker image.

Please refer to the Version Compatibility Matrix for more information on what Solr Versions are compatible with the Solr Operator.

Also note that certain features available within the Solr Operator are only supported in newer Solr Versions. The version compatibility matrix shows the minimum Solr version supported for most options. Please refer to the Solr Reference guide to see what features are enabled for the Solr version you are running.

Build Your Own Private Solr Images

The Solr Operator supports private Docker repo access for Solr images you may want to store in a private Docker repo. It is recommended to source your image from the official Solr images.

Using a private image requires you have a K8s secret preconfigured with appropriate access to the image. (type:

kind: SolrCloud
  name: example-private-repo-solr-image
  replicas: 3
    tag: 8.2.0
    imagePullSecret: "k8s-docker-registry-secret"