Apache CouchDB est une base de données NoSQL gratuite et open source développée par Apache Software Foundation.
Le serveur CouchDB stocke ses données dans des bases de données nommées qui contiennent des documents avec une structure JSON. Chaque document se compose d'un certain nombre de champs et de pièces jointes. Les champs peuvent inclure du texte, des nombres, des listes, des booléens, etc. Il comprend une API HTTP RESTful qui vous permet de lire, créer, modifier et supprimer des documents de base de données.
Dans ce tutoriel, nous allons vous expliquer comment installer la dernière version de CouchDB sur CentOS 7.
Prérequis #
Pour pouvoir installer de nouveaux packages sur votre système CentOS, vous devez être connecté en tant qu'utilisateur avec des privilèges sudo.
Activer le référentiel CouchDB #
Le référentiel CouchDB dépend du référentiel EPEL. Si le référentiel EPEL n'est pas activé sur votre système, activez-le en saisissant :.
sudo yum install epel-release
Ensuite, ouvrez l'éditeur de votre choix et créez le fichier de référentiel CouchDB :
sudo nano /etc/yum.repos.d/bintray-apache-couchdb-rpm.repo
Collez le contenu suivant dans le fichier :
/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
Enregistrez le fichier et fermez l'éditeur.
Installer CouchDB sur CentOS #
Maintenant que le référentiel est activé, vous pouvez installer les packages CouchDB à l'aide de la commande suivante :
sudo yum install couchdb
Une fois l'installation terminée, activez et démarrez le service CouchDB :
sudo systemctl start couchdb
sudo systemctl enable couchdb
Par défaut, CouchDB écoute uniquement sur localhost et aucun compte administrateur n'est créé.
Les données et les fichiers de configuration d'Apache CouchDB sont stockés dans le répertoire /opt/couchdb
annuaire. Pour créer un compte administrateur ouvrez le local.ini
fichier et ajoutez une ligne sous le [admins]
section au format username = password
.
sudo nano /opt/couchdb/etc/local.ini
/opt/couchdb/etc/local.ini[admins]
admin = mysecretpassword
Transformez le mot de passe en hachage en redémarrant le service CouchDB :
sudo systemctl restart couchdb
Utilisez le même format pour ajouter plusieurs comptes administrateur. Vous devrez redémarrer le service CouchDB après avoir ajouté un nouveau compte.
Utilisez curl
pour créer les bases de données système :_users
, _replicator
et _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
Chaque commande doit renvoyer ce qui suit :
{"ok":true}
Vérification de l'installation de CouchDB #
Pour vérifier si l'installation a été effectuée avec succès, émettez le curl
suivant commande qui imprimera les informations de la base de données CouchDB au format JSON :
curl http://127.0.0.1:5984/
Pour plus de clarté, la sortie ci-dessous est formatée.
{
"couchdb":"Welcome",
"version":"2.3.1",
"git_sha":"c298091a4",
"uuid":"17a6b911e0d5bfe36778b387510dbd93",
"features":[
"pluggable-storage-engines",
"scheduler"
],
"vendor":{
"name":"The Apache Software Foundation"
}
}
Si vous préférez l'interface graphique, vous pouvez accéder à l'interface Web de CouchDB, Fauxton à :
http://127.0.0.1:5984/_utils/