1.6. 通过 Snap 安装

Apache CouchDB 通过 Ubuntu snapcraft 存储库以 couchdb snap 的名称提供“便捷二进制” Snap 构建。这些构建在每个主要/次要发布流（例如 2.x、3.3）和 latest 流中提供。

完成 安装 snapd 后，您可以通过以下方式安装 CouchDB snap：

$ sudo snap install couchdb

安装后，使用 snap hook 设置管理员密码和 cookie。然后，重新启动 snap 以使更改生效。

$ sudo snap set couchdb admin=[your-password] setcookie=[your-cookie]
$ sudo snap restart couchdb

CouchDB 将安装在 /snap/couchdb/current/（只读）。数据文件将写入 /var/snap/couchdb/common/data，可写配置文件将存储在 /var/snap/couchdb/current/etc 中。

注意

您的安装尚未完成。请按照 设置 步骤进行单节点或集群安装。

Snaps 使用 AppArmor 并与 systemd 密切相关。它们强制执行仅在 /var/snap 下存放可写文件。确保 /var 具有足够的空间来满足您的数据需求。

要查看日志，请通过 journalctl snap.couchdb 或使用 snap logs 命令访问它们。

$ sudo snap logs couchdb -f

从特定通道安装时，snaps 会自动使用新修订版刷新。使用以下命令恢复到之前的安装：

$ sudo snap revert couchdb

此后，将不再接收更新。使用 list 和 info 命令查看已安装的 snaps 和备用通道。

$ snap list
$ snap info couchdb

与安装一样简单，snaps 可以被删除。

$ sudo snap remove couchdb
$ sudo snap remove couchdb --purge

第一个命令停止服务器，从列表中删除 couchdb，并删除文件系统（如果空间允许，保留约 30 天的备份）。如果您重新安装 couchdb，它会尝试恢复备份。第二个命令删除 couchdb 并清除所有备份。

在对 couchdb snap 进行故障排除时，首先检查日志。您可能需要检查 /var/snap/couchdb/current/etc/local.ini 以验证数据目录或修改管理员设置、端口或地址绑定。此外，与 Erlang 运行时相关的任何内容都检查 /var/snap/couchdb/current/etc/vm.args 以查看 erlang 名称。

最常见的问题是 couchdb 找不到数据库文件。确保 local.ini 包含以下节并指向您的数据文件。

[couchdb]
;max_document_size = 4294967296 ; bytes
;os_process_timeout = 5000
database_dir = /var/snap/couchdb/common/data
view_index_dir = /var/snap/couchdb/common/data

注意

请记住，您无法修改 /snap/couchdb/ 目录，即使使用 sudo 也不行，因为出于安全原因，文件系统以只读方式挂载。

有关 snap 构建过程的更多详细信息，请参阅我们的 couchdb-pkg git 存储库。其中包括使用命令行设置集群的说明。