Apache CouchDB è un database NoSQL gratuito e open source sviluppato dalla Apache Software Foundation.
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 tutorial spiegheremo come installare l'ultima versione di CouchDB su CentOS 7.
Prerequisiti #
Per poter installare nuovi pacchetti sul tuo sistema CentOS, devi aver effettuato l'accesso come utente con privilegi sudo.
Abilita repository CouchDB #
Il repository CouchDB dipende dal repository EPEL. Se il repository EPEL non è abilitato sul tuo sistema, abilitalo digitando:.
sudo yum install epel-release
Quindi, apri il tuo editor preferito e crea il file del 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.
Installa CouchDB su CentOS #
Ora che il repository è abilitato, puoi installare i pacchetti CouchDB utilizzando il seguente comando:
sudo yum install couchdb
Una volta completata l'installazione, abilita e avvia il servizio CouchDB:
sudo systemctl start couchdb
sudo systemctl enable couchdb
Per impostazione predefinita, CouchDB è in ascolto solo su localhost e non viene creato alcun account amministratore.
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
Trasforma la password in un hash, riavviando il servizio CouchDB:
sudo systemctl restart couchdb
Usa lo stesso formato per aggiungere più account amministratore. Dovrai riavviare 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 #
Per verificare se l'installazione è stata eseguita correttamente, emetti il seguente curl
comando che stamperà le informazioni del 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":"17a6b911e0d5bfe36778b387510dbd93",
"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/