Comment déployer Wiki.js sur un hébergement Simple Hosting

Ce guide vous accompagnera dans l’installation de Wiki.js sur une instance Simple Hosting Node.js.

Qu’est-ce que Wiki.js ?

Wiki.js est un CMS/SGC de type Wiki, open-source écrit en JavaScript et tournant sous Node.Js.

Vous aurez plus d’info sur le site officiel, et vous pouvez consulter (et re-consulter) la documentation indispensable ici

Prérequis

Vous aurez des éléments suivants durant le tutoriel :

  • Une instance Simple Hosting utilisant Node.js et PostgreSQL

  • Un nom de domaine que vous allez lier à votre instance

  • Un terminal avec git et ssh installés

  • Les sources wiki.js

Créez un hébergement Web NodeJS / PostgreSQL

Il vous faudra tout d’abord créer une instance Simple Hosting Node.Js et PostgreSQL (sauf si vous en possédez déjà une, bien sûr).

  1. Connectez vous à votre compte Gandi, puis rendez-vous dans la rubrique « « SIMPLE HOSTING ».

  2. Cliquez sur « Créer ».

  3. Choisissez « Configuration personnalisée »

  4. Sous « Langage », choisissez langage NodeJS.

  5. Sous « Base de données » et Base de donnée PostgreSQL.

  6. Pour le reste, choisissez les options que vous souhaitez.

  7. En bas de la page choisissez « Ajouter au panier », puis complétez le processus d’achat.

Vous pouvez trouver une documentation plus précise à cette adresse : https://docs.gandi.net/fr/simple_hosting/gestion_instance/creation.html

Créez le site sur votre hébergement

Cette étape préalable est indispensable pour configurer le serveur web et le webaccélérateur.

Pour cela :

  1. Rendez-vous dans le menu Simple Hosting.

  2. Cliquez sur le nom de l’instance que vous désirez utiliser (cela peut être celle que vous venez de créer, ou une instance Node.JS / PostgreSQL que vous avez créé précédemment).

  3. Rendez-vous dans l’onglet « Sites », et cliquez ensuite sur « Débuter » ou « Créer un site ».

  4. Saisissez l’adresse web (ou URL) du site que vous désirez créer. Par exemple, vous pouvez utiliser quelque chose comme « wiki.mondomaine.fr ».

Attention

Assurez-vous de bien saisir votre domaine, car une erreur de frappe rendrait votre site inaccessible.

Vous pouvez trouver une descritpion plus détaillée de cette procédure sur cette page : https://docs.gandi.net/fr/simple_hosting/operations_courantes/lier_son_domaine.html

Créez une la base de donnée

Depuis l’interface PgMyAadmin

  1. Connectez vous à votre compte Gandi (si ce n’est déjà fait), puis « SIMPLE HOSTING ».

  2. Cliquez sur le nom de l’instance que vous voulez utiliser.

  3. Cliquez sur l’onglet « Administration ».

  4. Dans la rubrique Base de données, cliquez sur « Aller sur phpPgAdmin ».

  5. Entrez l’identifiant et le mot de passe de l’instance pour accéder à la connexion de l’administration de DB.

  6. Cliquez ensuite sur le lien « phpPgAdmin » et connectez vous si nécessaire.

  7. Cliquez sur “postgreSQL” dans le panneau de gauche.

L’accès « par défaut » à phpPgAdmin a pour utilisateur « hosting-db » et aucun mot de passe défini (voir ).

L’URL est de la forme : https​:​//xxxx.admin.yy.gpaas.net (ou xxxx est l’identifiant de votre hébergement, et yy la localisation)

Vous pouvez alors vous connecter avec l’identifiant hosting-db, sans mot de passe (par défaut)

Créez un utilisateur :

  1. Cliquez sur l’onglet « Rôles », puis sur « Créer un rôle ».

  2. Saisissez le nom de l’utilisateur, puis le mot de passe que vous souhaitez utiliser pour votre wiki.

  3. Cochez l’option « Peut se connecter ? », puis cliquez sur le bouton « Créer » en bas de page.

Créez ensuite une base de donnée :

  1. Cliquez sur l’onglet “Bases de données”, puis sur « Créer une base de données »

  2. Entrez le nom, laissez les options par défaut, cliquez sur le bouton « créer »

  3. A droite de la ligne correspondant, cliquez sur le bouton “Droits”

  4. Puis sur « Accorder (GRANT) »

  5. Sélectionnez l’utilisateur, puis cochez dans “droits” : ALL PRIVILEGES

Récupération des fichiers source de l’application

Connectez vous à la console SSH de votre Simple Hosting;

$ cd /srv/data/web/vhosts/mondomain.fr/default
$ wget https://github.com/Requarks/wiki/releases/latest/download/wiki-js.tar.gz
$ tar xvf wiki-js.tar.gz
$ rm wiki-js.tar.gz
$ mv config.sample.yml config.yml

Explications : - on se place dans le répertoire du site, - on télécharge la dernière release de wiki.js, - on extrait les fichiers « sources », - on renomme le fichier de config d’exemple.

Adaptez le fichier de configuration

Éditez alors ce fichier config.yml, et adaptez les lignes suivantes :

# ---------------------------------------------------------------------
# Port the server should listen to
# ---------------------------------------------------------------------

port: 8080

# ---------------------------------------------------------------------
# Database
# ---------------------------------------------------------------------

db:
 type: postgres

 # PostgreSQL / MySQL / MariaDB / MS SQL Server only:
 host: localhost
 port: 5432
 user: UTILISATEUR
 pass: PASSWORD
 db: BASE
 ssl: false

UTILISATEUR, PASSWORD et BASE correspondent à ceux que vous avez créé précédemment, bien évidemment.

Après avoir modifié vos paramètres, sauvegardez et fermez le fichier.

Finalisez l’installation

Relancez Node :

Depuis le panneau d’administration de votre instance :

  1. Connectez vous à la gestion de votre instance (SIMPLE HOSTING > votre instance)

  2. Rendez-vous dans la rubrique « Administration »

#. Recherchez le bloc «  » (Votre instance > Administration > Panneau de contrôle : Accès), et sous l’encart “Node.js” cliquez sur « Reload application »

Exécutez l’installateur Web:

Connectez vous depuis votre navigateur à l’URL de votre site, et complétez l’assistant d’installation en suivant les instructions données à l’écran.

Note

Si la page affiche avant le rechargement une erreur 500, relancez node depuis le panneau d’admin et rechargez l’URL de votre site.

Hauts les coeurs, votre Wiki est en ligne ! Maintenant, rendez vous sur la documentation officielle pour en maîtriser l’utilisation :)

Mettez votre version à jour

  • connectez vous à la console SSH de votre hébergement

  • placez vous dans le dossier racine de votre site

  • sauvegardez votre fichier de configuration

  • récupérez l’archive

  • décompressez la

  • restaurez le fichier de config

cd /srv/data/web/vhosts/MONSITE/default
cp config.yml ~/config.yml.back
wget https://github.com/Requarks/wiki/releases/latest/download/wiki-js.tar.gz
tar xvf wiki-js.tar.gz
rm wiki-js.tar.gz
cp ~/config.yml.back config.yml

Note

MONSITE correspond au nom/URL de votre site… à adapter donc, bien entendu ;)

Il est fortement recommandé de redémarrer votre instance après la mise à jour, de préférence à recharger l’application.