Apache CouchDB je bezplatná a open source databáze NoSQL vyvinutá nadací Apache Software Foundation. Může být použita jako jednouzlová nebo klastrovaná databáze.
Server CouchDB ukládá svá data do pojmenovaných databází, které obsahují dokumenty se strukturou JSON. Každý dokument se skládá z řady polí a příloh. Pole mohou obsahovat text, čísla, seznamy, logické hodnoty a další. Zahrnuje RESTful HTTP API, které vám umožňuje číst, vytvářet, upravovat a mazat databázové dokumenty.
V tomto článku se budeme zabývat instalací CouchDB na CentOS 8.
Povolení úložiště CouchDB #
Nejjednodušší způsob, jak nainstalovat CouchDB na CentOS 8, je povolit úložiště dodavatele a nainstalovat binární balíčky.
Otevřete editor podle svého výběru jako root nebo uživatel s právy sudo a vytvořte soubor úložiště CouchDB:
sudo nano /etc/yum.repos.d/bintray-apache-couchdb-rpm.repo
Do souboru vložte následující obsah:
/etc/yum.repos.d/bintray-apache-couchdb-rpm.repo[bintray--apache-couchdb-rpm]
name=bintray--apache-couchdb-rpm
baseurl=http://apache.bintray.com/couchdb-rpm/el$releasever/$basearch/
gpgcheck=0
repo_gpgcheck=0
enabled=1
Uložte soubor a zavřete editor.
Instalace CouchDB na CentOS #
Nainstalujte balíčky CouchDB spuštěním následujícího příkazu:
sudo dnf install couchdb
Po dokončení instalace povolte a spusťte službu CouchDB:
sudo systemctl enable --now couchdb
Konfigurace CouchDB #
CouchDB lze nastavit v režimu jednoho uzlu nebo clusteru. V tomto příkladu nasadíme server v konfiguraci s jedním uzlem. Podívejte se na oficiální dokumentaci o tom, jak nastavit CouchDB v clusterovém režimu.
CouchDB můžete nakonfigurovat pomocí Fauxton na http://127.0.0.1:5984/_utils#setup
nebo z příkazového řádku. Průvodce nastavením vás provede výběrem režimu a vytvořením správce.
Vytvoříme uživatele admin a databáze z příkazového řádku.
Data a konfigurační soubory Apache CouchDB jsou uloženy v /opt/couchdb
adresář. Chcete-li vytvořit účet správce, otevřete local.ini
a přidejte řádek pod [admins]
sekce ve formátu username = password
.
sudo nano /opt/couchdb/etc/local.ini
/opt/couchdb/etc/local.ini[admins]
admin = mysecretpassword
Restartujte službu CouchDB a změňte heslo na hash:
sudo systemctl restart couchdb
Stejný formát můžete použít k přidání více účtů správce. Po přidání nového účtu vždy restartujte službu CouchDB.
Použijte curl
k vytvoření systémových databází _users
, _replicator
a _global_changes
:
curl -u ADMINUSER:PASS -X PUT http://127.0.0.1:5984/_users
curl -u ADMINUSER:PASS -X PUT http://127.0.0.1:5984/_replicator
curl -u ADMINUSER:PASS -X PUT http://127.0.0.1:5984/_global_changes
Každý příkaz by měl vrátit následující:
{"ok":true}
Ověřování instalace CouchDB #
Server CouchDB běží na localhost:5984
. Chcete-li ověřit, zda byla instalace úspěšná a služba je spuštěna, spusťte následující curl
příkaz, který vytiskne informace o databázi CouchDB ve formátu JSON:
curl http://127.0.0.1:5984/
Pro přehlednost je výstup níže naformátován.
{
"couchdb":"Welcome",
"version":"2.3.1",
"git_sha":"c298091a4",
"uuid":"5e3878666b1077eb9d4a7ba7b06c251b",
"features":[
"pluggable-storage-engines",
"scheduler"
],
"vendor":{
"name":"The Apache Software Foundation"
}
}
Pokud dáváte přednost GUI, můžete přistupovat k webovému rozhraní CouchDB, Fauxton na adrese:
http://127.0.0.1:5984/_utils/