Installer Hexo sur CentOS 7

• Conditions préalables
• Créez votre blog Hexo
• Utiliser Git pour déployer votre blog

Hexo est une plateforme de blog statique, construite avec Node.js. C'est rapide par rapport à d'autres plateformes de blog statiques, comme Jekyll.

Dans ce tutoriel, je vais vous expliquer comment créer et déployer un blog Hexo. Les étapes sont assez simples, écrites pour CentOS 7, Node.js 4.4. Ma machine locale est Fedora 23.

Conditions préalables

Nous commençons avec un système CentOS 7 fraîchement installé. Les progiciels suivants sont requis:

• gcc-c et gcc-c ++
• faire et git
• nginx
• openssl
• nodejs et npm

Vous devrez vous connecter en tant que root ou en tant qu'utilisateur avec des privilèges sudo.

Installer les utilitaires

$ yum install -y gcc gcc-c++ make git openssl

Installer Nginx

Vous pouvez installer à nginxpartir du référentiel par défaut:

$yum install -y nginx

... ou installez une version stable du dépôt officiel Nginx, Ici, nous choisissons ce dernier.

Créez un fichier repo nommé nginx.repo, dont le contenu est:

[nginx]
name=nginx repo
baseurl=http://nginx.org/packages/mainline/centos/7/$basearch/
gpgcheck=0
enabled=1

... et copiez-le dans /etc/yum.repo.d/,

$ cp nginx.repo /etc/yum.repo.d/
$ yum update and yum install -y nginx
$ systemctl enable nginx and systemctl start nginx

Installez Node.js

Nous installons le Node.js pris en charge depuis longtemps à partir du dépôt Node.js officiel.

$ curl --silent --location https://rpm.nodesource.com/setup_4.x | bash -
$ yum update and yum install -y nodejs

Créer un nouvel utilisateur

En règle générale, il est préférable de créer un utilisateur ordinaire pour exécuter votre blog, car root dispose des autorisations de super-utilisateur.

Ici, nous créons un utilisateur nommé vultret l'ajoutons au groupe wheelet nginx:

$ useradd -d /home/vultr -m -r -U -s /bin/bash
$ passwd vultr
$ usermod -aG nginx vultr
$ usermod -aG wheel vultr

Générer une paire de clés SSH

Il est utile et nécessaire de se connecter via une clé ssh.

$ ssh-keygen -b 4096 -C "vultr@example.com"

Après avoir créé notre paire de clés ssh, copiez la clé publique (généralement id_rsa.pub) ~/.ssh/authorized_keyssur le serveur:

ssh-copy-id -i ~/.ssh/id_rsa.pub vultr@example.com

Et maintenant, nous avons tous les packages de pré-construction installés.

Créez votre blog Hexo

Installer Hexo

Connectez-vous en tant vultrqu'utilisateur. Ensuite, créez ~/web/web/vultret ~/web/git/vultr:

### This is our hexo blog root directory
$ mkdir -p ~/web/web/vultr
### This is our git repository directory on the server
$ mkdir -p ~/web/git/vultr
### This is our deploy directory
$ mkdir -p ~/web/git/hexo

Entrez ~/web/web/vultret installez Hexo:

$ cd ~/web/web/vultr
$ sudo npm install -g hexo-cli hexo-server
$ hexo init && npm install --save

Il ne nous reste plus qu'à créer notre nouveau blog.

Modifier _config.yml, pour changer l'URL de votre site de blog. Exécutez ensuite:

$ hexo g

Votre blog est maintenant généré. Les fichiers HTML se trouvent sous ~/web/web/vultr/public.

Configurez votre serveur Nginx

À ce stade, nous ne pouvons toujours pas accéder à notre site Web. Par conséquent, nous devons configurer Nginx.

Nginx s'exécute en tant qu'utilisateur nommé nginxdans le nginxgroupe, et c'est pourquoi nous devons ajouter vultrau groupe nginx.

$ chown -R vultr:nginx ~/web

Créez un fichier de configuration Nginx nommé vultr.confsous ~/web/lequel le contenu ressemble plus ou moins à ceci:

server {
    listen 80;
    listen [::]:80;
    ## if https is desired, please uncomment the following lines
    #listen 443 ssl http2;
    #listen [::]:443 ssl http2;

    server_name example.com, www.example.com;

    ## if forcing https, please uncomment the following lines
    #if ($scheme = http) {
    #    return 301 https://$server_name$request_uri;
    #}

    location / {
    root /home/vultr/web/web/vultr/public;
    index index.html;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header Host $http_host;
    ## if https is desired, please uncomment the following lines
    #proxy_set_header X-Forwarded-Proto https;
    }
}

Copier vultr.confvers /etc/nginx/config.d/et redémarrer Nginx:

$ sudo ln -sf ~/web/vultr.conf /etc/nginx/config.d/
$ sudo systemctl restart nginx

Maintenant, notre blog est accessible avec un navigateur Web.

Utiliser Git pour déployer votre blog

Le blog étant déjà configuré, cette partie du didacticiel est facultative.

À ce stade, il est un peu gênant d'écrire un article de blog, car nous aurions besoin de nous connecter et d'écrire sur le serveur. Une meilleure solution serait d'écrire sur notre machine locale, de pousser la publication sur le serveur et de laisser Hexo générer automatiquement les fichiers statiques. Considérant que git a des hooks qui peuvent faire beaucoup de choses, nous pouvons utiliser un git hook pour réaliser cette configuration.

Créer un référentiel nu sur le serveur

Connectez-vous à nouveau au serveur en tant qu'utilisateur vultr. Créez un référentiel nu:

$ cd ~/web/git/vultr
$ git init --bare
$ cd hooks

Écrivez un fichier bash nommé post-receivequi déploiera notre blog après chaque push:

#!/bin/bash
deploy_to_dir="/home/vultr/web/git/hexo"

GIT_WORK_TREE=$deploy_to_dir git checkout -f master
echo "DEPLOY:   master  copied to  $deploy_to_dir"

hexo_dir="/home/vultr/web/web/vultr/"

cd $hexo_dir

hexo clean && hexo --silent g

if [[ $? == 0 ]]; then
    echo "Congratulations! Your blog has been correctly deployed"
else:
    echo "Unfortunately your blog has not been deployed correctly"
fi

Avant que le déploiement ne fonctionne, nous devons également exécuter ces commandes sur le serveur:

cd ~/web/web/vultr/
rm -rf source scaffolds _config.yml themes
ln -sf /home/vultr/web/git/hexo/themes/tranquilpeak  themes/
ln -sf /home/vultr/web/git/hexo/source .
ln -sf /home/vultr/web/git/hexo/scaffolds .
ln -sf /home/vultr/web/git/hexo/_config.yml .

Configurez votre dépôt git local

Sur la machine locale, nous devons également créer un référentiel. Ces étapes peuvent varier si vous utilisez un système d'exploitation de bureau autre que Fedora.

Vous devrez avoir installé git.

Configurer un référentiel git local:

$ mkdir -p ~/vultr/git/vultr`
$ cd ~/vultr/git/vultr and git init
$ git remote add production ssh://vultr@example.com:/home/vultr/web/git/vultr

Il est utile d'installer Hexo sur votre machine locale pour écrire un article. Ici, nous configurons un répertoire Hexo pour l'écriture.

$ mkdir ~/vultr/vultr && cd ~/vultr/vultr
$ hexo init && npm install --save
$ mv  source  _config.yml themes scaffolds ~/vultr/git/vultr
$ ln -sf ~/vultr/git/vultr/source .
$ ln -sf ~/vultr/git/vultr/_config.yml .
$ ln -sf ~/vultr/git/vultr/scaffolds .
$ hexo new "Test Post"

La configuration est terminée. Vous pouvez envoyer une publication sur votre serveur avec les commandes suivantes:

$ cd ~/vultr/git/vultr
$ git add . && git commit -m "new post"
$ git push production master

En cas de succès, le blog sera automatiquement mis à jour. À votre santé.