Dans ce tutoriel, nous couvrirons les étapes nécessaires à l'installation de Wekan sur un VPS Debian 9.
Wekan est un tableau Kanban gratuit, flexible et open source. Avec Wekan, nous pouvons créer des tableaux et des cartes qui peuvent être déplacés entre plusieurs colonnes. Wekan vous permet d'inviter des membres au conseil d'administration et d'attribuer des tâches à un membre spécifique. Cela maximise la productivité d'une équipe, car chaque membre peut voir exactement où en sont toutes les tâches et se concentrer sur les tâches en fonction de leur priorité. Le processus d'installation ne prendra pas longtemps, alors commençons par l'installation.
Prérequis
- Pour les besoins de ce didacticiel, nous utiliserons un VPS Debian 9.
- Au moins 1 Go de RAM libre pour Wekan. Un serveur de production doit disposer d'au moins 4 Go de RAM.
- Un accès SSH complet à l'aide du compte root ou d'un utilisateur disposant des privilèges sudo est également requis.
Étape 1 :Premiers pas
Connectez-vous à votre serveur via SSH en tant qu'utilisateur root à l'aide de la commande suivante :
ssh root@IP_ADDRESS -p PORT_NUMBER
et remplacez "IP_ADDRESS" et "PORT_NUMBER" par l'adresse IP réelle de votre serveur et le numéro de port SSH. Remplacez "root" par le nom d'utilisateur d'un autre compte si nécessaire.
Avant de commencer l'installation, vous devrez mettre à jour vos packages système vers leurs dernières versions.
Vous pouvez le faire en exécutant la commande suivante :
apt-get update apt-get upgrade
Étape 2 :Installez Node.js
Sur les systèmes Debian, vous pouvez installer Node.js depuis le dépôt NodeSource :
$ apt-get update $ apt install curl git gcc g++ make
Après cela, installez le référentiel Node.js avec la commande suivante
$ curl -sL https://deb.nodesource.com/setup_12.x | sudo -E bash -
Après cela, exécutez les commandes ci-dessous pour installer Node.js :
$ apt-get install nodejs
Étape 3 :Vérifiez la version de Node.js
Une fois l'installation terminée, vérifiez et vérifiez la version installée de Node.js et NPM. Vous pouvez trouver plus de détails sur la version actuelle sur le site officiel de Node.js.
$ node -v v12.2.0
Vérifiez également la version de NPM.
$ npm -v 6.9.0
S'il s'agit des versions indiquées ci-dessus ou plus récentes, vous pouvez passer à l'étape suivante.
Étape 4 :Installez le serveur de base de données MongoDB
MongoDB est le serveur de base de données par défaut pour Wekan. Démarrez l'installation en important la clé publique utilisée par le système de gestion des packages.
$ apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 9DA31620334BD75D9DCB49F368818C72E52529D4
Ajoutez le dépôt MongoDB :
echo "deb http://repo.mongodb.org/apt/debian stretch/mongodb-org/4.0 main" | sudo tee /etc/apt/sources.list.d/mongodb-org-4.0.list
Mettez à jour l'index du package apt et installez le serveur MongoDB :
$ apt-get update $ apt-get install -y mongodb-org
Démarrez le service MongoDB :
$ systemctl start mongod.service $ systemctl enable mongod.service
Vérifiez l'installation de MongoDB. Vous devez avoir la version 4.0 ou ultérieure :
$ mongod --version
db version v4.0.9
git version: fc525e2d9b0e4bceff5c2201457e564362909765
OpenSSL version: OpenSSL 1.1.0j 20 Nov 2018
allocator: tcmalloc
modules: none
build environment:
distmod: debian92
distarch: x86_64
target_arch: x86_64
Étape 5 :Configurer MongoDB
Nous devons configurer l'authentification MongoDB. Nous allons nous connecter au shell mongo et créer un nouveau superutilisateur « admin ». Connectez-vous à MongoDB en exécutant la commande suivante :
mongo
Passez ensuite à l'administrateur de la base de données et créez un nouvel utilisateur administrateur :
use admin
Nous allons exécuter la requête Mongo ci-dessous pour créer un nouvel utilisateur administrateur avec un mot de passe et définir le rôle en tant que root.
db.createUser(
{
user: "admin",
pwd: "MyAdminPassword",
roles: [ { role: "root", db: "admin" } ]
}
) Assurez-vous de remplacer "MyAdminPassword" par un mot de passe fort.
L'utilisateur Admin a maintenant été créé.
Redémarrez le service MongoDB et l'authentification MongoDB devrait être activée.
systemctl restart mongod
Nous devons créer une nouvelle base de données nommée "wekan" avec l'utilisateur "wekan" avec le mot de passe "StrongPassword". Modifiez le mot de passe en conséquence.
Connectez-vous au shell mongo en tant qu'utilisateur administrateur.
mongo -u admin -p
Dans le shell Mongo, nous exécuterons les requêtes suivantes :
use wekan
db.createUser(
{
user: "wekan",
pwd: "StrongPassword",
roles: ["readWrite"]
}
) Nous avons créé avec succès une base de données et un utilisateur pour l'installation de Wekan.
Étape 6 :Installer Wekan
Commençons par créer un wekan user afin que root n'exécute pas votre application Wekan.
$ adduser wekan --disabled-login --no-create-home
Nous nous connecterons en tant qu'utilisateur "wekan".
$ su - wekan
Nous allons télécharger la dernière version du code source wekan à l'aide de la commande wget et l'extraire.
$ wget https://github.com/wekan/wekan/releases/download/v0.63/wekan-0.63.tar.gz $ tar xf wekan-0.63.tar.gz
Nous ferons également en sorte que notre nouvel utilisateur possède tous les répertoires d'installation de Wekan afin qu'il puisse les exécuter sans aucun problème :
$ chown -R wekan:wekan /opt/bundle
Nous allons aller dans ce répertoire et installer les dépendances Wekan à l'aide de la commande "npm".
$ cd /opt/bundle/programs/server $ npm install
Nous allons maintenant exécuter les commandes suivantes pour créer les variables d'environnement pour l'application Wekan.
$ export MONGO_URL='mongodb://wekan:[email protected]:27017/wekan?authSource=wekan' $ export ROOT_URL='http://your_ip_address/' $ export MAIL_URL='smtp://user:pass@your_domain.com:25/' $ export MAIL_FROM='wekan@your_domain.com' $ export PORT=8000
Nous allons aller dans le répertoire "bundle" et exécuter l'application Wekan Node.js.
$ cd /opt/bundle $ node main.js
Wekan a été installé avec succès et il écoute sur le port 8000.
Étape 7 :Configurer le service Wekan SystemD
Vous avez maintenant Wekan opérationnel, mais il cessera de fonctionner une fois que vous aurez fermé la session du terminal. Pour éviter cela, nous devons créer un service SystemD afin qu'il soit exécuté par le système plutôt que par l'utilisateur.
Créez un fichier nommé wekan.service dans /etc/systemd/system/ , en utilisant votre éditeur de texte préféré :
$ cd /etc/systemd/system/ $ nano wekan.service
Collez le contenu suivant :
[Unit] Description=Wekan Server After=syslog.target After=network.target [Service] Type=simple Restart=always StandardOutput=syslog SyslogIdentifier=Wekan User=wekan Group=wekan Environment=MONGO_URL=mongodb://127.0.0.1:27017/wekan Environment=ROOT_URL=https://example.com Environment=PORT=8000 Environment=MAIL_URL=smtp://user:[email protected]:25/ WorkingDirectory=/opt/bundle ExecStart=/usr/bin/node /opt/bundle/main.js [Install] WantedBy=multi-user.target
Assurez-vous de remplacer ‘example.com‘ par votre nom de domaine enregistré. Enregistrez et fermez le fichier.
Pour informer le SystemD de ce nouveau fichier, exécutez la commande suivante :
$ systemctl daemon-reload
Démarrez le service Wekan et activez-le.
$ systemctl start wekan $ systemctl enable wekan
Étape 8 :Accéder à Wekan
Ouvrez votre navigateur Web préféré et saisissez l'URL http://your_ip_address:8000 . Nous serons redirigés vers la page de connexion Wekan.
C'est ça. Si vous avez bien suivi toutes les instructions, vous devriez maintenant pouvoir accéder à votre installation Wekan sur votre serveur Debian 9.
Bien sûr, vous n'êtes pas obligé de je ninstallez Wekan sur Debian 9 si vous avez un VPS Debian avec nous. Si vous, vous pouvez installer Wekan sur votre serveur en demandant simplement à notre équipe d'assistance d'installer Wekan sur Debian 9 pour vous. Ils sont disponibles 24h/24 et 7j/7 et pourront vous aider dans l'installation.
PS . Si vous avez apprécié la lecture de cet article de blog sur l'installation de Wekan sur Debian 9, n'hésitez pas à le partager sur les réseaux sociaux en utilisant les raccourcis de partage, ou simplement à laisser un commentaire dans la section des commentaires. Merci.