Come installare Apache CouchDB 3.1 su Ubuntu 20.04 LTS

0 2 2 minutes read

Apache CouchDB è un sistema di database NoSQL open source orientato ai documenti scritto in Erlang, JavaScript, C e C++. Utilizza JSON per archiviare i dati. È possibile accedere ai documenti con il browser web. Viene utilizzato principalmente per eseguire query e creare report da file di documenti.

CouchDB è dotato di 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 comodi 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, digitare:

$ curl https://couchdb.apache.org/repo/keys.asc | gpg --dearmor > couchdb-repo-keyring.gnp && sudo mv couchdb-repo-keyring.gnp /usr/share/keyrings/

Passaggio 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/

Passaggio 3: aggiorna il tuo sistema Ubuntu

Aggiorna il tuo sistema Ubuntu e ottieni le ultime informazioni sul pacchetto:

$ sudo apt update

Passaggio 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 pop-up di installazione guidata di CouchDB. Questa procedura guidata ti aiuta a preconfigurare CouchDB come nodo autonomo o in cluster, l’indirizzo IP a cui collegarsi e una password per l’utente amministratore.

Premere il tasto “Invio” per continuare la configurazione

Selezionare “standalone” e premere Invio.

Premere “Invio” per impostare l’indirizzo di accesso

Il cluster CouchDB e la modalità autonoma utilizzano la porta 5984. Per il clustering, utilizza il clustering Erlang nativo, utilizzando la porta 4369. Se disponi di un firewall, assicurati che queste porte siano aperte.

Passaggio 6: verifica l’installazione di CouchDB

Al momento dell’installazione, CouchDB dovrebbe essere già attivo e funzionante 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 tuo terminale.

$ curl http://127.0.0.1:5984

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 ho 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}”.

Per esempio:

$ curl -X PUT "http://admin:sample_password@127.0.0.1:5984/sample_database"

L’output che conferma la corretta creazione del database:

{
    "ok" : true
 }

Per elencare tutti i database CouchDB, digita:

$ curl -X GET http://admin:sample_password@127.0.0.1:5984/_all_dbs

Produzione:

[
    "_replicator",
    "_users",
    "sample_database"
 ]

Passaggio 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/.

Connessione all'interfaccia web di CouchDB — Connessione all’interfaccia web di CouchDB

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.