こんにちは。

couchdb に触れてみました。
docker compose で立ち上げるのに手間取ったため、メモ書きです。

couchdb を立ち上げる

docker-compose.yaml は次のとおりです。

version: '3'

services:
  couch:
    image: couchdb:latest
    ports:
      - 5984:5984
    environment:
      - COUCHDB_USER=      # username
      - COUCHDB_PASSWORD=  # password
    volumes:
      - ./couchdata:/opt/couchdb/data

docker compose up コマンドを打てば couchdb が 5984 ポートで立ち上がります。

Fauxton

couchdb には管理画面が付いてます。いわゆるGUIクライアントです。
Fauxton と呼びます。

Fauxton は _utils 配下にいます。ローカルだと http://localhost:5984/_utils でしょうか。
ここで database の作成や document の追加を行えます。

database_does_not_exist というエラー

docker compose up すると、次のようなメッセージが出力されました。

$ docker compose up
...
couch-1  | [error] xxx -------- Error in process <xxx> with exit value:
couch-1  | {database_does_not_exist,[{mem3_shards,load_shards_from_db,"_users",[{file,"src/mem3_shards.erl"},{line,430}]},{ ...

システムで必要な database が存在しない、と言っているようです。
ドキュメントによるとシステムで必要な database は _users, _replicator, _global_changes の3つのようです。

私の場合 _users を作成するとエラーメッセージは出力されなくなりました。

Links

• dockerhub
• Why is couchdb looking for "_users" database?
• https://docs.couchdb.org/en/latest/setup/single-node.html