Apache CouchDB è un sistema di database orientato ai documenti open source NoSQL scritto in Erlang, JavaScript, C e C++. Utilizza JSON per archiviare i dati. È possibile accedere ai documenti con il proprio browser web. Viene utilizzato principalmente per eseguire query e creare report da file di documenti.
CouchDB include funzionalità come la trasformazione immediata dei documenti, le notifiche di modifica in tempo reale, l'elevata disponibilità, il ridimensionamento distribuito, la tolleranza delle partizioni e altro ancora. Viene fornito con un'interfaccia di amministrazione web.
In questo tutorial impariamo come installare CouchDB su Ubuntu 20.04 utilizzando i convenienti pacchetti binari.
Passaggio 1:aggiungi la chiave GPG di CouchDB
Innanzitutto, aggiungiamo la chiave GPG di CouchDB. Per recuperare la chiave repo ufficiale di CouchDB, digita:
$ curl https://couchdb.apache.org/repo/keys.asc | gpg --dearmor > couchdb-repo-keyring.gnp && sudo mv couchdb-repo-keyring.gnp /usr/share/keyrings/
Fase 2:abilita il repository CouchDB
Per abilitare il repository CouchDB, esegui il seguente comando:
$ echo "deb [signed-by=/usr/share/keyrings/couchdb-repo-keyring.gnp] https://apache.jfrog.io/artifactory/couchdb-deb focal main" > couchdb.list && sudo mv couchdb.list /etc/apt/sources.list.d/
Fase 3:aggiorna il sistema Ubuntu
Aggiorna il tuo sistema Ubuntu e ottieni le ultime informazioni sul pacchetto:
$ sudo apt update
Fase 4:installa CouchDB su Ubuntu
Ora puoi installare CouchDB usando il comando apt:
$ sudo apt-get install -y couchdb
Come parte dell'installazione, dovresti vedere un popup di configurazione guidata di CouchDB. Questa procedura guidata aiuta a preconfigurare CouchDB come nodo autonomo o in cluster, indirizzo IP a cui si collegherà e una password per l'utente amministratore.
Il cluster CouchDB e la modalità standalone utilizzano la porta 5984. Per il clustering, utilizza il clustering nativo di Erlang, utilizzando la porta 4369. Se disponi di un firewall, assicurati che queste porte siano aperte.
Fase 6:verifica l'installazione di CouchDB
Al momento dell'installazione, CouchDB dovrebbe essere già in esecuzione e pronto per l'uso. CouchDB è installato nella directory /opt/couchdb
.
Per essere sicuro che l'installazione sia andata a buon fine, prova ad accedere all'URL del server Couchdb dal terminale.
$ curl http://127.0.0.1:5984
L'output che mostra la versione, tra le altre informazioni generali, dell'installazione di CouchDB:
{ "couchdb" : "Welcome", "features" : [ "access-ready", "partitioned", "pluggable-storage-engines", "reshard", "scheduler" ], "git_sha" : "ce596c65d", "uuid" : "4433afd11f516283786140ffafdaee5c", "vendor" : { "name" : "The Apache Software Foundation" }, "version" : "3.1.1" }
Puoi vedere che abbiamo installato CouchDB versione 3.1 .
Il nome utente predefinito è "admin" e dovresti aver scelto una password.
Per creare un database, la sintassi è "http://{username}:{password}@127.0.0.1:5984/{your new database}".
Ad esempio:
$ curl -X PUT "http://admin:[email protected]:5984/sample_database"
L'output che conferma la corretta creazione del database:
{ "ok" : true }
Per elencare tutti i database di CouchDB, digita:
$ curl -X GET http://admin:[email protected]:5984/_all_dbs
Uscita:
[ "_replicator", "_users", "sample_database" ]
Fase 6:accedi all'interfaccia Web di CouchDB
CouchDB ha un'interfaccia Web integrata per creare, aggiornare, eliminare e visualizzare documenti e documenti di progettazione.
Per accedere all'interfaccia web di CouchDB, punta il tuo browser preferito su http://127.0.0.1:5984/_utils/.
Conclusione
In questo tutorial, abbiamo imparato come installare CouchDB su Ubuntu 20.04. Se hai domande, suggerimenti, feedback, scrivili nella casella dei commenti qui sotto.