Couchbase Server Docker镜像（arm64v8架构）

注意：这是couchbase镜像的arm64v8架构构建版本的"按架构"仓库——更多信息请参见镜像文档中的"非amd64架构？"和***镜像FAQ中的"镜像源在Git中已更改，该怎么办？"。

快速参考

• 维护者：
  Couchbase Docker团队

• 获取帮助：
  Docker社区Slack、Server Fault、Unix & Linux或Stack Overflow

支持的标签及对应Dockerfile链接

• 8.0.0, enterprise, enterprise-8.0.0, latest

• community, community-8.0.0

• 7.6.7, enterprise-7.6.7

• 7.6.6, enterprise-7.6.6

• 7.6.5, enterprise-7.6.5

• 7.6.4, enterprise-7.6.4

• 7.6.3, enterprise-7.6.3

• 7.6.2, enterprise-7.6.2

• community-7.6.2

• 7.6.1, enterprise-7.6.1

• community-7.6.1

• 7.6.0, enterprise-7.6.0

• community-7.6.0

• 7.2.8, enterprise-7.2.8

• 7.2.7, enterprise-7.2.7

• 7.2.6, enterprise-7.2.6

• 7.2.5, enterprise-7.2.5

• 7.2.4, enterprise-7.2.4

• community-7.2.4

• 7.2.3, enterprise-7.2.3

• 7.2.2, enterprise-7.2.2

• community-7.2.2

• 7.2.0, enterprise-7.2.0

• community-7.2.0

快速参考（续）

• 问题反馈地址：
  [***]

• 支持的架构：(更多信息)
  amd64、arm64v8

• 镜像 artifact 详情：
  repo-info 仓库的 repos/couchbase/ 目录（历史记录）
  （包含镜像元数据、传输大小等）

• 镜像更新：
  official-images 仓库的 library/couchbase 标签
  official-images 仓库的 library/couchbase 文件（历史记录）

• 本描述的来源：
  docs 仓库的 couchbase/ 目录（历史记录）

Couchbase Server 简介

Couchbase Server 基于最强大的 NoSQL 技术构建，在任何云中都能提供无与伦比的大规模性能。凭借内存优先架构、地理分布式部署和工作负载隔离等特性，Couchbase Server 擅长支持大规模关键业务应用，同时保持亚毫秒级延迟和 99.999% 的可用性。此外，借助最全面的 SQL 兼容查询语言（N1QL），通过 ANSI 连接功能，从关系型数据库迁移到 Couchbase Server 变得简单。

无与伦比的敏捷性和灵活性

通过 JSON 的灵活性和全面的查询语言（N1QL）支持快速变化的业务需求。从单一平台通过多种访问方式（键值、查询和搜索）开发引人入胜的应用。事件驱动型工作负载允许从集中式平台执行数据驱动的业务逻辑。

任何规模下的卓越性能

借助内存优先架构，在任何规模下提供一致、快速的体验。高性能索引和索引分区通过复杂连接、谓词和聚合计算提供无与伦比的查询性能。此外，通过端到端数据压缩，Couchbase 显著降低现有工作负载所需的网络、内存和存储成本。

最易于管理的平台

在任何云中以任何规模部署 Couchbase Server。通过 Kubernetes 等云集成减少运营开销，并通过内置的跨数据中心主动-主动复制（XDCR）支持全球多云部署。

!logo

Couchbase Server 与 Docker 快速入门

以下是如何在 Docker 容器中运行单节点 Couchbase Server 集群的步骤：

步骤 1：运行 Couchbase Server 容器

bash
docker run -d --name db -p 8091-8097:8091-8097 -p 9123:9123 -p ***:*** -p ***:*** -p ***:*** -p ***-***:***-*** couchbase

注意：根据使用场景，Couchbase Server 可能需要暴露多种端口。更多信息请参见 端口说明文档。

步骤 2：访问 Web 控制台完成设置

在主机上访问 http://localhost:8091，通过 Web 控制台启动 Couchbase Server 设置向导。

!设置初始界面

按照设置向导操作并接受默认值。

• 注意：可能需要降低各服务的 RAM 分配以适应容器资源限制。
• 启用 beer-sample 桶以加载示例数据。

!创建集群

!完成向导

!UI 主页

!加载示例数据

注意：有关配置服务器的详细信息，请参见 部署指南。

在 Couchbase Server 集群上运行 N1QL 查询

N1QL 是 Couchbase Server 的 SQL 风格查询语言。在 Web 控制台的 Query 标签页（http://localhost:8091）中，在查询窗口运行以下 N1QL 查询：

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

也可通过命令行执行 N1QL 查询。使用 cbq 命令行工具，通过设置向导中提供的凭据进行身份验证，并在 beer-sample 桶上执行查询：

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

更多查询示例请参见 运行第一个 N1QL 查询。

通过应用和 SDK 连接 Couchbase Server 集群

Couchbase Server SDK 支持多种语言：C、Go、Java、.NET、Node.js、PHP、Python。通过所选语言的 Couchbase Server SDK 在主机上运行应用，并指向 http://localhost:8091/pools 连接容器。

有关运行示例应用的信息，请参见 示例应用 指南。

要求和最佳实践

容器要求

Docker Hub 上的*** Couchbase Server 镜像基于最新支持的 Ubuntu 版本构建。

Docker 容器资源要求：有关开发、测试和生产环境的最低容器要求，请遵循 系统资源要求。

最佳实践

避免单点故障

Couchbase Server 的弹性和高可用性通过创建独立节点集群并在节点间复制数据实现，确保单个节点故障不会导致数据访问丢失。在容器化环境中，如果在同一物理硬件上运行多个节点，可能会意外引入单点故障。在可控制 VM 放置的环境中，建议确保每个 Couchbase Server 节点运行在不同的物理硬件上。

容器大小调整

物理硬件性能特性已得到充分了解。尽管容器在 Couchbase Server 和底层 OS 之间插入了轻量级层，但在容器中运行 Couchbase Server 仍会有少量开销。为确保稳定性和更好的性能可预测性，建议开发环境中容器至少分配 2 个专用核心，生产环境中运行的 Couchbase Server 实例容器至少分配 4 个专用核心（而非与多个容器共享）。过度承诺的环境可能导致容器资源竞争，造成不可预测的性能和稳定性问题。

将 Couchbase 节点特定数据映射到本地文件夹

Couchbase Server Docker 容器默认将所有持久化和节点特定数据写入 /opt/couchbase/var 目录。建议使用 docker run 的 -v 选项将此目录映射到主机文件系统目录，以实现数据持久化和性能优化。

• 持久化：使用 -v 选项将 /opt/couchbase/var 存储在容器外部，可删除容器后重新创建而不丢失 Couch