CouchDB

CouchDB est un SGBD noSQL orienté documents.

Dans notre exemple, nous utilisons un accès SSH et considérons les informations suivantes :

  • Nom du compte : [compte]
  • Répertoire de CouchDB : /home/[compte]/couchdb/

Note

N'hésitez pas à ajuster en fonction de vos besoins.

Installation

Téléchargement et compilation

[compte]@ssh:~$ mkdir couchdb
[compte]@ssh:~$ cd couchdb
[compte]@ssh:~/couchdb$ wget -O- https://dlcdn.apache.org/couchdb/source/3.4.1/apache-couchdb-3.4.1.tar.gz | tar -xz --strip-components=1
[compte]@ssh:~/couchdb$ ./configure --spidermonkey-version 78
[compte]@ssh:~/couchdb$ make release

Choisissez le paquet tar.gz de la dernière version disponible sur le site institutionnel de CouchDB.

Configuration

Créez un fichier local.ini dans le répertoire /home/[compte]/couchdb avec les directives suivantes :

[admins]
admin = monsupermotdepasse

[couchdb]
single_node = true

[chttpd]
bind_address = ::
port = 5984

Note

monsupermotdepasse est à remplacer par le mot de passe de votre choix.

Les utilisateurs du Cloud public devront faire pointer le service sur un port entre 8300 à 8499 et modifier cette valeur dans le fichier de configuration.

Lancement du service

Créez un service avec les détails suivants :

  • Commande : ./bin/couchdb -couch_ini /home/[compte]/couchdb/local.ini
  • Répertoire de travail : /home/[compte]/couchdb/rel/couchdb

L'adresse pour se connecter à l'instance CouchDB sera services-[compte].alwaysdata.net:[port]. Par exemple, pour lister les bases de données :

$ curl -X GET http://admin:monsupermotdepasse@services-[compte].alwaysdata.net:[port]/_all_dbs

Note

[port] est à remplacer par le port indiqué dans le fichier local.ini.

Création de la règle de parefeu

Les utilisateurs du Cloud Privé devront ouvrir le port utilisé en créant une règle sur le parefeu s'ils souhaitent y accéder depuis l'extérieur :

Intitulé Valeur
Protocole UDP/TCP
Type ACCEPT
Direction Entrée
Hôtes <ne rien indiquer>
Ports 5984
Version IP IPv4/IPv6