Bitnami Apache Solr 软件包

Apache Solr 是一个基于 Apache Lucene 构建的极其强大的开源企业搜索平台。它具有高度可靠性、灵活性和可扩展性，旨在部署后快速提供价值。

Apache Solr 概述

商标声明：本软件列表由 Bitnami 打包。产品中提及的 respective 商标归各自公司所有，使用这些商标并不意味着任何关联或认可。

简明使用指南

helm install my-release oci://registry-1.docker.io/bitnamicharts/solr

希望在生产环境中使用 Apache Solr？试试 VMware Tanzu Application Catalog，即 Bitnami 目录的商业版。

⚠️ 重要通知：Bitnami 目录即将发生的变更

自 2025 年 8 月 28 日起，Bitnami 将升级其公共目录，在新的 Bitnami Secure Images 计划 下提供精选的强化、安全聚焦镜像集。作为此过渡的一部分：

• 首次向社区用户提供热门容器镜像的安全优化版本访问权限。
• Bitnami 将开始在其免费层级中弃用对非强化、基于 Debian 的软件镜像的支持，并将逐步从公共目录中移除非最新标签。因此，社区用户将只能访问数量减少的强化镜像。这些镜像仅以“latest”标签发布，旨在用于开发目的。
• 从 8 月 28 日开始，在两周内，所有现有容器镜像（包括旧版本或特定版本标签，例如 2.50.0、10.6）将从公共目录（docker.io/bitnami）迁移到“Bitnami Legacy”仓库（docker.io/bitnamilegacy），且不再接收更新。
• 对于生产工作负载和长期支持，建议用户采用 Bitnami Secure Images，其中包括强化容器、更小的攻击面、CVE 透明度（通过 VEX/KEV）、SBOM 以及企业支持。

这些变更旨在通过推广软件供应链完整性和最新部署的最佳实践，提高所有 Bitnami 用户的安全态势。有关更多详细信息，请访问 Bitnami Secure Images 公告。

简介

此 Chart 使用 Helm 包管理器在 Kubernetes 集群上引导 Solr 部署。

前提条件

• Kubernetes 1.23+
• Helm 3.8.0+
• 底层基础设施支持 PV 供应器
• 用于部署扩展的 ReadWriteMany 卷

安装 Chart

要使用发布名称 my-release 安装 Chart：

helm install my-release oci://REGISTRY_NAME/REPOSITORY_NAME/solr

注意：您需要将占位符 REGISTRY_NAME 和 REPOSITORY_NAME 替换为 Helm Chart 仓库和存储库的引用。例如，对于 Bitnami，需使用 REGISTRY_NAME=registry-1.docker.io 和 REPOSITORY_NAME=bitnamicharts。

这些命令以默认配置在 Kubernetes 集群上部署 Solr。参数 部分列出了安装期间可配置的参数。

提示：使用 helm list 列出所有发布

卸载 Chart

要卸载/删除 my-release statefulset：

helm delete my-release

该命令会移除与 Chart 关联的所有 Kubernetes 组件并删除发布。使用 --purge 选项可同时删除所有历史记录。

配置和安装详情

资源请求和限制

Bitnami Charts 允许为 Chart 部署内的所有容器设置资源请求和限制。这些设置位于 resources 值中（参见参数表）。设置请求对于生产工作负载至关重要，应根据您的具体用例进行调整。

为简化此过程，Chart 包含 resourcesPreset 值，可根据不同预设自动设置 resources 部分。在 bitnami/common chart 中查看这些预设。但是，在生产工作负载中不建议使用 resourcesPreset，因为它可能无法完全适应您的特定需求。有关容器资源管理的更多信息，请参阅 Kubernetes 官方文档。

更新凭证

Bitnami Charts 在首次启动时配置凭证。后续对密钥或凭证的任何更改都需要手动干预。请按照以下说明操作：

• 按照 上游文档 更新用户密码
• 使用新值更新密码密钥（替换 SECRET_NAME 和 PASSWORD 占位符）

kubectl create secret generic SECRET_NAME --from-literal=solr-password=PASSWORD --dry-run -o yaml | kubectl apply -f -

Prometheus 指标

通过将 metrics.enabled 设置为 true，此 Chart 可与 Prometheus 集成。这将部署带有 solr-exporter 的 Deployment 和 metrics 服务，可在 metrics.service 部分下进行配置。此 metrics 服务将具有必要的注解，以被 Prometheus 自动抓取。

Prometheus 要求

要使集成正常工作，需要安装 Prometheus 或 Prometheus Operator。安装 Bitnami Prometheus helm chart 或 Bitnami Kube Prometheus helm chart，可在集群中轻松获得可用的 Prometheus。

与 Prometheus Operator 集成

该 Chart 可以部署 ServiceMonitor 对象，以与 Prometheus Operator 安装集成。为此，将值 metrics.serviceMonitor.enabled 设置为 true。确保集群中已安装 Prometheus Operator CustomResourceDefinitions，否则将失败并显示以下错误：

no matches for kind "ServiceMonitor" in version "monitoring.coreos.com/v1"

安装 Bitnami Kube Prometheus helm chart 以获取必要的 CRD 和 Prometheus Operator。

滚动标签与不可变标签

强烈建议在生产环境中使用不可变标签。这可确保如果相同标签使用不同镜像更新，您的部署不会自动更改。

如果主容器有新版本、重大更改或严重漏洞，Bitnami 将发布新 Chart 更新其容器。

使用不同的 Apache Solr 版本

要修改此 Chart 中使用的应用版本，可使用 image.tag 参数指定不同的镜像版本，和/或使用 image.repository 参数指定不同的仓库。

添加额外环境变量

如果需要添加额外环境变量（用于高级操作，如自定义初始化脚本），可使用 extraEnvVars 属性。

extraEnvVars:
  - name: ZOOKEEPER_VERSION
    value: 6

或者，可使用带有环境变量的 ConfigMap 或 Secret。为此，使用 extraEnvVarsCM 或 extraEnvVarsSecret 值。

使用 Sidecars 和 Init Containers

如果在同一个 Pod 中需要额外容器（如额外的指标或日志导出器），可使用 sidecars 配置参数定义。

sidecars:
- name: your-image-name
  image: your-image
  imagePullPolicy: Always
  ports:
  - name: portname
    containerPort: 1234

如果这些 sidecars 导出额外端口，可使用 service.extraPorts 参数（如可用）添加额外端口定义，如下例所示：

service:
  extraPorts:
  - name: extraPort
    port: 11311
    targetPort: 11311

注意：此 Helm Chart 已包含用于 Prometheus 导出器的 sidecar 容器（如适用）。可在部署时添加 --enable-metrics=true 参数激活这些容器。因此，sidecars 参数应仅用于任何额外的 sidecar 容器。

如果在同一个 Pod 中需要额外的 init 容器，可使用 initContainers 参数定义。示例如下：

initContainers:
  - name: your-image-name
    image: your-image
    imagePullPolicy: Always
    ports:
      - name: portname
        containerPort: 1234

了解更多关于 sidecar 容器 和 init 容器 的信息。

设置 Pod 亲和性

此 Chart 允许使用 XXX.affinity 参数设置自定义亲和性。有关 Pod 亲和性的更多信息，请参阅 Kubernetes 文档。

作为替代方案，可使用 bitnami/common chart 中提供的 Pod 亲和性、Pod 反亲和性和节点亲和性预设配置。为此，设置 XXX.podAffinityPreset、XXX.podAntiAffinityPreset 或 XXX.nodeAffinityPreset 参数。

使用 TLS 保护流量

通过设置 tls.enabled=true，Solr 可以加密通信。Chart 允许两种配置选项：

• 使用 tls.certificatesSecretName 值提供您自己的密钥。还需使用 tls.keystorePassword、tls.truststorePassword 值设置正确的密钥库和信任库密码名称（如需要）。
• 使用 tls.autoGenerated=true 让 Chart 自动生成证书。

备份和恢复

要在 Kubernetes 上备份和恢复 Helm Chart 部署，需要使用 Velero（Kubernetes 备份/恢复工具）备份源部署的持久卷，并将其附加到新部署。在 本指南 中查找使用 Velero 的说明。

持久化

Bitnami Solr 镜像可以持久化数据。如果启用，默认持久化路径为 /bitnami/solr。

Chart 在此位置挂载 持久卷。卷是使用动态卷供应创建的。

添加额外卷

Bitnami Solr Chart 支持通过使用 extraVolumes 和 extraVolumeMounts 属性挂载额外卷（PVC、密钥或配置映射）。这可以与添加额外 init 容器和 sidecars 等高级操作结合使用。

调整持久卷挂载点的权限

由于镜像默认以非 root 用户运行，因此需要调整持久卷的所有权，以便容器可以向其中写入数据。

默认情况下，Chart 配置为使用 Kubernetes 安全上下文自动更改卷的所有权。但是，此功能并非在所有 Kubernetes 发行版中都有效。

作为替代方案，此 Chart 支持使用 initContainer 在将卷挂载到最终目标之前更改其所有权。

可通过将 volumePermissions.enabled 设置为 true 启用此 initContainer。

参数

全局参数

通用参数

Solr 参数

Solr statefulset 参数

| 名称 |