Operating a replica set: opt-in, metrics, and an RF=3 Docker demo in Squirix preview.9

说明与用途

Squirix preview.9 的运维人员需要启用复制和故障转移，配置 mTLS，并通过健康端点和 Prometheus 指标验证就绪状态。

问题

Operators need to enable, verify, and monitor Squirix replica set failover and metrics in a Docker Compose environment.

结果

The cluster achieves automatic failover, quorum reads, and exposes detailed replication metrics, enabling operators to monitor leader status, lag, and state transfers.

工作流

• 1. Create Squirix.settings.json with ReplicaCount=3, PersistenceEnabled=true, ReplicationEnabled=true, AutomaticFailoverEnabled=true, QuorumReadsEnabled=true.
• 2. Configure mTLS certificates and CA bundle for inter-node authentication.
• 3. Validate configuration: squirix-server validate-config --settings ./Squirix.settings.json --strict.
• 4. Start each node with squirix-server run --settings ./Squirix.settings.json --persist --data-dir ./data --enable-replication ensuring all nodes are running before checking readiness.
• 5. Verify health endpoints /health, /health/ready, /health/ready/details and Prometheus metrics /metrics for replication status.
• 6. Use squirix-server doctor --settings ./Squirix.settings.json --persist --data-dir ./data to inspect topology stamp and metadata without starting the node.

证据

Setting ReplicaCount to three chooses how many copies hold a key. It does not enable durable storage, grant permission to replicate, or turn on elections.

来源

Replication has its own opt-in: Squirix:Cluster:ReplicationEnabled, default false, or the standalone-host flag --enable-replication.

来源

Automatic failover adds two settings, both off by default: AutomaticFailoverEnabled and QuorumReadsEnabled.

来源

The first activation of a fresh replica group needs every configured member, not just a majority.

来源

Readiness catches conditions such as unfinished journal recovery, a failed journal pipeline, or a detected ring mismatch.

来源