Fedora-CouchDB Docker镜像文档

镜像概述和主要用途

本镜像为基于Fedora操作系统的CouchDB Docker镜像，旨在简化CouchDB数据库的部署流程。通过容器化方式，无需手动配置Fedora环境及CouchDB依赖，可快速搭建并运行CouchDB服务，适用于需要便捷获取CouchDB运行环境的场景。

核心功能和特性

• 基于Fedora系统：提供稳定、可靠的操作系统环境
• 集成CouchDB服务：包含完整的CouchDB数据库功能
• 容器化部署：简化安装配置流程，降低环境依赖复杂度
• 标准端口暴露：默认暴露CouchDB标准端口（5984），支持外部网络访问

使用场景和适用范围

• 开发环境中快速搭建CouchDB测试服务
• 测试环境中验证基于CouchDB的应用功能
• 轻量级生产环境中单节点CouchDB服务部署

使用方法和配置说明

前提条件

确保本地环境已安装Docker，可通过以下命令检查Docker版本：

docker version

构建镜像

1. 复制镜像源码至本地目录
2. 执行以下命令构建镜像（将<username>替换为实际Docker用户名）：

docker build --rm -t <username>/couchdb .

启动容器

执行以下命令后台启动CouchDB容器，并映射主机端口5984到容器端口5984：

docker run -d -p 5984:5984 <username>/couchdb

服务测试

容器启动后，可通过curl命令测试CouchDB服务是否正常运行：

创建测试数据库

curl -X PUT http://localhost:5984/test/

说明：若数据库已存在，返回结果为：

{"error":"file_exists","reason":"The database could not be created, the file already exists."}

查询数据库信息

curl -X GET http://localhost:5984/test/

预期输出（示例）：

{"db_name":"test","doc_count":0,"doc_del_count":0,"update_seq":0,"purge_seq":0,"compact_running":false,"disk_size":79,"data_size":0,"instance_start_time":"1387384723608413"}