注意：这是 couchdb 官方镜像 的 ppc64le 架构“per-architecture”仓库——更多信息，请参见官方镜像文档中的“除 amd64 外的架构？”以及官方镜像 FAQ 中的“Git 中镜像的源已更改，现在该怎么办？”。

快速参考

• 维护者：
  Apache CouchDB

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

支持的标签及对应的 Dockerfile 链接

警告：此镜像在 ppc64le 架构上 不受支持

快速参考（续）

• 提交 issue 地址：
  [***]

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

• 已发布镜像制品详情：
  repo-info 仓库的 repos/couchdb/ 目录（历史记录）
  （镜像元数据、传输大小等）

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

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

什么是 Apache CouchDB？

Apache CouchDB™ 通过定义 Couch 复制协议，让您能够在需要的地方访问数据。该协议由多种项目和产品实现，涵盖从全球分布式服务器集群、移动电话到 Web 浏览器的各种计算环境。与 Couch 复制协议兼容的软件包括 PouchDB 和 Cloudant。

您可以将数据安全地存储在自己的服务器上，或任何领先的云服务提供商处。Web 和原生应用都青睐 CouchDB，因为它原生支持 JSON，并支持二进制数据存储以满足所有数据存储需求。Couch 复制协议让数据在服务器集群、移动电话和 Web 浏览器之间无缝流动，在保持高性能和高可靠性的同时，实现引人入胜的离线优先用户体验。CouchDB 提供开发者友好的查询语言，并可选 MapReduce 以实现简单、高效和全面的数据检索。

couchdb.apache.org

!logo

如何使用此镜像

启动 CouchDB 实例

启动 CouchDB 实例非常简单：

$ docker run -d --name my-couchdb ppc64le/couchdb:tag

其中 my-couchdb 是您要分配给容器的名称，tag 是指定 CouchDB 版本的标签。请参见上文列表获取相关标签。

从另一个 Docker 容器中的应用连接到 CouchDB

此镜像暴露标准 CouchDB 端口 5984，因此标准容器链接会使其自动对链接的容器可用。按以下方式启动应用容器以将其链接到 CouchDB 容器：

$ docker run --name my-couchdb-app --link my-couchdb:couchdb -d app-that-uses-couchdb

将 CouchDB 暴露到外部

如果要将端口暴露到外部，请运行：

$ docker run -p 5984:5984 -d ppc64le/couchdb

警告：在创建管理员用户并正确设置所有已创建数据库的权限之前，请勿执行此操作。

如果您打算将此 CouchDB 实例与集群中的其他实例联网，则需要映射额外端口；详情请参见 官方 CouchDB 文档。

创建集群

启动多个 CouchDB 实例，然后按照 官方 CouchDB 文档 中的设置向导完成过程。

对于 CouchDB 集群，您需要提供 NODENAME 设置以及 Erlang cookie。可通过环境变量 ERL_FLAGS 对 Erlang 进行设置，例如 ERL_FLAGS=-setcookie "brumbrum"。更多信息请参见 此处。

还提供了 Kubernetes helm chart。

容器 shell 访问、remsh 和查看日志

docker exec 命令允许您在 Docker 容器内运行命令。以下命令将为您提供 couchdb 容器内的 bash shell：

$ docker exec -it my-couchdb bash

如果需要直接访问 Erlang 运行时：

$ docker exec -it my-couchdb /opt/couchdb/bin/remsh

CouchDB 日志可通过 Docker 的容器日志查看：

$ docker logs my-couchdb

配置 CouchDB

为 couchdb 镜像提供配置的最佳方式是提供自定义 ini 文件，最好存储在 /opt/couchdb/etc/local.d/ 目录中。有多种方式可将此文件提供给容器（通过包含 FROM + COPY 的简短 Dockerfile、Docker 配置、运行时绑定挂载等），具体细节留给读者自行探索。

请记住，CouchDB 的运行时重新配置会覆盖 配置链中的最后一个文件，并且此 Docker 容器在启动时会创建 /opt/couchdb/etc/local.d/docker.ini 文件。

CouchDB 还使用 /opt/couchdb/etc/vm.args 存储 Erlang 运行时特定的更改。更改这些值不太常见。例如，如果需要更改 epmd 端口，则还需要绑定挂载此文件。（注意：Windows 主机上无法绑定挂载文件。）

此外，提供了一些环境变量用于设置非常常见的参数：

• COUCHDB_USER 和 COUCHDB_PASSWORD 将在文件 /opt/couchdb/etc/local.d/docker.ini 中创建基于 ini 文件的本地管理员用户，用户名和密码为给定值。
• COUCHDB_SECRET 将在文件 /opt/couchdb/etc/local.d/docker.ini 中设置 CouchDB 共享集群密钥值。
• NODENAME 将容器内 CouchDB 节点的名称设置为 couchdb@${NODENAME}，位于文件 /opt/couchdb/etc/vm.args 中。这用于集群目的，单节点设置可忽略。
• Erlang 环境变量（如 ERL_FLAGS）将被 Erlang 本身使用。完整列表请参见 此处

注意事项

数据存储位置

重要提示：有多种方式存储 Docker 容器中运行的应用所使用的数据。我们建议 couchdb 镜像的用户熟悉可用选项，包括：

• 让 Docker 通过 使用其自己的内部卷管理将数据库文件写入主机系统的磁盘 来管理数据库数据存储。这是默认方式，对用户而言简单且相当透明。缺点是主机系统上直接运行（即容器外部）的工具和应用可能难以定位这些文件。
• 在主机系统上（容器外部）创建数据目录，并 将其挂载到容器内可见的目录。这会将数据库文件放置在主机系统上的已知位置，便于主机系统上的工具和应用访问文件。缺点是用户需要确保目录存在，并且主机系统上的目录权限和其他安全机制设置正确。

Docker 文档是了解不同存储选项和变体的良好起点，有多个博客和论坛帖子讨论并提供了该领域的建议。我们在此仅展示上述后一种选项的基本步骤：

1. 在主机系统的合适卷上创建数据目录，例如 /home/couchdb/data。
2. 按以下方式启动 couchdb 容器：

$ docker run --name some-couchdb -v /home/couchdb/data:/opt/couchdb/data -d ppc64le/couchdb:tag

命令中的 -v /home/couchdb/data:/opt/couchdb/data 部分将主机系统的 /home/couchdb/data 目录挂载为容器内的 /opt/couchdb/data，CouchDB 默认会在此处写入数据文件。

安装完成前无系统数据库

请注意，CouchDB 不再自动为您创建系统数据库，因为在启动时无法确定这是单节点还是集群 CouchDB 安装。在集群中，必须在所有节点加入后才能创建数据库。

如果您使用 集群设置向导 或 集群设置 API，完成过程后会为您创建这些数据库。

如果您选择不使用集群设置向导或 API，则必须手动创建 _global_changes、_replicator 和 _users。

管理员模式

节点还将以 管理员模式 启动。请务必创建管理员用户！集群设置向导 或 集群设置 API 将为您完成此操作。

您也可以使用两个环境变量 COUCHDB_USER 和 COUCHDB_PASSWORD 来设置管理员用户：

$ docker run -e COUCHDB_USER=admin -e COUCHDB_PASSWORD=password -d ppc64le/couchdb

注意，如果您要设置集群 CouchDB，需要预哈希此密码，并在所有节点上使用相同的哈希文本，以确保负载均衡器位于集群前面时会话正常工作。可通过将容器的 /opt/couchdb/etc/local.d 目录挂载为卷来实现哈希，允许 CouchDB 哈希您设置的密码，然后复制出哈希版本并在将来使用此值。

使用持久化 CouchDB 配置文件

CouchDB 配置在 /opt/couchdb/etc 中的 .ini 文件中指定。查看 CouchDB 配置文档 了解更多关于 CouchDB 配置结构的信息。

如果要使用自定义 CouchDB 配置，可以在主机上的目录中创建配置文件，然后将该目录挂载为 couchdb 容器内的 /opt/couchdb/etc/local.d。

$ docker run --name my-couchdb -v /home/couchdb/etc:/opt/couchdb/etc/local.d -d ppc64le/couchdb

命令中的 -v /home/couchdb/etc:/opt/couchdb/etc/local.d 部分将主机系统的 /home/couchdb/etc 目录挂载为容器内的 /opt/couchdb/etc/local.d，CouchDB 默认会在此处写入其动态配置文件。

您也可以将 couchdb 用作自己的 couchdb 实例的基础镜像，并提供自己版本的 local.ini 配置文件：

示例 Dockerfile：

FROM ppc64le/couchdb

COPY local.ini /opt/couchdb/etc/

然后构建并运行：

$ docker build -t you/awesome-couchdb .
$ docker run -d -p 5984:5984 you/awesome-couchdb

请记住，使用此方法，任何新写入的更改仍会出现在 /opt/couchdb/etc/local.d 目录中，因此仍建议将其映射到主机路径以实现持久化。

日志

默认情况下，从此镜像运行的容器仅记录到 stdout。您可以在 配置 中启用文件日志。

例如，在 local.ini 中：

[log]
writer = file
file = /opt/couchdb/log/couch.log

建议将此路径挂载到主机上的目录，因为 CouchDB 日志可能非常庞大。

许可证

Apache CouchDB 根据 Apache 许可证 授权。

与所有 Docker 镜像一样，这些镜像可能还包含其他软件，这些软件可能采用其他许可证（例如基础发行版中的 Bash 等，以及包含的主要软件的任何直接或间接依赖项）。

一些能够自动检测到的额外许可证信息可能位于 repo-info 仓库的 couchdb/ 目录 中。

至于任何预构建镜像的使用，镜像用户有责任确保对本镜像的任何使用符合其中包含的所有软件的相关许可证。