bitnamicharts/cassandra

Bitnami Apache Cassandra 软件包

Apache Cassandra 是一个开源分布式数据库管理系统，旨在跨多台服务器处理大量数据，提供高可用性且无单点故障。

Apache Cassandra 概述

商标说明：本软件列表由Bitnami打包。所提及的相应商标归各自公司所有，使用这些商标并不意味着任何关联或背书。

快速使用

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

希望在生产环境中使用Apache Cassandra？请尝试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用户的安全态势。更多详情，请访问https://github.com/bitnami/containers/issues/83267%E3%80%82

简介

本Chart使用Helm包管理器在Kubernetes集群上引导部署https://github.com/bitnami/containers/tree/main/bitnami/cassandra%E3%80%82

前提条件

• Kubernetes 1.23+
• Helm 3.8.0+
• 底层基础设施支持PV供应器

安装Chart

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

console
helm install my-release oci://REGISTRY_NAME/REPOSITORY_NAME/cassandra

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

这些命令以默认配置在Kubernetes集群上部署一个节点的Apache Cassandra。参数部分列出了可在安装过程中配置的参数。

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

配置和安装详情

资源请求和限制

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

为简化此过程，Chart包含resourcesPreset值，可根据不同预设自动设置resources部分。有关这些预设，请查看https://github.com/bitnami/charts/blob/main/bitnami/common/templates/_resources.tpl#L15%E3%80%82%E4%BD%86%E5%9C%A8%E7%94%9F%E4%BA%A7%E5%B7%A5%E4%BD%9C%E8%B4%9F%E8%BD%BD%E4%B8%AD%EF%BC%8C%E4%B8%8D%E5%BB%BA%E8%AE%AE%E4%BD%BF%E7%94%A8%60resourcesPreset%60%EF%BC%8C%E5%9B%A0%E4%B8%BA%E5%AE%83%E5%8F%AF%E8%83%BD%E6%97%A0%E6%B3%95%E5%AE%8C%E5%85%A8%E9%80%82%E5%BA%94%E6%82%A8%E7%9A%84%E7%89%B9%E5%AE%9A%E9%9C%80%E6%B1%82%E3%80%82%E6%9C%89%E5%85%B3%E5%AE%B9%E5%99%A8%E8%B5%84%E6%BA%90%E7%AE%A1%E7%90%86%E7%9A%84%E6%9B%B4%E5%A4%9A%E4%BF%A1%E6%81%AF%EF%BC%8C%E8%AF%B7%E5%8F%82%E9%98%85%E5%AE%98%E6%96%B9Kubernetes%E6%96%87%E6%A1%A3%E3%80%82

更新凭证

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

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

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

滚动标签与不可变标签

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

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

Prometheus监控指标

通过将metrics.enabled设置为true，本Chart可与Prometheus集成。这将在所有Pod中部署带有https://github.com/criteo/cassandra_exporter%E7%9A%84%E8%BE%B9%E8%BD%A6%E5%AE%B9%E5%99%A8%EF%BC%8C%E5%B9%B6%E9%80%9A%E8%BF%87Cassandra%E6%9C%8D%E5%8A%A1%E6%9A%B4%E9%9C%B2%E6%8C%87%E6%A0%87%E3%80%82%E8%AF%A5%E6%9C%8D%E5%8A%A1%E5%B0%86%E5%85%B7%E6%9C%89%E5%BF%85%E8%A6%81%E7%9A%84%E6%B3%A8%E8%A7%A3%EF%BC%8C%E5%8F%AF%E8%A2%ABPrometheus%E8%87%AA%E5%8A%A8%E6%8A%93%E5%8F%96%E3%80%82

Prometheus要求

要使集成工作，需要安装Prometheus或Prometheus Operator。安装https://github.com/bitnami/charts/tree/main/bitnami/prometheus%E6%88%96https://github.com/bitnami/charts/tree/main/bitnami/kube-prometheus%EF%BC%8C%E5%8F%AF%E8%BD%BB%E6%9D%BE%E5%9C%A8%E9%9B%86%E7%BE%A4%E4%B8%AD%E9%83%A8%E7%BD%B2%E5%8F%AF%E7%94%A8%E7%9A%84Prometheus%E3%80%82

与Prometheus Operator集成

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

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

安装https://github.com/bitnami/charts/tree/main/bitnami/kube-prometheus%E4%BB%A5%E8%8E%B7%E5%8F%96%E5%BF%85%E8%A6%81%E7%9A%84CRD%E5%92%8CPrometheus Operator。

启用TLS

本Chart支持客户端与服务器之间以及节点之间的TLS，如下所述：

• 对于节点间集群加密，将tls.internodeEncryptionChart参数设置为非none的值。可用值为all、dc或rack。
• 对于客户端-服务器加密，将tls.clientEncryptionChart参数设置为true。

在这两种情况下，还需要创建包含密钥库和信任库证书及其相应保护密码的密钥，并在部署时通过tls.existingSecret参数将此密钥传递给Chart，如下所示：

text
tls.internodeEncryption=all
tls.clientEncryption=true
tls.existingSecret=my-exisiting-stores
tls.passwordsSecret=my-stores-password

提示：可使用--from-file=./keystore、--from-file=./truststore、--from-literal=keystore-password=KEYSTORE_PASSWORD和--from-literal=truststore-password=TRUSTSTORE_PASSWORD选项以标准方式创建密钥。假设存储库在当前工作目录中，且KEYSTORE_PASSWORD和TRUSTSTORE_PASSWORD占位符替换为正确的密钥库和信任库密码。示例：

console
kubectl create secret generic my-exisiting-stores --from-file=./keystore --from-file=./truststore
kubectl create secret generic my-stores-password --from-literal=keystore-password=KEYSTORE_PASSWORD --from-literal=truststore-password=TRUSTSTORE_PASSWORD

密钥库和信任库文件可从证书文件动态创建。在这种情况下，需要包含pem格式的tls.crt、tls.key和ca.crt的密钥。以下示例显示如何创建密钥，并假设所有证书文件都在工作目录中：

console
kubectl create secret tls my-certs --cert ./tls.crt --key ./tls.key
kubectl patch secret my-certs -p="{\"data\":{\"ca.crt\": \"$(cat ./ca.crt | base64 )\"}}"

要启用此功能，必须设置tls.autoGenerated，并将新密钥设置在tls.certificateSecret中：

text
tls.internodeEncryption=all
tls.clientEncryption=true
tls.autoGenerated=true
tls.certificatesSecret=my-certs
tls.passwordsSecret=my-stores-password

初始化数据库

https://github.com/bitnami/containers/tree/main/bitnami/cassandra%E9%95%9C%E5%83%8F%E6%94%AF%E6%8C%81%E4%BD%BF%E7%94%A8%E8%87%AA%E5%AE%9A%E4%B9%89%E8%84%9A%E6%9C%AC%E5%88%9D%E5%A7%8B%E5%8C%96%E6%96%B0%E5%AE%9E%E4%BE%8B%E3%80%82%E5%8F%AF%E9%80%9A%E8%BF%87%E5%88%9B%E5%BB%BA%E5%8C%85%E5%90%AB%E5%BF%85%E8%A6%81%60.sh%60%E6%88%96%60.cql%60%E8%84%9A%E6%9C%AC%E7%9A%84Kubernetes ConfigMap，并通过initDBConfigMap参数将此ConfigMap传递给Chart来实现。

使用自定义配置文件

本Chart还支持挂载Apache Cassandra的自定义配置文件。通过将existingConfiguration参数设置为包含自定义配置文件的ConfigMap名称来实现。以下是使用存储在名为cassandra-configuration的ConfigMap中的自定义配置文件部署Chart的示例：

text
existingConfiguration=cassandra-configuration

注意：此ConfigMap将覆盖Chart中设置的其他Apache Cassandra配置变量。

备份和恢复

请参阅详细教程在Kubernetes上备份和恢复Bitnami Apache Cassandra部署。

设置Pod亲和性

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

作为替代方案，您可以使用https://github.com/bitnami/charts/tree/main/bitnami/common#affinitiesChart%E4%B8%AD%E6%8F%90%E4%BE%9B%E7%9A%84Pod%E4%BA%B2%E5%92%8C%E6%80%A7%E3%80%81Pod%E5%8F%8D%E4%BA%B2%E5%92%8C%E6%80%A7%E5%92%8C%E8%8A%82%E7%82%B9%E4%BA%B2%E5%92%8C%E6%80%A7%E9%A2%84%E8%AE%BE%E9%85%8D%E7%BD%AE%E3%80%82%E4%B8%BA%E6%AD%A4%EF%BC%8C%E8%AE%BE%E7%BD%AE%60XXX.podAffinityPreset%60%E3%80%81%60XXX.podAntiAffinityPreset%60%E6%88%96%60XXX.nodeAffinityPreset%60%E5%8F%82%E6%95%B0%E3%80%82

持久化

https://github.com/bitnami/containers/tree/main/bitnami/cassandra%E9%95%9C%E5%83%8F%E5%B0%86Apache Cassandra数据存储在容器的/bitnami/cassandra路径下。

持久卷声明（Persistent Volume Claims）用于跨部署保留数据。已知在GCE、AWS和minikube中有效。 请参阅参数部分配置PVC或禁用持久化。

如果在使用持久卷时遇到错误，请参阅持久卷故障排除指南。

调整持久卷挂载点的权限

由于镜像默认以非root用户运行，需要调整持久卷的所有权，以便容器可以写入数据。有两种方法可实现此目的：

• 通过将podSecurityContext.enabled和containerSecurityContext.enabled设置为true来使用Kubernetes SecurityContexts。此选项在Chart中默认启用。但并非所有Kubernetes发行版都支持此功能。
• 使用初始化容器在将卷挂载到最终目标之前更改卷的所有权。通过将volumePermissions.enabled参数设置为true启用此容器。

参数

全局参数

通用参数

Cassandra参数