Cassandra K8s key terms
Cassandra K8s · Get comfortable with the vocabulary.
- StatefulSet
- Related: Headless Service, PersistentVolumeClaim, PodDisruptionBudget
A Kubernetes workload controller that gives each pod a stable, ordinal identity, its own persistent volume claim, and ordered start, stop, and rolling update behavior, which is required for database pods.
- Headless Service
- Related: StatefulSet, Seed Node, Broadcast Address
A Service with clusterIP set to None that publishes per-pod DNS records instead of load balancing, letting Cassandra nodes and clients resolve individual pod addresses by name.
- PersistentVolumeClaim
- Related: StorageClass, StatefulSet, Local Persistent Volume
A namespaced request for storage that binds to a PersistentVolume and is mounted into a pod, decoupling the Cassandra data directory from the pod lifecycle.
- StorageClass
- Related: PersistentVolumeClaim, VolumeBindingMode, Reclaim Policy
A cluster-scoped template describing how volumes are dynamically provisioned, including the provisioner, parameters, reclaim policy, and volume binding mode used for Cassandra data disks.
- VolumeBindingMode
- Related: StorageClass, Local Persistent Volume, Topology Spread
A StorageClass field, either Immediate or WaitForFirstConsumer, that controls when binding occurs; WaitForFirstConsumer ensures the volume is created in the same zone as the scheduled pod.
- Local Persistent Volume
- Related: VolumeBindingMode, PersistentVolumeClaim, Rack Awareness
A PersistentVolume backed by a disk attached to one specific node, offering low latency and high throughput for Cassandra but sacrificing portability if that node is lost.
- Reclaim Policy
- Related: StorageClass, PersistentVolumeClaim, Snapshot
The rule controlling what happens to a PersistentVolume after its claim is deleted: Retain keeps data for manual recovery, while Delete removes the backing storage automatically.
- PodDisruptionBudget
- Related: StatefulSet, Rolling Restart, Node Drain
A policy that limits how many pods of a label selector may be voluntarily evicted at once, protecting Cassandra quorum during node drains and cluster maintenance.
- Node Drain
- Related: PodDisruptionBudget, Decommission, Rack Awareness
The kubectl operation that evicts pods from a Kubernetes node before maintenance, respecting PodDisruptionBudgets and triggering Cassandra data handoff when a node is removed.
- Cassandra Operator
- Related: Custom Resource Definition, Reconciliation Loop, CassandraDataCenter
A custom controller that watches custom resources describing a Cassandra cluster and reconciles actual StatefulSets, Services, and configuration to match the declared desired state.
- Custom Resource Definition
- Related: Cassandra Operator, Reconciliation Loop, Admission Webhook
A Kubernetes API extension that registers a new resource type, such as a Cassandra datacenter or cluster object, so the operator's custom resources can be stored and validated by the API server.
- Reconciliation Loop
- Related: Cassandra Operator, Custom Resource Definition, Rolling Restart
The continuous control cycle in which an operator compares observed cluster state with the desired spec and issues create, update, or delete calls until they converge.
- Admission Webhook
- Related: Custom Resource Definition, Cassandra Operator, Finalizer
An API server callback that validates or mutates custom resources before persistence, used by operators to reject invalid topology changes or to inject defaults and sidecars.
- Finalizer
- Related: Admission Webhook, Decommission, Reconciliation Loop
A metadata entry that blocks deletion of a custom resource until the controller completes cleanup such as decommissioning nodes or releasing storage, preventing orphaned cloud resources.
- Seed Node
- Related: Gossip Protocol, Headless Service, Bootstrap
A contact point listed in cassandra.yaml that new or restarting nodes query to learn cluster topology; seeds should be stable and not all seeds should restart simultaneously.
- Gossip Protocol
- Related: Seed Node, Failure Detector, Snitch
Cassandra's peer-to-peer membership and state dissemination mechanism, exchanging node, schema, and load information so every node converges on the same cluster view.
- Snitch
- Related: Rack Awareness, NetworkTopologyStrategy, Gossip Protocol
A Cassandra component that reports network topology and rack placement to the cluster, informing replica placement and request routing decisions.
- Rack Awareness
- Related: Snitch, NetworkTopologyStrategy, Topology Spread
Configuring Cassandra so replicas land in distinct racks or zones, ensuring a zone failure does not remove all copies of a partition's data.
- NetworkTopologyStrategy
- Related: Rack Awareness, Replication Factor, Consistency Level
A replication strategy that specifies replica counts per datacenter and, where racks are defined, distributes replicas across racks for fault tolerance.
- Replication Factor
- Related: NetworkTopologyStrategy, Consistency Level, Quorum
The number of copies of each partition stored across the cluster; it determines durability and the maximum consistency level achievable when nodes are unavailable.
- Consistency Level
- Related: Quorum, Replication Factor, Hinted Handoff
A per-query setting specifying how many replicas must acknowledge a read or write before returning success, trading latency and availability against data freshness.
- Quorum
- Related: Consistency Level, Replication Factor, Hinted Handoff
A majority of replicas, calculated as replication factor divided by two plus one, that must respond for strong consistency in reads and writes.
- Partition Key
- Related: Clustering Column, Token Ring, Data Model
The first component of a Cassandra primary key that is hashed by the partitioner to determine which node and replicas store a row, driving data distribution.
- Clustering Column
- Related: Partition Key, Data Model, Compaction
A primary key component after the partition key that defines sort order within a partition and enables efficient range slices on disk.
- Token Ring
- Related: Partition Key, Virtual Node, Bootstrap
The hash space from negative to positive values over which Cassandra distributes partitions; each node owns token ranges, and vnodes split ownership into many smaller ranges.
- Virtual Node
- Related: Token Ring, Bootstrap, Decommission
A configurable number of token ranges assigned per physical node, improving data distribution and speeding streaming during bootstrap and decommission.
- Bootstrap
- Related: Virtual Node, Decommission, Seed Node
The process by which a newly added node streams its assigned token ranges from existing replicas before joining the ring and serving traffic.
- Decommission
- Related: Bootstrap, Finalizer, Node Drain
The controlled removal of a node that streams its data to remaining replicas before leaving the ring, unlike simply deleting a pod.
- Hinted Handoff
- Related: Consistency Level, Quorum, Repair
A mechanism where a coordinator stores writes destined for an unavailable replica and replays them when that node returns, reducing temporary inconsistency.
- Repair
- Related: Hinted Handoff, Snapshot, Compaction
The anti-entropy process that compares replicas and reconciles divergent data, typically run with nodetool repair or the Reaper tool on a scheduled basis.
- Compaction
- Related: SSTable, Tombstone, Repair
The background merge of SSTables that removes tombstones and obsolete versions, reclaiming disk space and improving read performance.
- SSTable
- Related: Compaction, Commitlog, Snapshot
An immutable sorted on-disk file holding Cassandra rows for a token range, created by flushing memtables and later merged by compaction.
- Commitlog
- Related: SSTable, Snapshot, PersistentVolumeClaim
The append-only durability log written before memtables, replayed on restart to recover writes not yet flushed to SSTables.
- Snapshot
- Related: Commitlog, Repair, Reclaim Policy
A hard-linked point-in-time copy of SSTables on a node, used for backups; in Kubernetes it is often paired with volume snapshots for whole-disk capture.
- VolumeSnapshot
- Related: Snapshot, PersistentVolumeClaim, Restore
A Kubernetes API object that captures a point-in-time copy of a PersistentVolumeClaim through a CSI driver, enabling consistent cluster-wide backups when coordinated across pods.
- Restore
- Related: VolumeSnapshot, Snapshot, Repair
Rebuilding a cluster or keyspace from snapshots and commitlogs, then running repair, while ensuring the restored topology matches the original token ownership.
- Topology Spread
- Related: Rack Awareness, VolumeBindingMode, PodDisruptionBudget
A Kubernetes scheduling constraint that distributes pods evenly across zones or nodes, aligning Cassandra replica placement with failure domains.
- Rolling Restart
- Related: PodDisruptionBudget, StatefulSet, Reconciliation Loop
A controlled sequential restart of Cassandra pods, waiting for each node to rejoin and serve traffic before proceeding, to avoid losing quorum.
- Mutual TLS
- Related: Certificate Authority, Authentication, Authorization
Two-way certificate authentication where both client and server present certificates, commonly used between Cassandra nodes and between drivers and the cluster.
- Certificate Authority
- Related: Mutual TLS, cert-manager, Keystore
The entity that issues and signs certificates for nodes and clients; its certificate must be trusted by every participant for TLS handshakes to succeed.
- cert-manager
- Related: Certificate Authority, Mutual TLS, Keystore
A Kubernetes controller that automates issuance and renewal of TLS certificates as Secrets, simplifying rotation of Cassandra node and client certificates.
- Keystore
- Related: Truststore, Mutual TLS, Certificate Authority
A Java file holding a node's private key and certificate chain that Cassandra presents during TLS handshakes; its password is supplied through configuration or a Secret.
- Truststore
- Related: Keystore, Mutual TLS, Certificate Authority
A Java file containing certificates of trusted peers and authorities that Cassandra uses to verify incoming connections when TLS is enabled.
- Authentication
- Related: Authorization, Role, Mutual TLS
Verifying the identity of a connecting user or node, for example with the PasswordAuthenticator or a pluggable authenticator backed by an external identity system.
- Authorization
- Related: Authentication, Role, Superuser
Deciding which operations an authenticated identity may perform, governed by permissions granted to roles on keyspaces, tables, or the whole cluster.
- Role
- Related: Authorization, Authentication, Superuser
A named security principal that can hold permissions and be granted to users or other roles, supporting hierarchical privilege management in Cassandra.
- Superuser
- Related: Role, Authorization, Authentication
A built-in role with full cluster privileges, created at first startup; its default credentials must be changed and protected immediately in production.
- JMX Exporter
- Related: Prometheus, ServiceMonitor, Metrics Endpoint
A Java agent that exposes Cassandra MBean metrics over HTTP in Prometheus format, typically scraped through pod annotations and a ServiceMonitor.
- Prometheus
- Related: JMX Exporter, ServiceMonitor, Grafana Dashboard
A time-series monitoring system that scrapes metrics endpoints and evaluates alerting rules, commonly deployed alongside the Cassandra operator for observability.
- ServiceMonitor
- Related: Prometheus, JMX Exporter, Metrics Endpoint
A custom resource from the Prometheus Operator that selects Services and defines scrape intervals and paths for metric collection.
- Grafana Dashboard
- Related: Prometheus, ServiceMonitor, Metrics Endpoint
A visualization layer over Prometheus queries showing Cassandra latency, throughput, compaction backlog, and node health for operators and on-call engineers.