Comment déployer Wiki.js sur un Hébergement Web Gandi

Ce guide vous accompagnera dans l’installation de Wiki.js sur un Hébergement Web 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 :

  • un Hébergement Web utilisant Node.js et PostgreSQL

  • Un nom de domaine que vous allez lier à votre hébergement

  • 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 un Hébergement WebNode.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 « « HEBERGEMENT WEB ».

  2. Cliquez sur « Créer ».

  3. Choisissez un hébergement (de préférence d’une taille supérieure à « STARTER »).

  4. Choisissez « Configuration à la carte »

  5. Sous « Langage », choisissez langage NodeJS.

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

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

  8. En bas de la page choisissez « Continuer », puis complétez le processus d’achat.

Vous pouvez trouver une documentation plus précise à cette adresse : https://docs.gandi.net/fr/hebergement_web/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 Hébergement Web.

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

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

  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/hebergement_web/operations_courantes/lier_son_domaine.html

Créez une base de donnée

Depuis l’interface PgMyAadmin

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

  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 Hébergement Web Gandi;

$ 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

Où 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 (Hébergement Web > 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.