Docker部署CouchDB

CouchDB介绍：

CouchDB是Apache组织发布的一款开源的、面向文档类型的NoSQL数据库。由Erlang编写，使用json格式保存数据。CouchDB以RESTful的格式提供服务

能够很方便的对接各类语言的客户端

CouchDB最大的竞争对手就是熟悉的MangoDB。它们的不一样点比较会在另一篇里面写入

CouchDB 目标是作下一代的Web应用存储系统

CouchDB下载，安装：

官网：http://couchdb.apache.org/ 目前只有2.0.0版本 2016年9月份

CouchDB 安装完成后自动启动，默认是5984

Docker下的安装配置：

一、先建立一个couchdb容器，并赋值给couch1

COUCH1=$(docker run -d -p 5984 -v /var/lib/couchdb couchdb)
root@ubuntu:~# echo $COUCH1

6d708f72e25e9f0d693aa5a8ce5afd1a61e945355f728f409bc5a90676e0524c

二、给couchDB中插入数据

  要确保你的HOST是可用的

$ HOST=localhost #这里若是localhost不行，就更换成主机ip
$ URL="http://$HOST:$(docker port $COUCH1 5984 | grep -o '[1-9][0-9]*$')/_utils/"
$ echo "Navigate to $URL in your browser, and use the couch interface to add data"

操做结果：

root@ubuntu:~# HOST=123.xx.xx.x8 #这里是公网ip就不显示出来了
root@ubuntu:~# URL="http://$HOST:$(docker port $COUCH1 5984 | grep -o '[1-9][0-9]*$')/_utils/"
root@ubuntu:~# docker port $COUCH1 5984 #这里映射到了宿主机32768端口，并监听全部ip
0.0.0.0:32768
root@ubuntu:~# echo "Navigate to $URL in your browser, and use the couch interface to add data"
Navigate to http://123.xx.xx.x8:32768/_utils/ in your browser, and use the couch interface to add data
# 打开浏览器输入http://123.xx.xx.x8:32768/_utils/ 将会显示couchDB的页面

建立数据库帐号

控制台页面的左边的主要部分列出了当前数据库，并提供了一个 Create Database … 的操做；右边的侧边栏呢，从上到下分别提供了 工具、 文档 、 诊断 和 当前数据库 3个菜单。最右下角是版本号和一句话：“Welcome to Admin Party! Everyone is admin. Fix this”，什么意思呢？就是说ConchDB默认用户都是admin，对于用惯了关系型数据库的咱们，本能的就会感受这并不安全，没错，其实就是不安全！！！！，因此，点击 Fix this 来新建一个用户吧。

注意：若是使用中发现某些按钮是灰色的或者 Compact & Cleanup 一直在转圈等待，请先看看本身是否是管理员。

点击 Create Database … 并输入一个数据库名称就能够新建一个数据啦

建立成功后会跳转到当前新建的数据库，若是咱们返回Overview页面就会发现刚才新建的数据库已经被添加到列表中了。

CouchDB的增删改操做【INSERT/UPDATE/DELETE】

在新建的数据库的管理页面中点击 New Document，咱们就能够新建一个文档，其中会包含一个默认的Id字段做为惟一标识，咱们能够不用管他，同时也能够点击 Add Field 来新增字段，这里假设咱们新增一我的，字段以下图：

点击右面的“source”按钮，就能看到json格式的内容

点击上面的“Save doucement”来保存数据，而后再主页就能看到咱们新建立的数据库了

双击Field或者Value列的单元格能够更改字段名或字段值

点击右侧的绿色对勾按钮后，该字段的值将会被保存，此时切换到Source标签就能够看到json格式的数据

编辑完成后点击上方的 Save Document 按钮就能够将刚才的json数据保存到数据库中，保存成功后系统会自动为咱们添加一个 rev 字段，这个字段表明当前文档的版本号

更新操做呢也比较简单，只须要单击当前文档的Key或者双击Value就能够进入编辑页面，在编辑页面中不但能修改字段的Key/Value，还能够新增和删除字段，一样，点击 Save Document 便可保存当前修改，同时，咱们能够注意到，该文档的 rev 值已经发生了变化，这表明该文档的版本号已经被更新

一样，进入当前记录的详情页咱们就能够看到 Delete Document 按钮，点击以后当前文档就会被删除。

可是，值得注意的是，当咱们使用 Delete Document 操做将文档删除后，表面看是没有数据了，可是该数据仍然占用了那么多空间，并无减小，以下图：

这时咱们须要进入数据库详情页，使用 Compact & Cleanup… 中的 Compact Database 操做来清理被占用的空间，若是发现此功能点击以后一直在转圈等待，去看看本身是否是管理员用户吧。

使用Docker再次建立一个couchDB

 COUCH2=$(docker run -d -p 5984 --volumes-from $COUCH1 couchdb)

使用浏览器浏览第二个数据库

HOST=localhost #这里若是localhost不行，就更换成主机ip
URL="http://$HOST:$(docker port $COUCH2 5984 | grep -o '[1-9][0-9]*$')/_utils/"
echo "Navigate to $URL in your browser, and use the couch interface to add data"

这里能够看到数据已经同步到couchdb的第二台上面临

使用 cURL 经过 RESTful API 对 CouchDB 进行增删查改

Tips: 对cURL还不太了解的亲们能够搜索下，很好用的工具，能够从这里下载： http://curl.haxx.se/download/

注意：为了测试方便，咱们删除原来的数据库。

前面已经介绍过，CouchDB支持使用RESTful API的方式来对数据进行操做，例如，咱们在浏览器中输入 http://x.x.x.x:32768/demo 就能够查看demo数据库中详细信息。如图：

下面是借鉴别人的操做流程，本身没有时间敲了，你们随意感觉一下CouchDB流畅的RESTful操做方式：

 # 获取CouchDB相关信息
curl -X GET http://127.0.0.1:5984
{"couchdb":"Welcome","uuid":"a853c053a5a54a4d3ccbaad0d9ffd3b0","version":"1.6.1","vendor":{"version":"1.6.1","name":"The Apache Software Foundation"}}

# 建立demo数据库（须要admin权限，参照下一条命令）
curl -X PUT http://127.0.0.1:5984/demo
{"error":"unauthorized","reason":"You are not a server admin."}

# 使用用户名密码登陆CouchDB，并建立demo数据库
curl -X PUT http://username:password@127.0.0.1:5984/demo
{"ok":true}

# 查看全部数据库
curl -X GET http://127.0.0.1:5984/_all_dbs
["_replicator","_users","demo"]

# 查看demo数据库相关信息
curl -X GET http://127.0.0.1:5984/demo
{"db_name":"demo","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":"1452000207199340","disk_format_version":6,"committed_update_seq":0}

# 向demo数据库中添加一个文档（自动生成Id），注意：windows下须要使用Content-Type:application/json的HttpHeader
curl -H "Content-Type:application/json"  -X POST http://127.0.0.1:5984/demo -d {\"name\":\"fooly\"}
{"ok":true,"id":"3ebb59dd78ff448f283f48817800321c","rev":"1-0e4ea534f2c1e7f05e21804b5f2f7a71"}

# 查看demo数据库中的全部文档
curl -X GET http://127.0.0.1:5984/demo/_all_docs
{"total_rows":1,"offset":0,"rows":[
{"id":"3ebb59dd78ff448f283f48817800321c","key":"3ebb59dd78ff448f283f48817800321c","value":{"rev":"1-0e4ea534f2c1e7f05e21804b5f2f7a71"}}
]}

# 获取一个uuid
curl -X GET http://127.0.0.1:5984/_uuids
{"uuids":["3ebb59dd78ff448f283f4881780033c0"]}

# 向demo数据库中添加一个文档（使用获取到的uuid做为Id）
curl -H "Content-Type:application/json"  -X PUT http://127.0.0.1:5984/demo/3ebb59dd78ff448f283f4881780033c0 -d {\"name\":\"momo314\"}
{"ok":true,"id":"3ebb59dd78ff448f283f4881780033c0","rev":"1-eb393d36ac1ad38ada8361d94fc5d0b6"}

# 更新指定Id的文档（可是失败了，由于CouchDB是按版本提交的，同一个源提交屡次会形成必定的混乱。因此，须要指定文档版本进行控制。）
curl -H "Content-Type:application/json"  -X PUT http://127.0.0.1:5984/demo/3ebb59dd78ff448f283f4881780033c0 -d {\"name\":\"momo314\",\"age\":18}
{"error":"conflict","reason":"Document update conflict."}

# 更新指定Id和指定版本的文档
curl -H "Content-Type:application/json"  -X PUT http://127.0.0.1:5984/demo/3ebb59dd78ff448f283f4881780033c0 -d {\"_rev\":\"1-eb393d36ac1ad38ada8361d94fc5d0b6\",\"name\":\"momo314\",\"age\":18}
{"ok":true,"id":"3ebb59dd78ff448f283f4881780033c0","rev":"2-5d081e17588c03c27340035e420edecd"}

# 获取指定Id的文档内容
curl -X GET http://127.0.0.1:5984/demo/3ebb59dd78ff448f283f4881780033c0
{"_id":"3ebb59dd78ff448f283f4881780033c0","_rev":"2-5d081e17588c03c27340035e420edecd","name":"momo314","age":18}

# 删除指定Id和rev版本号的文档
curl -X DELETE http://username:password@127.0.0.1:5984/demo/3ebb59dd78ff448f283f4881780033c0?rev=2-5d081e17588c03c27340035e420edecd
{"ok":true,"id":"3ebb59dd78ff448f283f4881780033c0","rev":"2-5d081e17588c03c27340035e420edecd"}

# 查看demo数据库中的全部文档(刚才的文档确实被删除掉了)
curl -X GET http://127.0.0.1:5984/demo/_all_docs
{"total_rows":1,"offset":0,"rows":[
{"id":"3ebb59dd78ff448f283f48817800321c","key":"3ebb59dd78ff448f283f48817800321c","value":{"rev":"1-0e4ea534f2c1e7f05e21804b5f2f7a71"}}
]}

# 删除demo数据库（须要admin权限，参照下一条命令）
curl -X DELETE http://127.0.0.1:5984/demo
{"error":"unauthorized","reason":"You are not a server admin."}

# 使用用户名密码登陆CouchDB，并删除demo数据库
curl -X DELETE http://username:password@127.0.0.1:5984/demo
{"ok":true}

# 查看全部数据库（demo数据库确实被删除掉了）
curl -X GET http://127.0.0.1:5984/_all_dbs
["_replicator","_users"]

博文参考：http://magic-conch.cool/article/2016/01/05/windows-couchdb-1

官网参考：https://docs.docker.com/engine/examples/couchdb_data_volumes/#create-first-database