Couchbase उत्पादन में उच्च उपलब्धता: XDCR, Kubernetes ऑपरेटर, और बहु-क्षेत्रीय तैनाती

उत्पादन HA परिनियोजन के लिए, एक मजबूत बैकअप रणनीति Couchbase-स्तरीय बैकअप को क्लाउड स्नैपशॉट क्षमताओं के साथ जोड़ती है।

बैकअप कॉन्फ़िगरेशन

# Initialize a backup repository
/opt/couchbase/bin/cbbackupmgr config \
  --archive /backup/couchbase \
  --repo production-backup \
  --include-data production-data \
  --include-data user-profiles \
  --exclude-data _system

# Run a full backup
/opt/couchbase/bin/cbbackupmgr backup \
  --archive /backup/couchbase \
  --repo production-backup \
  --cluster couchbase://localhost \
  --username Administrator \
  --password "$CB_PASSWORD" \
  --threads 4 \
  --no-progress-bar

# Run an incremental backup (only mutations since last backup)
/opt/couchbase/bin/cbbackupmgr backup \
  --archive /backup/couchbase \
  --repo production-backup \
  --cluster couchbase://localhost \
  --username Administrator \
  --password "$CB_PASSWORD" \
  --threads 4

# List available backups
/opt/couchbase/bin/cbbackupmgr list \
  --archive /backup/couchbase \
  --repo production-backup

# Restore from a specific backup
/opt/couchbase/bin/cbbackupmgr restore \
  --archive /backup/couchbase \
  --repo production-backup \
  --cluster couchbase://target-cluster:8091 \
  --username Administrator \
  --password "$CB_PASSWORD" \
  --start 2026-04-12T00_00_00 \
  --end 2026-04-12T14_30_00 \
  --threads 4

स्वचालित बैकअप स्क्रिप्ट

#!/bin/bash
# couchbase-backup.sh — Automated backup to S3-compatible storage

set -euo pipefail

CLUSTER_HOST="cb-production-srv.couchbase.svc.cluster.local"
BACKUP_DIR="/backup/couchbase"
REPO_NAME="prod-$(date +%Y%m%d)"
S3_BUCKET="s3://couchbase-backups/production"
RETENTION_DAYS=14

log() { echo "[$(date +'%Y-%m-%d %H:%M:%S')] $*"; }

log "Starting Couchbase backup for cluster: $CLUSTER_HOST"

if [ ! -d "$BACKUP_DIR/$REPO_NAME" ]; then
  log "Configuring new backup repository: $REPO_NAME"
  cbbackupmgr config \
    --archive "$BACKUP_DIR" \
    --repo "$REPO_NAME" \
    --include-data production-data \
    --include-data user-profiles
fi

log "Running incremental backup..."
cbbackupmgr backup \
  --archive "$BACKUP_DIR" \
  --repo "$REPO_NAME" \
  --cluster "couchbase://$CLUSTER_HOST" \
  --username "$CB_USERNAME" \
  --password "$CB_PASSWORD" \
  --threads 4 \
  --no-progress-bar

BACKUP_SIZE=$(du -sh "$BACKUP_DIR/$REPO_NAME" | cut -f1)
log "Backup complete. Size: $BACKUP_SIZE"

log "Syncing to S3: $S3_BUCKET/$REPO_NAME"
aws s3 sync "$BACKUP_DIR/$REPO_NAME" "$S3_BUCKET/$REPO_NAME" \
  --storage-class STANDARD_IA \
  --sse aws:kms

log "Cleaning up backups older than $RETENTION_DAYS days..."
find "$BACKUP_DIR" -maxdepth 1 -name "prod-*" -mtime +"$RETENTION_DAYS" -exec rm -rf {} \;

log "Backup pipeline complete."

Couchbaseबैकअप CRD (ऑपरेटर-प्रबंधित)

स्वायत्त ऑपरेटर स्वचालित बैकअप प्रबंधन के लिए CRDs प्रदान करता है:

apiVersion: couchbase.com/v2
kind: CouchbaseBackup
metadata:
  name: cb-daily-backup
  namespace: couchbase
spec:
  strategy: full_incremental
  full:
    schedule: "0 2 * * 0"   # Full backup every Sunday at 2 AM
  incremental:
    schedule: "0 2 * * 1-6" # Incremental Mon-Sat at 2 AM
  successfulJobsHistoryLimit: 5
  failedJobsHistoryLimit: 3
  backOffLimit: 3
  logRetention: 168h
  size: 100Gi
  s3bucket: s3://couchbase-backups/production
---
apiVersion: couchbase.com/v2
kind: CouchbaseBackupRestore
metadata:
  name: cb-restore-pitr
  namespace: couchbase
spec:
  backup: cb-daily-backup
  repo: "20260412"
  start:
    int: 1
  end:
    int: 5
  backOffLimit: 3

N1QL क्वेरी प्रदर्शन ट्यूनिंग

N1QL (JSON के लिए SQL++) Couchbase की क्वेरी भाषा है। N1QL प्रदर्शन को ट्यून करने के लिए क्वेरी प्लानर, इंडेक्स डिज़ाइन और सर्वर-साइड ऑप्टिमाइज़ेशन को समझने की आवश्यकता होती है।

सूचकांक रणनीतियाँ: GSI और FTS

-- Global Secondary Index (GSI) for common query patterns

-- Composite index for user lookups
CREATE INDEX idx_users_email_status
  ON `user-profiles`(email, status)
  WHERE type = 'user'
  WITH {"num_replica": 1, "defer_build": false};

-- Covering index (includes all queried fields to avoid fetch)
CREATE INDEX idx_orders_covering
  ON `production-data`(customer_id, order_date, total_amount, status)
  WHERE type = 'order'
  WITH {"num_replica": 1};

-- Array index for nested documents
CREATE INDEX idx_order_items
  ON `production-data`(DISTINCT ARRAY item.product_id FOR item IN items END)
  WHERE type = 'order'
  WITH {"num_replica": 1};

-- Partial index for active records only
CREATE INDEX idx_active_sessions
  ON `production-data`(user_id, created_at)
  WHERE type = 'session' AND status = 'active'
  WITH {"num_replica": 1};

-- Adaptive index for dynamic query patterns
CREATE INDEX idx_adaptive_products
  ON `production-data`(DISTINCT PAIRS(self))
  WHERE type = 'product'
  WITH {"num_replica": 1};

-- Check index status
SELECT name, state, num_docs_indexed, num_docs_pending
FROM system:indexes
WHERE keyspace_id = 'production-data';

-- Analyze query execution plan
EXPLAIN SELECT u.name, u.email, COUNT(o.id) AS order_count
FROM `user-profiles` u
JOIN `production-data` o ON o.customer_id = u.id
WHERE u.status = 'active' AND o.type = 'order'
GROUP BY u.name, u.email
ORDER BY order_count DESC
LIMIT 100;

-- Use ADVISE to get index recommendations
ADVISE SELECT * FROM `production-data`
WHERE type = 'order'
  AND customer_id = 'cust-12345'
  AND order_date BETWEEN '2026-01-01' AND '2026-04-12'
ORDER BY order_date DESC;

क्वेरी अनुकूलन युक्तियाँ

-- Use PREPARE for frequently executed queries (cached plan)
PREPARE get_user_orders AS
SELECT o.id, o.order_date, o.total_amount, o.status
FROM `production-data` o
WHERE o.type = 'order'
  AND o.customer_id = $customer_id
ORDER BY o.order_date DESC
LIMIT $page_size OFFSET $page_offset;

-- Execute prepared statement
EXECUTE get_user_orders
USING {"customer_id": "cust-12345", "page_size": 20, "page_offset": 0};

-- Use META().id for direct key-value lookups (fastest path)
SELECT META().id, *
FROM `production-data`
USE KEYS ["order::2026-001", "order::2026-002", "order::2026-003"];

-- Correlated subquery with USE KEYS for joins
SELECT u.name,
  (SELECT o.id, o.total_amount
   FROM `production-data` o
   USE KEYS u.order_ids
   WHERE o.status = 'completed') AS completed_orders
FROM `user-profiles` u
WHERE META(u).id = 'user::12345';

-- Use INFER to understand document schema
INFER `production-data` WITH {"sample_size": 10000, "similarity_metric": 0.6};

मेमोरी प्रबंधन और बकेट कॉन्फ़िगरेशन

Couchbase की मेमोरी-फर्स्ट आर्किटेक्चर का मतलब है कि रैम आवंटन सीधे प्रदर्शन को प्रभावित करता है। प्रत्येक सेवा का अपना मेमोरी कोटा होता है, और बकेट डेटा सेवा कोटा साझा करते हैं। उचित आकार कैश निष्कासन को रोकता है जो विलंबता को कम करता है।

# Configure cluster-level memory quotas
/opt/couchbase/bin/couchbase-cli setting-cluster \
  --cluster localhost:8091 \
  --username Administrator \
  --password password \
  --cluster-ramsize 8192 \
  --cluster-index-ramsize 4096 \
  --cluster-fts-ramsize 2048 \
  --cluster-eventing-ramsize 2048 \
  --cluster-analytics-ramsize 4096

# Memory allocation guidelines:
# Data Service:      60% of available node RAM
# Index Service:     20% of available node RAM
# Search Service:    10% of available node RAM
# OS/overhead:       10% reserved

# Bucket memory sizing formula:
# Required RAM = (avg_doc_size * num_docs * 2.5) / num_data_nodes
# The 2.5 multiplier accounts for:
#   - Metadata overhead (~56 bytes per document)
#   - Internal fragmentation
#   - Replica copies in memory

# Create an optimized production bucket
curl -X POST http://localhost:8091/pools/default/buckets \
  -u Administrator:password \
  -d name=production-data \
  -d ramQuota=4096 \
  -d bucketType=couchbase \
  -d replicaNumber=2 \
  -d threadsNumber=8 \
  -d evictionPolicy=valueOnly \
  -d compressionMode=active \
  -d maxTTL=0 \
  -d conflictResolutionType=lww \
  -d flushEnabled=0 \
  -d durabilityMinLevel=majorityAndPersistActive

# Eviction policies:
# valueOnly  - Evicts document values but keeps metadata in RAM
#              Best for workloads where key access patterns are predictable
# fullEviction - Evicts both values and metadata
#                Best for very large datasets that exceed available RAM
# noEviction - (Ephemeral buckets only) Rejects writes when RAM is full
#              Best for caching use cases

TLS एन्क्रिप्शन और RBAC

उत्पादन में Couchbase को सुरक्षित करने के लिए ट्रांज़िट में डेटा के एन्क्रिप्शन (TLS), फ़ाइन-ग्रेन्ड रोल-आधारित एक्सेस कंट्रोल (RBAC), और ऑडिट लॉगिंग की आवश्यकता होती है।

# Enable TLS for all Couchbase services
/opt/couchbase/bin/couchbase-cli ssl-manage \
  --cluster localhost:8091 \
  --username Administrator \
  --password password \
  --set-node-certificate

# Enforce minimum TLS version
/opt/couchbase/bin/couchbase-cli setting-security \
  --cluster localhost:8091 \
  --username Administrator \
  --password password \
  --set \
  --tls-min-version tlsv1.2 \
  --tls-honor-cipher-order 1 \
  --hsts-max-age 31536000 \
  --hsts-preload-enabled 1

# Create application-specific RBAC users
/opt/couchbase/bin/couchbase-cli user-manage \
  --cluster localhost:8091 \
  --username Administrator \
  --password password \
  --set \
  --rbac-username app-service \
  --rbac-password "$(openssl rand -base64 32)" \
  --rbac-name "Application Service Account" \
  --roles 'data_reader[production-data],data_writer[production-data],query_select[production-data],query_insert[production-data],query_update[production-data],query_delete[production-data]' \
  --auth-domain local

# Create a read-only analytics user
/opt/couchbase/bin/couchbase-cli user-manage \
  --cluster localhost:8091 \
  --username Administrator \
  --password password \
  --set \
  --rbac-username analytics-reader \
  --rbac-password "$(openssl rand -base64 32)" \
  --roles 'data_reader[production-data],query_select[production-data],analytics_reader[production-data]' \
  --auth-domain local

# Enable audit logging
/opt/couchbase/bin/couchbase-cli setting-audit \
  --cluster localhost:8091 \
  --username Administrator \
  --password password \
  --set \
  --audit-enabled 1 \
  --audit-log-path /opt/couchbase/var/lib/couchbase/logs \
  --audit-log-rotate-interval 86400 \
  --audit-log-rotate-size 20971520

Kubernetes TLS

# Certificate for Couchbase server TLS
apiVersion: cert-manager.io/v1
kind: Certificate
metadata:
  name: couchbase-server-tls
  namespace: couchbase
spec:
  secretName: couchbase-server-tls
  duration: 8760h   # 1 year
  renewBefore: 720h  # 30 days before expiry
  privateKey:
    algorithm: RSA
    size: 4096
  usages:
  - server auth
  - client auth
  dnsNames:
  - "*.cb-production.couchbase.svc.cluster.local"
  - "*.cb-production.couchbase.svc"
  - "cb-production-srv.couchbase.svc.cluster.local"
  - "localhost"
  issuerRef:
    name: couchbase-ca-issuer
    kind: ClusterIssuer

Prometheus निर्यातक

की निगरानी

Couchbase अपने REST API के माध्यम से समृद्ध मेट्रिक्स को उजागर करता है।couchbase-exporterव्यापक निगरानी के लिए इन्हें Prometheus प्रारूप में अनुवादित करता है।

# Deploy Couchbase Prometheus Exporter
apiVersion: apps/v1
kind: Deployment
metadata:
  name: couchbase-exporter
  namespace: couchbase
spec:
  replicas: 1
  selector:
    matchLabels:
      app: couchbase-exporter
  template:
    metadata:
      labels:
        app: couchbase-exporter
      annotations:
        prometheus.io/scrape: "true"
        prometheus.io/port: "9091"
    spec:
      containers:
      - name: exporter
        image: couchbase/exporter:1.0.9
        args:
        - --couchbase-address=cb-production-srv.couchbase.svc.cluster.local
        - --couchbase-port=8091
        - --couchbase-username=$(CB_USERNAME)
        - --couchbase-password=$(CB_PASSWORD)
        - --server-address=0.0.0.0:9091
        - --per-node-refresh=5
        env:
        - name: CB_USERNAME
          valueFrom:
            secretKeyRef:
              name: cb-admin-credentials
              key: username
        - name: CB_PASSWORD
          valueFrom:
            secretKeyRef:
              name: cb-admin-credentials
              key: password
        ports:
        - containerPort: 9091
          name: metrics
        resources:
          requests:
            cpu: 100m
            memory: 128Mi
          limits:
            cpu: 500m
            memory: 256Mi
---
apiVersion: monitoring.coreos.com/v1
kind: ServiceMonitor
metadata:
  name: couchbase-monitor
  namespace: couchbase
spec:
  selector:
    matchLabels:
      app: couchbase-exporter
  endpoints:
  - port: metrics
    interval: 15s
    path: /metrics

कुंजी Couchbase मेट्रिक्स

• cb_bucket_ops_per_sec- प्रति सेकंड प्रति बाल्टी कुल संचालन। अपने सामान्य थ्रूपुट को बेसलाइन करें और विसंगतियों पर सचेत करें।
• cb_bucket_mem_used_bytes— बकेट मेमोरी उपयोग। निष्कासन को रोकने के लिए रैम कोटा के करीब पहुंचने पर अलर्ट करें।
• cb_bucket_cache_miss_ratio- उन अनुरोधों का अनुपात जो कैश से चूक जाते हैं और डिस्क लाने की आवश्यकता होती है। सर्वोत्तम प्रदर्शन के लिए 2% से नीचे रहना चाहिए।
• cb_bucket_disk_queue_items- डिस्क लेखन कतार गहराई। बढ़ती कतार इंगित करती है कि डिस्क I/O राइट थ्रूपुट के साथ तालमेल नहीं बिठा सकता है।
• cb_xdcr_changes_left- XDCR प्रतिकृति के लिए लंबित उत्परिवर्तन की संख्या। क्रॉस-क्षेत्र प्रतिकृति अंतराल को इंगित करता है।
• cb_xdcr_docs_write- XDCR के माध्यम से प्रति सेकंड दोहराए गए दस्तावेज़।
• cb_node_cpu_utilization_percent- प्रति-नोड CPU उपयोग। Couchbase संघनन और अनुक्रमण के लिए CPU-गहन है।
• cb_bucket_vbucket_active_num- प्रति नोड सक्रिय vBuckets की संख्या। डेटा नोड्स में लगभग समान होना चाहिए।
• cb_index_num_docs_pending- इंडेक्स अपडेट के लिए लंबित दस्तावेज़। इंडेक्स बिल्ड लैग को दर्शाता है.
• cb_n1ql_requests_per_sec- N1QL क्वेरी थ्रूपुट। औसत विलंबता के साथ संयुक्त, क्वेरी प्रदर्शन समस्याओं की पहचान करता है।

Prometheus चेतावनी नियम

apiVersion: monitoring.coreos.com/v1
kind: PrometheusRule
metadata:
  name: couchbase-alerts
  namespace: couchbase
spec:
  groups:
  - name: couchbase.rules
    rules:
    - alert: CouchbaseNodeDown
      expr: cb_node_healthy == 0
      for: 1m
      labels:
        severity: critical
      annotations:
        summary: "Couchbase node {{ $labels.node }} is unhealthy"
    - alert: CouchbaseHighCacheMissRate
      expr: cb_bucket_cache_miss_ratio > 0.05
      for: 5m
      labels:
        severity: warning
      annotations:
        summary: "Cache miss rate {{ $value | humanizePercentage }} on bucket {{ $labels.bucket }}"
    - alert: CouchbaseXDCRLag
      expr: cb_xdcr_changes_left > 10000
      for: 10m
      labels:
        severity: warning
      annotations:
        summary: "XDCR replication lag: {{ $value }} pending mutations"
    - alert: CouchbaseDiskQueueGrowing
      expr: rate(cb_bucket_disk_queue_items[5m]) > 100
      for: 10m
      labels:
        severity: warning
      annotations:
        summary: "Disk queue growing on bucket {{ $labels.bucket }}"
    - alert: CouchbaseMemoryPressure
      expr: cb_bucket_mem_used_bytes / cb_bucket_mem_quota_bytes > 0.9
      for: 5m
      labels:
        severity: critical
      annotations:
        summary: "Memory usage at {{ $value | humanizePercentage }} for bucket {{ $labels.bucket }}"

SDK कनेक्शन स्ट्रिंग कॉन्फ़िगरेशन

Couchbase SDK टोपोलॉजी-जागरूक हैं - वे एक आंतरिक क्लस्टर मानचित्र बनाए रखते हैं और संचालन को सीधे सही नोड पर रूट करते हैं। उचित एसडीके कॉन्फ़िगरेशन एचए के लिए महत्वपूर्ण है, जो तेजी से विफलता का पता लगाने और क्षणिक त्रुटियों पर स्वचालित पुनः प्रयास सुनिश्चित करता है।

// Node.js SDK configuration for HA
const couchbase = require('couchbase');

const clusterConnStr = 'couchbases://cb-node1.example.com,cb-node2.example.com,cb-node3.example.com';

const cluster = await couchbase.connect(clusterConnStr, {
  username: process.env.CB_USERNAME,
  password: process.env.CB_PASSWORD,
  timeouts: {
    kvTimeout: 2500,           // Key-value operation timeout (ms)
    kvDurableTimeout: 10000,   // Durable write timeout
    queryTimeout: 75000,       // N1QL query timeout
    searchTimeout: 75000,      // FTS search timeout
    analyticsTimeout: 75000,   // Analytics query timeout
    connectTimeout: 10000,     // Initial connection timeout
    managementTimeout: 75000   // Management API timeout
  },
  security: {
    trustStorePath: '/etc/couchbase/ca.pem'
  },
  transactions: {
    durabilityLevel: couchbase.DurabilityLevel.MajorityAndPersistToActive,
    timeout: 15000
  }
});

const bucket = cluster.bucket('production-data');
const collection = bucket.defaultCollection();

// Durable write with observe-based durability
await collection.upsert('order::2026-001', orderDocument, {
  durabilityLevel: couchbase.DurabilityLevel.MajorityAndPersistToActive,
  timeout: 10000
});

// Read with replica fallback for HA
try {
  const result = await collection.get('user::12345');
} catch (err) {
  if (err instanceof couchbase.errors.TimeoutError) {
    const replicaResult = await collection.getAnyReplica('user::12345');
  }
}

# Java SDK configuration for HA
import com.couchbase.client.java.*;
import com.couchbase.client.java.env.*;
import java.time.Duration;

ClusterEnvironment env = ClusterEnvironment.builder()
    .timeoutConfig(TimeoutConfig.builder()
        .kvTimeout(Duration.ofMillis(2500))
        .kvDurableTimeout(Duration.ofSeconds(10))
        .queryTimeout(Duration.ofSeconds(75))
        .connectTimeout(Duration.ofSeconds(10))
        .build())
    .ioConfig(IoConfig.builder()
        .numKvConnections(4)
        .enableMutationTokens(true)
        .enableDnsSrv(true)
        .build())
    .securityConfig(SecurityConfig.builder()
        .enableTls(true)
        .trustCertificate(Paths.get("/etc/couchbase/ca.pem"))
        .build())
    .build();

Cluster cluster = Cluster.connect(
    "couchbases://cb-node1.example.com,cb-node2.example.com",
    ClusterOptions.clusterOptions("username", "password")
        .environment(env)
);

SDK कनेक्शन

Kubernetes सेवा DNS

# When using the Autonomous Operator, connect via the headless service:
# couchbase://cb-production-srv.couchbase.svc.cluster.local
#
# The operator creates these services:
# cb-production-srv      - Headless service for SDK auto-discovery
# cb-production-ui       - Web Console (port 8091/18091)
# cb-production-cloud    - External connectivity (NodePort/LoadBalancer)
#
# For external SDK access (outside Kubernetes), use:
# - NodePort with explicit node addresses
# - LoadBalancer with MetalLB (bare metal)
# - Ingress with TCP passthrough for port 11210 (SDK) and 11207 (SDK TLS)

Couchbase एज डिप्लॉयमेंट के लिए मोबाइल और सिंक गेटवे

Couchbase मोबाइल Couchbase इकोसिस्टम को एज डिवाइसों और मोबाइल एप्लिकेशन तक विस्तारित करता है।Couchbase लाइटiOS, Android और IoT उपकरणों पर एम्बेडेड चलता है, जबकिसिंक गेटवेCouchbase लाइट और Couchbase सर्वर के बीच सिंक्रोनाइज़ेशन मिडलवेयर के रूप में कार्य करता है।

// Sync Gateway configuration for production
{
  "interface": ":4984",
  "adminInterface": "127.0.0.1:4985",
  "logging": {
    "console": {
      "log_level": "info",
      "log_keys": ["HTTP", "Sync", "Auth", "Changes"]
    }
  },
  "databases": {
    "mobile-app": {
      "server": "couchbases://cb-production-srv.couchbase.svc.cluster.local",
      "bucket": "production-data",
      "username": "sync-gateway",
      "password": "${SG_PASSWORD}",
      "enable_shared_bucket_access": true,
      "import_docs": true,
      "num_index_replicas": 1,
      "delta_sync": {
        "enabled": true,
        "rev_max_age_seconds": 86400
      },
      "cache": {
        "channel_cache": {
          "max_number": 50000,
          "compact_high_watermark_pct": 80,
          "compact_low_watermark_pct": 60
        },
        "rev_cache": {
          "size": 5000,
          "shard_count": 16
        }
      },
      "users": {
        "GUEST": {"disabled": true}
      },
      "sync": "function(doc, oldDoc) { if (doc.type === 'user-data') { channel(doc.channels); requireAccess(doc.channels); } else { channel('public'); } }"
    }
  }
}

# Deploy Sync Gateway on Kubernetes
apiVersion: apps/v1
kind: Deployment
metadata:
  name: sync-gateway
  namespace: couchbase
spec:
  replicas: 3
  selector:
    matchLabels:
      app: sync-gateway
  template:
    metadata:
      labels:
        app: sync-gateway
    spec:
      containers:
      - name: sync-gateway
        image: couchbase/sync-gateway:3.1.4-enterprise
        args: ["/etc/sync-gateway/config.json"]
        ports:
        - containerPort: 4984
          name: public
        - containerPort: 4985
          name: admin
        resources:
          requests:
            cpu: "2"
            memory: 4Gi
          limits:
            cpu: "4"
            memory: 8Gi
        volumeMounts:
        - name: config
          mountPath: /etc/sync-gateway
      volumes:
      - name: config
        configMap:
          name: sync-gateway-config

क्षमता योजना और आकार

Couchbase प्रदर्शन और लागत अनुकूलन के लिए उचित क्षमता योजना आवश्यक है। निम्न तालिका कार्यभार स्तर के आधार पर आकार दिशानिर्देश प्रदान करती है:

साइजिंग फॉर्मूला

# Data Service RAM sizing
# Required RAM per node = (num_documents * (doc_metadata_size + avg_value_size)) / num_data_nodes * (1 + num_replicas)
# doc_metadata_size = 56 bytes (fixed overhead per document)
# Include 25% headroom for fragmentation and growth

# Example: 100M documents, 1KB avg size, 3 data nodes, 1 replica
# RAM = (100,000,000 * (56 + 1024)) / 3 * 2 = ~72 GB per node
# With 25% headroom: ~90 GB per node

# Index Service RAM sizing (memory-optimized)
# RAM = total_index_size * 3 (for build/merge overhead)
# Use system:indexes to check current index sizes

# Disk sizing
# Disk = (num_documents * avg_doc_size * (1 + num_replicas)) * 3 (compaction headroom)
# Use SSD/NVMe with provisioned IOPS for predictable performance

आपदा पुनर्प्राप्ति और विफलता प्रक्रियाएं

एक व्यापक आपदा पुनर्प्राप्ति योजना व्यवसाय की निरंतरता सुनिश्चित करती है जब बुनियादी ढांचे की विफलता स्वचालित विफलता के दायरे से अधिक हो जाती है।

एकल नोड विफलता (स्वचालित)

# Auto-failover handles single node failures automatically.
# Verify failover occurred:
/opt/couchbase/bin/couchbase-cli server-list \
  --cluster localhost:8091 \
  --username Administrator \
  --password password

# After replacing the failed node, add and rebalance:
/opt/couchbase/bin/couchbase-cli server-add \
  --cluster localhost:8091 \
  --username Administrator \
  --password password \
  --server-add new-node.example.com:8091 \
  --server-add-username Administrator \
  --server-add-password password \
  --services data,index

/opt/couchbase/bin/couchbase-cli rebalance \
  --cluster localhost:8091 \
  --username Administrator \
  --password password

पूर्ण क्लस्टर विफलता (मैन्युअल)

# Scenario: Primary region (US-EAST) completely lost

# Step 1: Verify XDCR target cluster (EU-WEST) has latest data
# Check XDCR replication status before failure
curl -s http://eu-west-node:8091/pools/default/remoteClusters \
  -u Administrator:password | jq .

# Step 2: Pause XDCR replications pointing to the failed cluster
/opt/couchbase/bin/couchbase-cli xdcr-replicate \
  --cluster cb-eu-west.example.com:8091 \
  --username Administrator \
  --password password \
  --pause \
  --xdcr-replicator <replication-id>

# Step 3: Update application connection strings to EU-WEST cluster
# (via DNS update, service mesh, or environment variable change)

# Step 4: Scale up EU-WEST cluster if needed to handle full production load
# In Kubernetes, update the CouchbaseCluster CRD:
kubectl patch couchbasecluster cb-eu-west -n couchbase --type merge \
  -p '{"spec":{"servers":[{"name":"data-zone-a","size":4}]}}'

# Step 5: After US-EAST cluster is restored, re-establish XDCR
# and perform a full resync from EU-WEST back to US-EAST

ग्रेसफुल फेलओवर और रिकवरी

# Graceful failover (for maintenance, drains data before removal)
/opt/couchbase/bin/couchbase-cli failover \
  --cluster localhost:8091 \
  --username Administrator \
  --password password \
  --server-failover node-to-remove.example.com:8091

# Recovery (re-add the node after maintenance)
/opt/couchbase/bin/couchbase-cli recovery \
  --cluster localhost:8091 \
  --username Administrator \
  --password password \
  --server-recovery node-to-recover.example.com:8091 \
  --recovery-type delta

# Delta recovery re-synchronizes only the changed data,
# which is much faster than full recovery.
# Full recovery rebuilds the node from scratch.

# Rebalance to complete the recovery
/opt/couchbase/bin/couchbase-cli rebalance \
  --cluster localhost:8091 \
  --username Administrator \
  --password password

Helm मान

उत्पादन परिवेश में स्वायत्त ऑपरेटर के साथ Couchbase को तैनात करने के लिए नीचे एक व्यापक Helm मान फ़ाइल है:

# helm-values-production.yaml
couchbase-operator:
  operator:
    image:
      repository: couchbase/operator
      tag: 2.7.1
    resources:
      requests:
        cpu: 500m
        memory: 512Mi
      limits:
        cpu: "1"
        memory: 1Gi
  admissionController:
    enabled: true
    resources:
      requests:
        cpu: 100m
        memory: 128Mi

cluster:
  image: couchbase/server:7.6.1-enterprise
  antiAffinity: true
  autoFailoverTimeout: 30s
  autoFailoverMaxCount: 3
  autoFailoverOnDataDiskIssues: true
  autoFailoverServerGroup: true
  security:
    adminSecret: cb-admin-credentials
  networking:
    tls:
      static:
        serverSecret: couchbase-server-tls
        operatorSecret: couchbase-operator-tls
    exposeAdminConsole: true
    adminConsoleServiceType: NodePort
  buckets:
    managed: true
  servers:
    data:
      size: 4
      services:
      - data
      - index
      serverGroups:
      - zone-a
      - zone-b
      resources:
        requests:
          cpu: "4"
          memory: 16Gi
        limits:
          cpu: "8"
          memory: 20Gi
      volumeMounts:
        default: couchbase-data
        data: couchbase-data
        index: couchbase-index
    query:
      size: 2
      services:
      - query
      - search
      resources:
        requests:
          cpu: "4"
          memory: 8Gi
        limits:
          cpu: "8"
          memory: 12Gi
      volumeMounts:
        default: couchbase-default
    analytics:
      size: 2
      services:
      - analytics
      - eventing
      serverGroups:
      - zone-c
      resources:
        requests:
          cpu: "8"
          memory: 32Gi
        limits:
          cpu: "16"
          memory: 40Gi
      volumeMounts:
        default: couchbase-analytics
        analytics:
        - couchbase-analytics
  serverGroups:
  - zone-a
  - zone-b
  - zone-c
  volumeClaimTemplates:
  - metadata:
      name: couchbase-data
    spec:
      storageClassName: ebs-gp3-couchbase
      resources:
        requests:
          storage: 100Gi
  - metadata:
      name: couchbase-index
    spec:
      storageClassName: ebs-gp3-couchbase
      resources:
        requests:
          storage: 50Gi
  - metadata:
      name: couchbase-default
    spec:
      storageClassName: ebs-gp3-couchbase
      resources:
        requests:
          storage: 20Gi
  - metadata:
      name: couchbase-analytics
    spec:
      storageClassName: ebs-gp3-couchbase
      resources:
        requests:
          storage: 200Gi

निष्कर्ष

Couchbase सर्वर का आर्किटेक्चर-vBucket-आधारित शार्डिंग, मेमोरी-फर्स्ट डेटा एक्सेस और एकीकृत मल्टी-मॉडल सेवाओं के आसपास निर्मित-उच्च उपलब्धता उत्पादन तैनाती के लिए एक विशिष्ट शक्तिशाली आधार प्रदान करता है। स्वचालित फ़ेलओवर के साथ इंट्रा-क्लस्टर प्रतिकृति का संयोजन यह सुनिश्चित करता है कि एकल-नोड विफलताओं को पारदर्शी रूप से संभाला जाता है, जबकि XDCR वैश्विक अनुप्रयोगों के लिए भौगोलिक क्षेत्रों में इस लचीलेपन का विस्तार करता है।

Kubernetes के लिए Couchbase स्वायत्त ऑपरेटर जटिल मैन्युअल संचालन को घोषणात्मक, स्व-उपचार तैनाती में बदल देता है। सर्वर समूह रैक/ज़ोन जागरूकता प्रदान करते हैं, ऑपरेटर स्केलिंग घटनाओं के दौरान पुनर्संतुलन संचालन का प्रबंधन करता है, और एकीकृत बैकअप CRD आपदा पुनर्प्राप्ति तैयारी को स्वचालित करता है।

इस गाइड से मुख्य बातें:

• मल्टी-डायमेंशनल स्केलिंगका लाभ उठाएं - स्वतंत्र स्केलिंग और संसाधन अलगाव के लिए समर्पित नोड पूल पर डेटा, इंडेक्स, क्वेरी, खोज, एनालिटिक्स और इवेंटिंग सेवाओं को अलग करें।
• बहु-क्षेत्र लचीलेपन के लिए XDCR कॉन्फ़िगर करें- टाइमस्टैम्प-आधारित संघर्ष समाधान के साथ द्विदिश XDCR AWS, Azure और GCP पर सक्रिय-सक्रिय तैनाती को सक्षम बनाता है। हमेशा एनटीपी सिंक्रोनाइजेशन सुनिश्चित करें।
• ज़ोन जागरूकता के लिए सर्वर समूहों का उपयोग करें- यह सुनिश्चित करने के लिए कि सक्रिय और प्रतिकृति vBuckets अलग-अलग विफलता डोमेन में हैं, उपलब्धता ज़ोन या रैक के लिए सर्वर समूहों को मैप करें।
• मेमोरी का आकार सावधानीपूर्वक- Couchbase का प्रदर्शन सीधे तौर पर इस बात से जुड़ा है कि रैम में कितना कार्यशील सेट फिट बैठता है। आकार निर्धारण सूत्रों का उपयोग करें और कैश मिस अनुपात की निगरानी करें।
• व्यापक निगरानी लागू करें- पहले दिन से Prometheus निर्यातक को तैनात करें। XDCR प्रतिकृति अंतराल, कैश मिस अनुपात, डिस्क कतार गहराई और नोड स्वास्थ्य आपके महत्वपूर्ण संकेत हैं।
• cbbackupmgrके साथ बैकअप को स्वचालित करें - क्लाउड स्नैपशॉट के साथ पूर्ण और वृद्धिशील बैकअप को संयोजित करें। पुनर्स्थापना प्रक्रियाओं का नियमित रूप से परीक्षण करें।
• TLS और RBACके साथ सुरक्षित - नोड-टू-नोड और क्लाइंट-टू-नोड TLS एन्क्रिप्शन सक्षम करें। प्रत्येक एप्लिकेशन सेवा खाते के लिए सुक्ष्म RBAC भूमिकाओं का उपयोग करें।
• HAके लिए SDK कॉन्फ़िगर करें - कई बूटस्ट्रैप नोड्स का उपयोग करें, उचित टाइमआउट कॉन्फ़िगर करें, फ़ॉलबैक के रूप में प्रतिकृति रीड लागू करें, और महत्वपूर्ण डेटा के लिए टिकाऊ लेखन का लाभ उठाएं।
• आपदा पुनर्प्राप्ति के लिए योजना- एकल-नोड, मल्टी-नोड और पूर्ण क्लस्टर विफलता परिदृश्यों के लिए विफलता प्रक्रियाओं का दस्तावेज़ और पूर्वाभ्यास। XDCR स्टैंडबाय क्लस्टर हर समय प्रचार के लिए तैयार रहना चाहिए।

इस व्यापक आधार के साथ, आप किसी भी बुनियादी ढांचे में उच्च उपलब्धता उत्पादन वातावरण में Couchbase सर्वर को तैनात और संचालित करने के लिए सुसज्जित हैं - AWS, Azure और GCP पर प्रबंधित Kubernetes से लेकर Rancher द्वारा प्रबंधित नंगे धातु k3s क्लस्टर तक। Kubernetes ऑर्केस्ट्रेशन के साथ Couchbase के मूल वितरित आर्किटेक्चर का संयोजन एक डेटाबेस प्लेटफ़ॉर्म प्रदान करता है जो आधुनिक, विश्व स्तर पर वितरित अनुप्रयोगों की मांगों को पूरा करता है।