Comment installer le forum NodeBB sur CentOS 7

NodeBB est unlogiciel de forum basé sur Node.js et conçu pour le Web moderne. Il repose sur une base de données MongoDB ou Redis.Il utilise des sockets Web pour des interactions instantanées et des notifications en temps réel. NodeBB possède de nombreuses fonctionnalités modernes prêtes à l’emploi, comme l’intégration des réseaux sociaux et les discussions en continu.Des fonctionnalités supplémentaires sont disponibles grâce à l’utilisation de plugins tiers.NodeBB est un projet open source que tu trouveras sur Github.Dans ce guide, nous te guiderons pas à pas dans le processus d’installation de NodeBB sur le système d’exploitation CentOS 7.

Exigences

NodeBB nécessite l’installation des logiciels suivants :

  • Node.js version 6 ou supérieure
  • MongoDB version 2.6 ou supérieure ouRedis version 2.8.9 ou supérieure
  • Nginx version 1.3.13 ou supérieure
  • Git

Conditions préalables

  • Un serveur exécutant le système CentOS 7 x86_64 (64 bits) avec au moins 1 Go de RAM
  • Nom de domaine avec des enregistrementsA/AAAAconfigurés
  • Un utilisateur non-root avec des privilèges sudo.

Étapes initiales

Vérifie la version de CentOS :

cat /etc/centos-release
# CentOS Linux release 7.5.1804 (Core)

Configure le fuseau horaire :

timedatectl list-timezones
sudo timedatectl set-timezone 'Region/City'

Mets à jour les paquets de ton système d’exploitation (logiciels):

sudo yum update -y

Installe les paquets nécessaires pour terminer ce tutoriel :

sudo yum install -y curl wget vim bash-completion git socat epel-release

Pour des raisons de simplicité, désactive SELinux et Firewall :

sudo setenforce 0; sudo systemctl stop firewalld.service; sudo systemctl disable firewalld.service

Étape 1 : Installe Node.js et npm

NodeBB est construit sur Node.js.Nous allons installerrecommandéversion pour NodeBB qui est la version 8au moment de la rédaction de cet article. Sur Linux, tu as plusieurs options d’installation de Node.js : Binaires Linux (x86/x64), Code source ou via les gestionnaires de paquets. Nous utiliserons l’option Gestionnaire de paquets qui facilite l’installation et la mise à jour de Node.js.

Télécharge et installe la dernière versionLong-Term Support (LTS) de Node.js depuis le dépôt Nodesource :

curl --silent --location https://rpm.nodesource.com/setup_8.x | sudo bash -
sudo yum -y install nodejs

Pour compiler et installer les addons natifs de npm, tu devras peut-être aussi installer des outils de construction :

sudo yum install -y gcc-c++ make
# or
# sudo yum groupinstall -y 'Development Tools'

NOTE: npm est distribué avec Node.js – ce qui signifie que lorsque tu télécharges Node.js, tu obtiens automatiquement npm installé sur ton système.

Vérifie les versions de Node.js et de npmsont installés :

node -v && npm -v
# v8.12.0
# 6.4.1

Npm est un projet distinct de Node.js, et a tendance à se mettre à jour plus fréquemment. Par conséquent, même si tu viens de télécharger Node.js (et donc npm), tu auras probablement besoin de mettre à jour ton npm. Heureusement, npm sait comment se mettre à jour lui-même ! Pour mettre à jour ton npm, tape ceci dans ton terminal :

sudo npm install -g [email protected]

Cette commande mettra à jour npm à la dernière version stable.

Étape 2 : Installe et configure MongoDB

NodeBB a besoin d’une base de données pour stocker ses données, et il prend en charge MongoDB et Redis. Dans ce tutoriel, nous avons choisi MongoDB comme moteur de stockage de données. Donc, dans les prochaines étapes, nous allons télécharger et installer la base de données MongoDB à partir du dépôt rpm officiel de MongoDB :

Crée un/etc/yum.repos.d/mongodb-org-4.0.repopour que tu puisses installer MongoDB directement en utilisantyum:

sudo vim /etc/yum.repos.d/mongodb-org-4.0.repo

Remplis le fichier avec le contenu suivant :

[mongodb-org-4.0]
name=MongoDB Repository
baseurl=https://repo.mongodb.org/yum/redhat/$releasever/mongodb-org/4.0/x86_64/
gpgcheck=1
enabled=1
gpgkey=https://www.mongodb.org/static/pgp/server-4.0.asc

Pour installer la dernière version stable du paquet MongoDB, lance la commande suivante :

sudo yum install -y mongodb-org

Vérifie la version de MongoDB :

mongo --version | head -n 1 && mongod --version | head -n 1
# MongoDB shell version v4.0.2
# db version v4.0.2

Démarre et active(configure-le pour qu’il démarre au redémarrage)le service MongoDB :

sudo systemctl start mongod.service
sudo systemctl enable mongod.service

Vérifie l’état du serveur de base de données MongoDB en l’exécutant :

sudo systemctl status mongod.service
# active (running)

Ensuite, crée la base de données MongoDB et l’utilisateur pour NodeBB.

Connecte-toi d’abord au serveur MongoDB.

mongo

Passe à la base de données intégréeadmin.

> use admin

Crée un utilisateur administratif.

> db.createUser( { user: "admin", pwd: "<Enter a secure password>", roles: [ { role: "readWriteAnyDatabase", db: "admin" }, { role: "userAdminAnyDatabase", db: "admin" } ] } )

REMARQUE :Remplace le caractère générique<Enter a secure password>par le mot de passe que tu as choisi.

Ajoute une nouvelle base de données appeléenodebb.

> use nodebb

La base de données sera créée et le contexte sera commuté surnodebb. Crée ensuite l’utilisateurnodebbavec les privilèges appropriés.

> db.createUser( { user: "nodebb", pwd: "<Enter a secure password>", roles: [ { role: "readWrite", db: "nodebb" }, { role: "clusterMonitor", db: "admin" } ] } )

REMARQUE :Encore une fois, remplace le caractère générique<Enter a secure password>par le mot de passe que tu as choisi.

Quitte le shell Mongo.

> quit()

Redémarre MongoDB et vérifie que l’utilisateur administratif créé précédemment peut se connecter.

sudo systemctl restart mongod.service
mongo -u admin -p your_password --authenticationDatabase=admin

Si tout s’est bien passé, ton MongoDB devrait être installé et préparé pour NodeBB. Dans l’étape suivante, nous nous occuperons de l’installation et de la configuration du serveur Web.

Étape 3 : Installe le client Acme.sh et obtiens un certificat Let’s Encrypt (facultatif)

Sécuriser ton forum NodeBB avec HTTPS n’est pas nécessaire, mais c’est une bonne pratique pour sécuriser le trafic de ton site. Pour obtenir un certificat SSL de Let’s Encrypt, nous allons utiliser le client Acme.sh. Acme.sh est un logiciel shell unix pur pour obtenir des certificats SSL de Let’s Encrypt sans aucune dépendance.

Télécharge et installe Acme.sh :

sudo mkdir /etc/letsencrypt
git clone https://github.com/Neilpang/acme.sh.git
cd acme.sh
sudo ./acme.sh --install --home /etc/letsencrypt --accountemail [email protected]
cd ~

Vérifie la version d’Acme.sh :

/etc/letsencrypt/acme.sh --version
# v2.8.0

Obtiens des certificatsRSAetECC/ECDSApour ton domaine/nom d’hôte :

# RSA 2048
sudo /etc/letsencrypt/acme.sh --issue --standalone --home /etc/letsencrypt -d forum.example.com --ocsp-must-staple --keylength 2048
# ECDSA
sudo /etc/letsencrypt/acme.sh --issue --standalone --home /etc/letsencrypt -d forum.example.com --ocsp-must-staple --keylength ec-256

Après avoir exécuté les commandes ci-dessus, tescertificatsetclésseront dans :

  • PourRSA:/etc/letsencrypt/forum.example.comrépertoire.
  • PourECC/ECDSA:/etc/letsencrypt/forum.example.com_eccrépertoire.

Étape 4 : Installe et configure Nginx

NodeBB peut fonctionner correctement avec de nombreux serveurs Web. Dans ce tutoriel, nous avons choisi Nginx.

Télécharge et importe d’abord la clé PGP du référentiel Nginx :

wget https://nginx.org/keys/nginx_signing.key
sudo rpm --import nginx_signing.key

Après avoir importé la clé, tu peux la retirer du disque en toute sécurité :

rm nginx_signing.key

Crée un/etc/yum.repos.d/nginx_mainline.repopour que tu puisses installer Nginx directement en utilisantyum:

sudo vim /etc/yum.repos.d/nginx_mainline.repo

Remplis le fichier avec le contenu suivant :

[nginx]
name=nginx repo
baseurl=https://nginx.org/packages/mainline/centos/7/$basearch/
gpgcheck=1
enabled=1

Enfin,pour installer la dernière version mainline du paquet Nginx, lance la commande suivante :

sudo yum install -y nginx

Après l’installation, tu peux vérifier la version de Nginx en exécutant :

nginx -v
# 1.15.3

Démarre et active(configure-le pour qu’il démarre au redémarrage) le service Nginx :

sudo systemctl start nginx.service
sudo systemctl enable nginx.service

Vérifie l’état du serveur Web Nginx en exécutant :

sudo systemctl status nginx.service
# active (running)

NodeBB fonctionne par défaut sur le port4567. Pour éviter de taperhttp://example.com:4567nous allons configurer Nginx comme un proxy inverse pour l’application NodeBB. Chaque requête sur le port80ou443(si SSL est utilisé) sera transmise au port4567.

Exécutesudo vim /etc/nginx/conf.d/nodebb.confet configure Nginx comme proxy inverse HTTPS.

server {
listen [::]:443 ssl http2;
listen 443 ssl http2;
listen [::]:80;
listen 80;

server_name forum.example.com;

client_max_body_size 50M;

# RSA
ssl_certificate /etc/letsencrypt/forum.example.com/fullchain.cer;
ssl_certificate_key /etc/letsencrypt/forum.example.com/forum.example.com.key;
# ECDSA
ssl_certificate /etc/letsencrypt/forum.example.com_ecc/fullchain.cer;
ssl_certificate_key /etc/letsencrypt/forum.example.com_ecc/forum.example.com.key;

location / {
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header Host $http_host;
proxy_set_header X-NginX-Proxy true;
proxy_pass http://127.0.0.1:4567;
proxy_redirect off;
# Socket.IO Support
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
}

}

Vérifie la configuration de Nginx :

sudo nginx -t

Enfin, pour que les changements prennent effet, nous devons recharger Nginx :

sudo systemctl reload nginx.service

Étape 5 : Installer et configurer NodeBB

Crée un répertoire racine de document dans lequel NodeBB doit résider :

sudo mkdir -p /var/www/nodebb

Accède au répertoire racine du document :

cd /var/www/nodebb

Change la propriété du/var/www/nodebbàton_utilisateur.

sudo chown -R [your_user]:[your_user] /var/www/nodebb

REMARQUE :Remplace ton_utilisateur dans la commande ci-dessus par ton utilisateur non racine que tu aurais dû créer comme prérequis pour ce tutoriel..

Clone le dernierdépôtNodeBB dans le dossier racine du document :

git clone -b v1.10.x https://github.com/NodeBB/NodeBB.git .

Lance le script d’installation en exécutant l’application avec l’attributsetupdrapeau :

./nodebb setup

Une fois l’installation de NodeBB terminée, exécute./nodebb startpour démarrer manuellement ton serveur NodeBB :

./nodebb start

Après avoir exécuté cette commande, tu devrais pouvoir accéder à ton tout nouveau forum dans ton navigateur Web :

NodeBB dans le navigateur

Étape 6 : Exécute NodeBB en tant que service système

Lorsqu’il est démarré via./nodebb start, NodeBB ne redémarrera pas automatiquement lorsque le système redémarrera. Pour éviter cela, nous devons configurer NodeBB comme un service système.

S’il est en cours d’exécution, arrête NodeBB :

./nodebb stop

Crée un nouvel utilisateurnodebb:

sudo useradd nodebb

Change la propriété du répertoire/var/www/nodebbà l’utilisateurnodebb:

sudo chown -R nodebb:nodebb /var/www/nodebb

Crée le fichier de configuration de l’unité systemdnodebb.service. Ce fichier d’unité gèrera le démarrage de NodeBB deamon. Exécutesudo vim /etc/systemd/system/nodebb.serviceet ajoute le contenu ci-dessous :

[Unit]
Description=NodeBB
Documentation=https://docs.nodebb.org
After=system.slice multi-user.target mongod.service

[Service]
Type=forking
User=nodebb

StandardOutput=syslog
StandardError=syslog
SyslogIdentifier=nodebb

Environment=NODE_ENV=production
WorkingDirectory=/var/www/nodebb
PIDFile=/var/www/nodebb/pidfile
ExecStart=/usr/bin/env node loader.js
Restart=always

[Install]
WantedBy=multi-user.target

NOTE :Définis le nom d'utilisateur et les chemins de répertoire en fonction des noms que tu as choisis.

Activenodebb.serviceau redémarrage et démarre immédiatementnodebb.service:

sudo systemctl enable nodebb.service
sudo systemctl start nodebb.service

Vérifie l'état denodebb.service:

sudo systemctl status nodebb.service
sudo systemctl is-enabled nodebb.service

Félicitations ! Tu as installé et déployé avec succès la plateforme de discussion NodeBB sur le serveur CentOS 7.

Liens

Vous aimerez aussi...