Couchbase Docker 镜像文档

镜像概述和主要用途

本镜像为 Couchbase 官方镜像 的 amd64 架构专用版本。Couchbase Server 是一个分布式架构的 NoSQL 文档数据库，具备内存优先架构、地理分布式部署和工作负载隔离等特性，能够在保持亚毫秒级延迟和 99.999% 可用性的同时，支持大规模关键业务应用。通过兼容 SQL 的查询语言（N1QL），可轻松实现从关系型数据库向 Couchbase Server 的迁移。

核心功能和特性

卓越的灵活性与敏捷性

• 支持 JSON 数据模型，结合全面的 N1QL 查询语言，快速响应业务需求变化
• 提供多种数据访问方式：键值对、查询和搜索
• 支持事件驱动型工作负载，可从集中式平台执行数据驱动的业务逻辑

无与伦比的性能与可扩展性

• 基于内存优先架构，在任何规模下提供一致的快速体验
• 高性能索引和索引分区技术，支持复杂连接、谓词和聚合操作的高效查询
• 端到端数据压缩，显著降低网络、内存和存储成本

易于管理的平台

• 支持在任何云环境中部署，具备 Kubernetes 等云集成能力
• 内置跨数据中心复制（XDCR）功能，支持全球多云部署
• 简化运维 overhead，提供直观的 Web 控制台和自动化工具

使用场景和适用范围

Couchbase Server 适用于以下场景：

• 大规模关键业务应用，需要高可用性和低延迟
• 多云或混合云部署环境，要求数据一致性和地理分布式访问
• 需要从关系型数据库迁移，同时保留 SQL 查询能力的应用
• 开发和测试环境，需要快速部署和灵活扩展的 NoSQL 数据库
• 事件驱动型应用，依赖实时数据处理和响应

支持的标签及对应 Dockerfile 链接

详细的使用方法和配置说明

快速启动

步骤 1：运行 Couchbase Server 容器

docker run -d --name db \
  -p 8091-8097:8091-8097 \
  -p 9123:9123 \
  -p 11207:11207 \
  -p 11210:11210 \
  -p 11280:11280 \
  -p 18091-18097:18091-18097 \
  couchbase

端口说明：Couchbase Server 根据使用场景需要暴露多个端口，详细端口用途可参考 官方文档。

步骤 2：通过 Web 控制台完成初始化设置

访问主机的 http://localhost:8091，通过设置向导完成集群配置：

• 接受默认值或根据容器资源调整服务内存分配
• 启用 "beer-sample" 桶以加载示例数据
• 设置管理员用户名和密码

运行 N1QL 查询

N1QL 是 Couchbase 的 SQL 兼容查询语言，可通过 Web 控制台或命令行执行：

Web 控制台方式

1. 访问 http://localhost:8091 并登录
2. 切换到 "Query" 标签页
3. 执行示例查询：

   SELECT name FROM `beer-sample` WHERE brewery_id="mishawaka_brewing";
   

命令行方式

docker exec -it db cbq --user Administrator
cbq> SELECT name FROM `beer-sample` WHERE brewery_id="mishawaka_brewing";

通过 SDK 连接集群

Couchbase 提供多语言 SDK（C、Go、Java、.NET、Node.js、PHP、Python 等），应用程序可通过 http://localhost:8091/pools 连接到容器化集群。

示例 Java SDK 连接代码：

Cluster cluster = Cluster.connect("localhost", "Administrator", "password");
Bucket bucket = cluster.bucket("beer-sample");
Collection collection = bucket.defaultCollection();

Docker Compose 配置示例

version: '3.8'
services:
  couchbase:
    image: couchbase:latest
    container_name: couchbase-node1
    ports:
      - "8091:8091"
      - "8092:8092"
      - "8093:8093"
      - "8094:8094"
      - "8095:8095"
      - "8096:8096"
      - "8097:8097"
      - "9123:9123"
      - "11207:11207"
      - "11210:11210"
      - "11280:11280"
      - "18091:18091"
      - "18092:18092"
      - "18093:18093"
      - "18094:18094"
      - "18095:18095"
      - "18096:18096"
      - "18097:18097"
    volumes:
      - couchbase_data:/opt/couchbase/var
    ulimits:
      nofile:
        soft: 40960
        hard: 40960
      core:
        soft: 100000000
        hard: 100000000
      memlock:
        soft: 100000000
        hard: 100000000
    restart: unless-stopped

volumes:
  couchbase_data:

最佳实践

容器资源要求

• 开发/测试环境：至少 2 核 CPU，4GB RAM
• 生产环境：至少 4 核 CPU，8GB RAM（建议专用核心以避免资源竞争）

详细系统要求参考 官方文档。

数据持久化

Couchbase 容器的持久化数据默认存储在 /opt/couchbase/var，建议通过 -v 参数映射到主机目录：

mkdir -p ~/couchbase/data
docker run -d --name db \
  -v ~/couchbase/data:/opt/couchbase/var \
  -p 8091-8097:8091-8097 \
  -p 9123:9123 \
  -p 11207:11207 \
  -p 11210:11210 \
  -p 11280:11280 \
  -p 18091-18097:18091-18097 \
  couchbase

SELinux 环境注意事项：

mkdir ~/couchbase/data && chcon -Rt svirt_sandbox_file_t ~/couchbase/data

生产环境 ULimit 配置

Couchbase 生产环境需要调整 ulimit 设置以确保性能和稳定性：

docker run -d --name db \
  --ulimit nofile=40960:40960 \
  --ulimit core=100000000:100000000 \
  --ulimit memlock=100000000:100000000 \
  -p 8091-8097:8091-8097 \
  -p 9123:9123 \
  -p 11207:11207 \
  -p 11210:11210 \
  -p 11280:11280 \
  -p 18091-18097:18091-18097 \
  couchbase

网络配置

生产环境建议使用 --net=host 模式避免网络性能损耗和 NAT 问题：

docker run -d --name db --net=host couchbase

多节点集群部署拓扑

单物理机多容器（开发/测试用）

所有容器运行在同一物理机，适用于开发和测试环境，但存在资源竞争和单点故障风险：

┌──────────────────────────────────────────────────────────┐
│                     主机 OS (Linux)                       │
│                                                          │
│  ┌───────────────┐ ┌───────────────┐  ┌───────────────┐  │
│  │ 容器 OS       │ │ 容器 OS       │  │ 容器 OS       │  │
│  │ (Ubuntu)      │ │ (Ubuntu)      │  │ (Ubuntu)      │  │
│  │ ┌───────────┐ │ │ ┌───────────┐ │  │ ┌───────────┐ │  │
│  │ │ Couchbase │ │ │ │ Couchbase │ │  │ │ Couchbase │ │  │
│  │ │  Server   │ │ │ │  Server   │ │  │ │  Server   │ │  │
│  │ └───────────┘ │ │ └───────────┘ │  │ └───────────