
Apache CouchDB è un database NoSQL gratuito e open source sviluppato dalla Apache Software Foundation. Può essere utilizzato come database a nodo singolo o in cluster.
Il server CouchDB memorizza i suoi dati in database denominati, che contengono documenti con struttura JSON. Ogni documento è composto da una serie di campi e allegati. I campi possono includere testo, numeri, elenchi, valori booleani e altro. Include un'API HTTP RESTful che ti consente di leggere, creare, modificare ed eliminare documenti di database.
In questo articolo tratteremo l'installazione di CouchDB su CentOS 8.
Abilitazione del repository CouchDB #
Il modo più semplice per installare CouchDB su CentOS 8 è abilitare il repository del fornitore e installare i pacchetti binari.
Apri il tuo editor preferito come root o utente con privilegi sudo e crea il file repository CouchDB:
sudo nano /etc/yum.repos.d/bintray-apache-couchdb-rpm.repo
Incolla il seguente contenuto nel file:
/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
Salva il file e chiudi l'editor.
Installazione di CouchDB su CentOS #
Installa i pacchetti CouchDB eseguendo il comando seguente:
sudo dnf install couchdb
Una volta completata l'installazione, abilita e avvia il servizio CouchDB:
sudo systemctl enable --now couchdb
Configurazione di CouchDB #
CouchDB può essere impostato in modalità a nodo singolo o in cluster. In questo esempio, distribuiremo il server in configurazione a nodo singolo. Consulta la documentazione ufficiale su come configurare CouchDB in modalità cluster.
Puoi configurare CouchDB usando Fauxton, su http://127.0.0.1:5984/_utils#setup
o dalla riga di comando. La configurazione guidata ti guiderà attraverso la selezione della modalità e la creazione dell'amministratore.
Creeremo l'utente amministratore e i database dalla riga di comando.
I dati e i file di configurazione di Apache CouchDB sono archiviati in /opt/couchdb
directory. Per creare un account amministratore, apri local.ini
file e aggiungi una riga sotto [admins]
sezione nel formato username = password
.
sudo nano /opt/couchdb/etc/local.ini
/opt/couchdb/etc/local.ini[admins]
admin = mysecretpassword
Riavvia il servizio CouchDB per cambiare la password in un hash:
sudo systemctl restart couchdb
Puoi utilizzare lo stesso formato per aggiungere più account amministratore. Riavvia sempre il servizio CouchDB dopo aver aggiunto un nuovo account.
Usa curl
per creare i database di sistema _users
, _replicator
e _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
Ogni comando dovrebbe restituire quanto segue:
{"ok":true}
Verifica dell'installazione di CouchDB #
Il server CouchDB è in esecuzione su localhost:5984
. Per verificare se l'installazione è stata eseguita correttamente e il servizio è in esecuzione, esegui il seguente curl
comando che stamperà le informazioni sul database CouchDB in formato JSON:
curl http://127.0.0.1:5984/
Per chiarezza, l'output di seguito è formattato.
{
"couchdb":"Welcome",
"version":"2.3.1",
"git_sha":"c298091a4",
"uuid":"5e3878666b1077eb9d4a7ba7b06c251b",
"features":[
"pluggable-storage-engines",
"scheduler"
],
"vendor":{
"name":"The Apache Software Foundation"
}
}
Se preferisci la GUI, puoi accedere all'interfaccia basata sul Web di CouchDB, Fauxton all'indirizzo:
http://127.0.0.1:5984/_utils/
