Comment déployer un blog Ghost sur un Hébergement Web Gandi ?
Ce guide vous accompagnera dans l’installation de Ghost sur une instance Hébergement Web 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 :
un Hébergement Webutilisant 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 Hébergement Web Gandi
La première étape est de créer un site sur votre Hébergement Web Gandi. Faites cela en vous rendant dans le menu HEBERGEMENT WEB.
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 « Créer ».
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 Hébergement Web Gandi.
Dans la section « Base de données », cliquez sur « Aller sur 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 champ 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 Hébergement Web Gandi. 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 :
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 E-mail 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 un Hébergement Web Gandi, 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.
Comment déployer un blog Ghost sur un Hébergement Web Gandi ?¶
Ce guide vous accompagnera dans l’installation de Ghost sur une instance Hébergement Web 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 :
un Hébergement Webutilisant 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 Hébergement Web Gandi¶
La première étape est de créer un site sur votre Hébergement Web Gandi. Faites cela en vous rendant dans le menu HEBERGEMENT WEB.
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 « Créer ».
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 Hébergement Web Gandi.
Dans la section « Base de données », cliquez sur « Aller sur 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 champ 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.
Ensuite, récupérez les informations de déploiement pour votre Hébergement Web Gandi. 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 :
É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 E-mail 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 un Hébergement Web Gandi, ainsi que le bon port :
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 :
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 :
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.