Couchbase উৎপাদনে উচ্চ প্রাপ্যতা: XDCR, Kubernetes অপারেটর, এবং বহু-অঞ্চল স্থাপনা

Couchbasecbbackupmgrপ্রদান করে, একটি এন্টারপ্রাইজ ব্যাকআপ টুল যা ঐচ্ছিক কম্প্রেশন এবং এনক্রিপশন সহ সম্পূর্ণ, বর্ধিত এবং ডিফারেনশিয়াল ব্যাকআপ সমর্থন করে। উৎপাদন 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 (অপারেটর-পরিচালিত)

স্বয়ংক্রিয় ব্যাকআপ পরিচালনার জন্য স্বায়ত্তশাসিত অপারেটর CRD প্রদান করে:

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 এর মেমরি-প্রথম আর্কিটেকচার মানে RAM বরাদ্দ সরাসরি কর্মক্ষমতা প্রভাবিত করে। প্রতিটি পরিষেবার নিজস্ব মেমরি কোটা রয়েছে এবং বালতিগুলি ডেটা পরিষেবা কোটা ভাগ করে নেয়৷ সঠিক মাপ ক্যাশে উচ্ছেদ প্রতিরোধ করে যা লেটেন্সি হ্রাস করে।

# 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

মনিটরিং

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— বালতি মেমরি ব্যবহার। উচ্ছেদ রোধ করতে RAM কোটার কাছে যাওয়ার সময় সতর্কতা।
• cb_bucket_cache_miss_ratio— অনুরোধের অনুপাত যা ক্যাশে মিস করে এবং ডিস্ক আনার প্রয়োজন হয়৷ সর্বোত্তম কর্মক্ষমতার জন্য 2% এর নিচে থাকা উচিত।
• cb_bucket_disk_queue_items— ডিস্ক রাইট সারি গভীরতা। একটি ক্রমবর্ধমান সারি নির্দেশ করে যে ডিস্ক I/O লেখার থ্রুপুট ধরে রাখতে পারে না।
• cb_xdcr_changes_left— XDCR প্রতিলিপি মুলতুবি থাকা মিউটেশনের সংখ্যা। ক্রস-অঞ্চল প্রতিলিপি ল্যাগ নির্দেশ করে।
• cb_xdcr_docs_written— XDCR এর মাধ্যমে প্রতি সেকেন্ডে নথি প্রতিলিপি করা হয়েছে৷
• cb_node_cpu_utilization_percent— প্রতি-নোড CPU ব্যবহার। Couchbase কমপ্যাকশন এবং ইন্ডেক্সিংয়ের জন্য CPU-নিবিড়।
• cb_bucket_vbucket_active_num— নোড প্রতি সক্রিয় vBucket সংখ্যা। ডাটা নোড জুড়ে মোটামুটি হওয়া উচিত।
• 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গুলি টপোলজি-সচেতন — তারা একটি অভ্যন্তরীণ ক্লাস্টার মানচিত্র এবং সঠিক নোডে সরাসরি রুট অপারেশন বজায় রাখে। সঠিক SDK কনফিগারেশন HA এর জন্য গুরুত্বপূর্ণ, দ্রুত ব্যর্থতা সনাক্তকরণ এবং ক্ষণস্থায়ী ত্রুটির উপর স্বয়ংক্রিয়ভাবে পুনরায় চেষ্টা নিশ্চিত করে।

// 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 LiteiOS, Android, এবং IoT ডিভাইসে এম্বেড করা চলে, যখনসিঙ্ক গেটওয়েCouchbase Lite এবং 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 স্বায়ত্তশাসিত অপারেটর যা জটিল ম্যানুয়াল অপারেশনগুলিকে ঘোষণামূলক, স্ব-নিরাময় স্থাপনায় রূপান্তরিত করে। সার্ভার গ্রুপগুলি র্যাক/জোন সচেতনতা প্রদান করে, অপারেটর স্কেলিং ইভেন্টের সময় রিব্যালেন্স অপারেশন পরিচালনা করে, এবং সমন্বিত ব্যাকআপ CRDs স্বয়ংক্রিয় দুর্যোগ পুনরুদ্ধারের প্রস্তুতি।

মূল টেকওয়ে:

• লিভারেজ মাল্টি-ডাইমেনশনাল স্কেলিং— স্বাধীন স্কেলিং এবং রিসোর্স আইসোলেশনের জন্য ডেডিকেটেড নোড পুলগুলিতে পৃথক ডেটা, সূচক, ক্যোয়ারী, অনুসন্ধান, বিশ্লেষণ এবং ইভেন্টিং পরিষেবাগুলি।
• মাল্টি-রিজিয়ন স্থিতিস্থাপকতার জন্য XDCR কনফিগার করুন— টাইমস্ট্যাম্প-ভিত্তিক দ্বন্দ্ব রেজোলিউশন সহ দ্বিমুখী XDCR AWS, Azure এবং GCP জুড়ে সক্রিয়-সক্রিয় স্থাপনা সক্ষম করে। সর্বদা এনটিপি সিঙ্ক্রোনাইজেশন নিশ্চিত করুন।
• জোন সচেতনতার জন্য সার্ভার গোষ্ঠীগুলি ব্যবহার করুন— সক্রিয় এবং প্রতিরূপ vBuckets বিভিন্ন ব্যর্থ ডোমেনে রয়েছে তা গ্যারান্টি দিতে প্রাপ্যতা অঞ্চল বা র্যাকগুলিতে সার্ভার গ্রুপগুলি ম্যাপ করুন৷
• সাইজ মেমরি সাবধানে— Couchbase-এর কর্মক্ষমতা সরাসরি RAM-তে কতটা কাজের সেট ফিট করে তার সাথে যুক্ত। সাইজিং সূত্র ব্যবহার করুন এবং ক্যাশে মিস অনুপাত নিরীক্ষণ করুন।
• ব্যাপক পর্যবেক্ষণপ্রয়োগ করুন — Prometheus রপ্তানিকারককে প্রথম দিন থেকে স্থাপন করুন৷ XDCR রেপ্লিকেশন ল্যাগ, ক্যাশে মিস রেশিও, ডিস্ক কিউ গভীরতা এবং নোডের স্বাস্থ্য হল আপনার গুরুত্বপূর্ণ সংকেত।
• cbbackupmgrএর সাথে স্বয়ংক্রিয় ব্যাকআপগুলি — ক্লাউড স্ন্যাপশটগুলির সাথে সম্পূর্ণ এবং বর্ধিত ব্যাকআপগুলিকে একত্রিত করুন৷ নিয়মিত পরীক্ষা পুনরুদ্ধার পদ্ধতি.
• TLS এবং RBACসহ সুরক্ষিত — নোড-টু-নোড এবং ক্লায়েন্ট-টু-নোড TLS এনক্রিপশন সক্ষম করুন। প্রতিটি অ্যাপ্লিকেশন পরিষেবা অ্যাকাউন্টের জন্য সূক্ষ্ম-দানাযুক্ত RBAC ভূমিকা ব্যবহার করুন।
• HA-এর জন্য SDK কনফিগার করুন — একাধিক বুটস্ট্র্যাপ নোড ব্যবহার করুন, উপযুক্ত টাইমআউট কনফিগার করুন, ফলব্যাক হিসাবে রেপ্লিকা রিড প্রয়োগ করুন, এবং সমালোচনামূলক ডেটার জন্য টেকসই লেখার সুবিধা নিন।
• দুর্যোগ পুনরুদ্ধারের জন্য পরিকল্পনা— একক-নোড, মাল্টি-নোড, এবং সম্পূর্ণ ক্লাস্টার ব্যর্থতার পরিস্থিতিগুলির জন্য নথি এবং ব্যর্থতার পদ্ধতিগুলি অনুশীলন করুন। XDCR স্ট্যান্ডবাই ক্লাস্টারগুলি সর্বদা প্রচারের জন্য প্রস্তুত থাকা উচিত।

এই ব্যাপক ফাউন্ডেশনের সাহায্যে, আপনি যেকোন অবকাঠামো জুড়ে উচ্চ প্রাপ্যতা উত্পাদন পরিবেশে Couchbase সার্ভার স্থাপন এবং পরিচালনা করতে সজ্জিত - AWS, Azure, এবং GCP-এ পরিচালিত Kubernetes থেকে Rancher দ্বারা পরিচালিত বেয়ার মেটাল k3s ক্লাস্টার পর্যন্ত৷ Kubernetes অর্কেস্ট্রেশনের সাথে Couchbase এর নেটিভ ডিস্ট্রিবিউটেড আর্কিটেকচারের সংমিশ্রণ একটি ডাটাবেস প্ল্যাটফর্ম সরবরাহ করে যা আধুনিক, বিশ্বব্যাপী বিতরণ করা অ্যাপ্লিকেশনগুলির চাহিদা পূরণ করে।