Comment déployer un blog Ghost sur un hébergement Simple Hosting ?

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

Qu’est-ce que Ghost ?

Ghost est une plateforme de blogage libre et à code source ouvert. Ce CMS est écrit en JavaScript et distribuée sous licence MIT, et conçu pour simplifier la publication pour les blogueurs ainsi que la mise en ligne de contenu.

Prérequis

Pour déployer Ghost, vous aurez besoin de :

  • Une instance Simple Hosting utilisant Node.js et MySQL
  • Un nom de domaine que vous allez lier à votre instance
  • Un accès à un terminal avec git et ssh installés.

Création d’un site sur votre instance Simple Hosting

La première étape est de créer un site sur votre instance Simple Hosting. Faites cela en vous rendant dans le menu Simple Hostin.

Cliquez ensuite sur le nom de l’instance que vous désirez utiliser pour l’installation de votre blogue Ghost.

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

Saisissez le nom du site que vous désirez créer. Par exemple, vous pouvez utiliser quelque chose comme « blogue.exemple.fr ».

Attention

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

Une fois le nom de votre site saisi, notre système va vérifier que vous disposez des droits requis sur le domaine. Si vous utilisez LiveDNS comme serveurs de noms, cela ne devrait prendre que quelques seconde. Sinon, vous devrez passer par la validation à l’aide de l’enregistrement TXT qui vous sera communiqué pour valider vos droits sur le domaine.

Lorsque vos droits sur le domaine seront validés, cliquez sur « Activer maintenant » pour publier votre site.

Enfin, vous pouvez confirmer que votre site est bien en ligne en vous rendant à l’adresse définie plus tôt, comme blogue.exemple.fr. Vous devriez voir une page qui affiche « It works… ».

Création d’une base de données pour le blog Ghost

Vous devez maintenant créer la base de données qui sera utilisée par Ghost.

Pour cela, rendez-vous dans l’onglet « Administration » de votre instance Simple Hosting.

Dans la section « Base de données », cliquez sur « Aller à phpMyAdmin » pour gérer vos bases de données.

Lorsque vous ouvrez phpMyADmin, il vous sera demandé de vous authentifier à l’aide de votre nom d’utilisateur et votre mot de passe d’administration de votre instance. - Le nom d’utilisateur est une série de chiffres qui a été automatiquement générée lorsque vous avez créé votre instance. Vous pouvez retrouver celui-ci en haut de la page « Administration » de votre instance, celle où vous avez trouvé le lien pour vous connecter à phpMyAdmin. - Le mot de passe a été défini lorsque vous avez créé votre instance. Si vous ne vous en souvenez plus, vous pouvez le modifier depuis l’onglet « Sécurité ».

Lorsque vous accédez à phpMyAdmin, vous devrez vous authentifier à l’aide du nom d’utilisateur et du mot de passe de votre base de données. Ces identifiants sont différents des identifiants d’administration de votre instance. Par défaut, le nom d’utilisateur est « root » et le mot de passe est vide.

Une fois connecté à phpMyAdmin, cliquez sur « Bases de données ». En haut de cette page, vous trouverez un champs de saisie pour créer une nouvelle base de données. Donnez un nom à la base de données destinée à Ghost, comme « ghost_db » par exemple, et cliquez sur « Créer ». Notez bien le nom que vous avez donné à votre base de données, car vous en aurez besoin pour la configuration de Ghost.

Récupération des sources de Ghost et configuration de votre dépôt git

Depuis votre ordinateur, en local, créez un nouveau répertoire pour votre blog Ghost, et téléchargez sa dernière version.

$ mkdir ghost_blog && cd ghost_blog/
$ wget https://github.com/TryGhost/Ghost/releases/download/3.23.0/Ghost-3.23.0.zip
$ unzip Ghost-3.23.0.zip
$ rm Ghost-3.23.0.zip

Ensuite, récupérez les informations de déploiement pour votre instance Simple Hosting. Ces informations vous sont données en suivant ce chemin « Simple Hsoting -> Votre instance -> Sites -> blogue.exemple.fr -> Déployer avec git ».

En local, sur votre ordinateur, placez-vous dans le répertoire de votre projet et initialisez le dépôt git :

$ git init

Exécutez ensuite la commande de « Configuration à distance » que vous avez récupérée plus tôt, et qui ressemble à ceci :

$ git remote add gandi git+ssh://{instance_id}@git.{datacenter_id}.gpaas.net/default.git

Édition du fichier config.production.json

Utilisez votre éditeur de texte préféré pour éditer le fichier core/shared/config/env/config.production.json.

Assurez-vous de bien indiquer l’adresse de votre site, une adresse email valide dans le champs FROM, et le nom de votre base de données (par exemple ghost_db).

Vous pouvez utiliser le modèle ci-dessous, sur lequel nous vous recommandons de vous baser car celui-ci indique la bonne valeur pour socketPath pour une instance Simple Hosting, ainsi que le bon port :

{
 "url": "http://blog.exemple.fr",
 "server": {
     "port": 8080
 },
 "mail": {
     "from":"me@exemple.fr"
 },
 "database": {
     "client": "mysql",
     "connection": {
         "socketPath"     : "/srv/run/mysqld/mysqld.sock",
         "user"     : "root",
         "password" : "",
         "database" : "ghost_db"
     }
 },
 "paths": {
     "contentPath": "content/"
 },
 "logging": {
     "level": "info",
     "rotation": {
         "enabled": true
     },
     "transports": ["file", "stdout"]
 }
}

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

Commit, push, et deploy

Faites un commit et un push du code vers votre dépôt git :

$ git add .
$ git commit -am 'first commit of ghost blog'
$ git push gandi master

Déployé ensuite votre code en utilisant la commande « Déployer » que vous avez récupérée plus tôt, et qui ressemble à ceci :

$ ssh {instance_id}@git.{datacenter_id}.gpaas.net deploy default.git

Le déploiement va prendre une à deux minutes pour aboutir.

Félicitations ! Votre blog Ghost est en ligne. Vous pouvez vous rendre à l’adresse http://{votre site}/ghost/#/setup/one (par exemple http://blogue.exemple.fr/ghost/#/setup/one) pour configurer votre compte administrateur.