CouchDBのソースを表示

[[Category:データベース管理システム]]
[[en:CouchDB]]
[http://couchdb.apache.org/ CouchDB のホームページ] より:
:Apache CouchDB は JavaScript を使って MapReduce の方式でクエリを書いたりインデックスを作成できるドキュメント指向データベースです。

== インストール ==

{{Pkg|couchdb}} パッケージをインストールしてください。

デフォルトでは、ヘッドレスサーバー向けの GTK を必要としない {{Pkg|erlang-nox}} が依存パッケージになっています。GTK を必要とする標準版の {{Pkg|erlang}} をインストールすることも可能です。

== 使用方法 ==

{{ic|couchdb.service}} デーモンを[[systemd#ユニットを使う|起動・有効化]]してください。

サービスが実行できているか確認するには {{ic|curl -XGET <nowiki>http://127.0.0.1:5984/</nowiki>}} を実行します。Ping は動作しません。他のシステムから CouchDB のインスタンスにアクセスするには設定が必要になります (下を参照)。

=== Futon 管理インターフェイスを使う ===

Futon 管理インターフェイスは [http://localhost:5984/_utils http://localhost:5984/_utils] を開くことでアクセスできます。

== 設定 ==

{{ic|/etc/couchdb/local.ini}} のデフォルトポート、バインドアドレス、ログレベルなどの設定を変更してください。

{{Tip|ローカルマシン以外の他のコンピュータから CouchDB にアクセスできるようにするには {{ic|bind_address}} を {{ic|0.0.0.0}} に設定します。}}

ポート 80 で CouchDB を実行したいときは root でデーモンを実行するか、以下のような iptables ルールを使う必要があります:

 $ iptables -t nat -A PREROUTING -p tcp --dport 80 -j REDIRECT --to-ports 5984

{{Note|{{ic|/etc/couchdb/default.ini}} を編集してはいけません。このファイルは couchdb のアップデートで上書きされてしまいます。変更したい値をコピーして {{ic|/etc/couchdb/local.ini}} に記述するようにしてください。また、ファイルの変更をした後は {{ic|couchdb.service}} を再起動します。}}

=== 自己署名証明書の作成 ===

自己署名証明書で ssl を使いたいときは以下のようにして証明書を作成できます:

 # cd /etc/couchdb
 # openssl req -new -x509 -nodes -newkey rsa:4096 -keyout server.key -out server.crt

{{ic|[daemons]}} の httpsd をアンコメントして {{ic|[ssl]}} セクションのパスを更新してください:

{{hc|/etc/couchdb/local.ini|2=
[daemons]
httpsd = {couch_httpd, start_link, [https]}

[ssl]
cert_file = /etc/couchdb/server.crt
key_file = /etc/couchdb/server.key
}}

ポート 6984 の [https://localhost:6984/_utils/ https://localhost:6984/_utils/] から SSL で Futon にアクセスすることができます。

=== 管理者ユーザーの作成 ===

サーバーの管理者を設定する前は、全てのクライアントに管理者権限が与えられます。管理者ユーザーを作成するには、Futon インターフェイスの右下にある "Fix this" リンクをクリックしてください。

データベースのロックダウンやセキュリティに関する詳細は [http://lizconlan.github.com/sandbox/securing-couchdb.html 読み取り専用データベースの作成] を見て下さい。

== シングルノード構成とセキュリティ ==

シングルノードで CouchDB を実行する場合、公開ネットワークインターフェイスに不必要にバインドしないことでセキュリティを向上させることができます。バインドを行うプロセスは {{ic|epmd}} と {{ic|beam.smp}} です。前者は簡単に設定できます。{{ic|couchdb.service}} のドロップイン設定として以下のファイルを追加してください:

{{hc|/etc/systemd/system/couchdb.service.d/10-bind-locally.conf|2=
[Service]
Environment=ERL_EPMD_ADDRESS=127.0.0.1
}}

後者は難しい作業が必要で、まだ解決方法は分かっていません。

== 参照 ==

* [http://couchdb.apache.org/ CouchDB 公式ページ]
* [http://wiki.apache.org/couchdb/FrontPage CouchDB Wiki]
* [http://guide.couchdb.org/ CouchDB - The Definitive Guide]
* [http://lizconlan.github.com/sandbox/securing-couchdb.html 読み取り専用データベースの作成]