Comment installer Apache Couch DB sur AlmaLinux 9

Sur cette page

Conditions préalables
Configurer le référentiel Apache CouchDB
Installation d’Apache CouchDB via un référentiel
Configuration de Firewalld
Accéder à l’administration Web d’Apache CouchDB
Gestion d’une base de données dans Apache CouchDB
1. Gestion des opérations de base via l’interface utilisateur Web
2. Opérations de base de données avec curl
Conclusion

Apache CouchDB est une base de données NoSQL open-source et orientée document qui prend en charge plusieurs formats et protocoles pour stocker ses données. Il est écrit en Erlang et peut être exécuté comme une base de données à nœud unique haute performance.

Apache CouchDB vous permet d’utiliser JSON pour stocker des données, et il fournit également une interface utilisateur web pour gérer le système CouchDB et une API HTTP qui vous permet d’interroger facilement les données.

Dans ce guide, nous allons vous guider tout au long de l'installation d'Apache CouchDB sur le serveur AlmaLinux 9. Vous installerez Apache CouchDB dans un cluster single_node, et configurerez l’utilisateur admin et le pare-feu pour CouchDB. De plus, vous apprendrez à créer une base de données et à documenter sur Apache CouchDB via l’interface utilisateur web et l’API HTTP avec Curl.

Conditions préalables

Pour compléter ce guide, vous devez disposer des éléments suivants :

Un serveur AlmaLinux 9.
Un utilisateur non root avec des privilèges d’administrateur.
Un SELinux avec mode permissif.

Configurer le référentiel Apache CouchDB

Apache CouchDB est une base de données NoSQL multiplateforme qui peut être installée sur Linux, Windows, macOS et FreeBSD, ainsi que sur les technologies de conteneurs telles que Docker et Kubernetes. Pour les distributions basées sur RHEL, vous installerez CouchDB à partir du dépôt officiel via DNF.

Tout d’abord, exécutez la commande suivante pour installer le dnf-plugins-core sur votre serveur AlmaLinux.

sudo dnf install dnf-plugins-core -y

Ajoutez le référentiel Apache CouchDB à votre système à l’aide de la commande suivante

sudo dnf config-manager --add-repo https://couchdb.apache.org/repo/couchdb.repo

Maintenant, exécutez la commande dnf ci-dessous et vérifiez les dépôts disponibles sur votre système. Assurez-vous que le référentiel Apache CouchDB est ajouté.

sudo dnf repolist

Après avoir ajouté le dépôt, installez le paquet Apache CouchDB à l’aide de la commande dnf ci-dessous.

sudo dnf install couchdb

Tapez y et appuyez sur ENTER pour continuer.

De plus, lorsque vous êtes interrogé sur la clé GPG Apache CouchDB, entrez y pour ajouter la clé à votre système.

Une fois l’installation terminée, continuez.

Installation d’Apache CouchDB via un référentiel

Après avoir installé CouchDB via DNF, vous modifierez la configuration par défaut de CouchDB, configurerez le cluster single_node, configurerez l’utilisateur et le mot de passe de l’administrateur, puis configurerez l’adresse HTTP avec une adresse IP de serveur local.

Ouvrez la configuration par défaut /opt/couchdb/etc/local.ini à l’aide de la commande nano editor.

sudo nano /opt/couchdb/etc/local.ini

Dans la section '[couchdb]', ajoutez la ligne suivante pour configurer le nœud unique Apache CouchDB.

[couchdb]
single_node=true

Enregistrez et fermez le fichier lorsque vous avez terminé.

Ensuite, créez une nouvelle configuration /opt/couchdb/etc/local.d/10-admins.ini à l’aide de la commande nano editor suivante.

sudo nano /opt/couchdb/etc/local.d/10-admins.ini

Ajoutez la configuration ci-dessous au fichier et assurez-vous de modifier l’utilisateur et le mot de passe de l’administrateur avec vos données. Ce mot de passe en clair sera chiffré automatiquement lors de l’exécution d’Apache CouchDB.

[admins]
admin = password

Enregistrez et fermez le fichier lorsque vous avez terminé.

Ouvrez maintenant la configuration par défaut /opt/couchdb/etc/default.ini à l’aide de la commande nano editor ci-dessous.

sudo nano /opt/couchdb/etc/default.ini

Dans la section '[chttpd]', remplacez le 'bind_address' par défaut par votre adresse IP locale. Cela vous permet d’accéder à partir de votre ordinateur local.

[chttpd]
bind_address = 192.168.5.50

Enregistrez et fermez le fichier lorsque vous avez terminé.

Après cela, exécutez la commande systemctl ci-dessous pour démarrer et activer le service couchdb.

sudo systemctl start couchdb
sudo systemctl enable couchdb

Enfin, vérifiez le service couchdb à l’aide de la commande ci-dessous pour vous assurer qu’il est en cours d’exécution.

sudo systemctl status couchdb

Si couchdb est en cours d'exécution, vous devriez obtenir la sortie telle que 'active (running)'.

Configuration de Firewalld

Maintenant que CouchDB est en cours d’exécution, vous allez configurer firewalld pour ouvrir les ports 5984/tcp et 4369/tcp et autoriser l’accès à votre installation Apache CouchDB.

Exécutez la commande suivante pour ouvrir les ports 5984/tcp et 4369/tcp pour Apache CouchDB.

sudo firewall-cmd --permanent --add-port={5984/tcp,4369/tcp}

Rechargez firewalld pour appliquer vos modifications.

sudo firewall-cmd --reload

Vérifiez ensuite la liste des ports disponibles sur firewalld à l’aide de la commande ci-dessous. Assurez-vous que les ports 5984/tcp et 4369/tcp sont disponibles.

sudo firewall-cmd --list-all

Enfin, exécutez la commande curl ci-dessous pour vérifier Apache CouchDB.

curl http://192.168.5.50:5984/

Vous pouvez également installer 'jq' via DNF et analyser la sortie JSON pour la rendre lisible.

sudo dnf install -y

Analysez la sortie JSON à l’aide de la commande comme suit :

curl http://192.168.5.50:5984/ | jq .

Si votre installation de CouchDB réussit, vous devriez obtenir ce qui suit.

Accéder à l’administration Web d’Apache CouchDB

À ce stade, vous avez configuré Apache CouchDB et firewalld, vous êtes prêt à accéder à l'installation de CouchDB.

Pour accéder à Apache CouchDB, rendez-vous sur l’adresse IP de votre serveur suivie du port 5984 (c’est-à-dire http://192.168.5.50:5984/_utils#setup) à l’aide de votre navigateur web préféré. Vous devriez obtenir la page de connexion d’Apache CouchDB.

Saisissez votre utilisateur et votre mot de passe d’administrateur, puis cliquez sur Connexion.

Si vous avez le bon nom d’utilisateur et le bon mot de passe, vous devriez obtenir le tableau de bord d’administration d’Apache CouchDB.

Gestion d’une base de données dans Apache CouchDB

Maintenant que vous vous êtes connecté au tableau de bord d'administration d'Apache CouchDB, l'étape suivante consiste à apprendre à créer une base de données et à insérer des données sur CouchDB via l'interface utilisateur web et l'API HTTP avec Curl.

Gestion des opérations de base via l’interface utilisateur Web

Avant de commencer, assurez-vous d'être connecté au tableau de bord d'administration d'Apache CouchDB.

Tout d’abord, vous allez créer une nouvelle base de données via l’interface web d’Apache CouchDB :

Cliquez sur le menu Bases de données, puis sur le bouton Créer une base de données.

Entrez le nom de la nouvelle base de données et cliquez sur Créer.

Maintenant que vous avez créé une base de données sur Apache CouchDB, cliquez sur le nom de votre base de données.

Pour créer un document, cliquez sur le bouton Créer un document.

Entrez vos données JSON, puis cliquez sur Créer un document pour confirmer.

{
    "item": "apple",
   "prices": {
       "Fresh Mart": 1.59,
       "Price Max": 5.99,
       "Apples Express": 0.79
   }
}

Une fois le document créé, vous devriez obtenir le résultat 'Enregistrement du document'.

Dans les détails de votre base de données, cliquez sur l’onglet Table et vous devriez voir le document JSON que vous avez créé.

Si vous devez modifier le document, cliquez sur le nom du document, modifiez votre document, puis cliquez sur Enregistrer les modifications. En outre, vous pouvez supprimer des documents à partir de là avec le bouton de suppression dans le menu de droite.

Opérations de base de données avec curl

Dans la section suivante, vous allez apprendre à créer une base de données et à insérer des données dans Apache CouchDB via l’API HTTP à l’aide de Curl.

Tout d’abord, exécutez la commande suivante pour vous authentifier auprès d’Apache CouchDB et répertorier les bases de données disponibles via curl. Assurez-vous de changer l’utilisateur et le mot de passe de l’administrateur avec vos données.

curl -X GET http://admin:[email :5984/_all_dbs | jq .

En cas de réussite, vous devriez voir les fruits de la base de données que vous avez créés via l'interface utilisateur web disponible.

Maintenant, créez une nouvelle base de données CouchDB en utilisant l’option PUT dans une boucle comme celle-ci.

curl -X PUT http://admin:[email :5984/players | jq .

Une fois la base de données créée, vous devez obtenir un résultat comme suit :

Une fois la base de données créée, vérifiez les détails des lecteurs de la base de données à l’aide de la commande ci-dessous.

curl -X GET http://admin:[email :5984/players | jq .

La sortie suivante s’affiche :

Ensuite, pour créer un nouveau document et insérer des données dans CouchDB, utilisez la commande curl suivante.

curl -X PUT http://admin:[email :5984/players/documents \
-d '{"Name": "Nikola Jokic", "Team": "Denver Nuggets"}' | jq .

En cas de succès, vous devriez obtenir le résultat '"<strong style=font-family :sans-serif>ok » : true'.

Vérifiez les détails de votre document à l’aide de la commande ci-dessous. Vous devriez voir que votre document est disponible sur Apache CouchDB.

curl -X GET http://admin:[email :5984/players/documents

Vous devez voir les données que vous avez ajoutées, telles que les suivantes.

Conclusion

Félicitations! Vous avez installé avec succès Apache CouchDB sur le serveur AlmaLinux 9. Vous avez également configuré un cluster single_node, ajouté un utilisateur administrateur et un mot de passe, et également configuré CouchDB pour qu'il s'exécute à l'adresse IP interne.

De plus, vous avez également appris à créer une nouvelle base de données et à insérer des données sur CouchDB via l'interface utilisateur web et l'API HTTP avec Curl. Désormais, vous pouvez ajouter d’autres nœuds et configurer un cluster Apache CouchDB pour maximiser vos performances.