Installer Hexo på CentOS 7

Hexo er en statisk blogplatform, bygget med Node.js. Det er hurtigt sammenlignet med andre statiske blogplatforme, såsom Jekyll.

I denne tutorial vil jeg forklare, hvordan man bygger og implementerer en Hexo-blog. Trinnene er ret enkle, skrevet til CentOS 7, Node.js 4.4. Min lokale maskine er Fedora 23.

Forudsætninger

Vi starter med et nyinstalleret CentOS 7-system. Følgende softwarepakker er påkrævet:

• gcc-c og gcc-c++
• make og git
• nginx
• openssl
• nodejs og npm

Du skal logge ind som root eller som bruger med sudo-rettigheder.

Installer hjælpeprogrammer

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

Installer Nginx

Du kan installere nginxfra standard-repoen:

$yum install -y nginx

... eller installer en stabil version fra den officielle Nginx-repo, her vælger vi sidstnævnte.

Opret en repo-fil med navnet nginx.repo, hvoraf indholdet er:

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

... og kopier det til /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

Installer Node.js

Vi installerer den længe-understøttede Node.js fra den officielle Node.js-repo.

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

Opret en ny bruger

Typisk er det bedre at oprette en almindelig bruger til at køre din blog, fordi root har superbrugertilladelser.

Her opretter vi en bruger ved navn vultrog tilføjer den til gruppen wheelog nginx:

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

Generer et SSH-nøglepar

Det er nyttigt og nødvendigt at logge på via en ssh-nøgle.

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

Efter at have oprettet vores ssh-nøglepar, kopier den offentlige nøgle (normalt id_rsa.pub) til ~/.ssh/authorized_keyspå serveren:

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

Og nu har vi alle de præbyggede pakker installeret.

Byg din Hexo-blog

Installer Hexo

Log ind som vultrbruger. Opret derefter ~/web/web/vultrog ~/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

Indtast ~/web/web/vultr, og installer Hexo:

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

Nu mangler vi bare at lave vores nye blog.

Rediger for _config.ymlat ændre webadressen til din blog. Kør derefter:

$ hexo g

Din blog er nu blevet genereret. HTML-filerne er placeret under ~/web/web/vultr/public.

Konfigurer din Nginx-server

På nuværende tidspunkt kan vi stadig ikke få adgang til vores hjemmeside. Derfor skal vi konfigurere Nginx.

Nginx kører som en bruger navngivet nginxi nginxgruppen, og det er derfor, vi skal tilføje vultrtil gruppe nginx.

$ chown -R vultr:nginx ~/web

Opret en Nginx-konfigurationsfil navngivet vultr.confunder, ~/web/hvor indholdet er mere eller mindre som dette:

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;
    }
}

Kopier vultr.conftil /etc/nginx/config.d/og genstart Nginx:

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

Nu er vores blog tilgængelig med en webbrowser.

Brug af Git til at implementere din blog

Da bloggen allerede er konfigureret, er denne del af selvstudiet valgfri.

På dette tidspunkt er det lidt ubelejligt at skrive et blogindlæg, fordi vi skulle logge ind og skrive på serveren. En bedre løsning ville være at skrive på vores lokale maskine, skubbe posten ind på serveren og lade Hexo automatisk generere de statiske filer. I betragtning af at git har hooks, som kan mange ting, kan vi bruge en git-hook til at opnå denne opsætning.

Opret et blottet lager på serveren

Log ind på serveren igen som bruger vultr. Opret et blottet lager:

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

Skriv en bash-fil med navnet, post-receivesom vil implementere vores blog efter hvert tryk:

#!/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

Før implementeringen fungerer, skal vi også køre disse kommandoer på serveren:

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 .

Opsæt dit lokale git-lager

På den lokale maskine skal vi også oprette et lager. Disse trin kan variere, hvis du bruger et andet desktop-operativsystem end Fedora.

Du skal have git installeret.

Opsæt et lokalt git-lager:

$ 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

Det er nyttigt at installere Hexo på din lokale maskine for at skrive et indlæg. Her opsætter vi en Hexo-mappe til skrivning.

$ 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"

Opsætningen er fuldført. Du kan skubbe et indlæg til din server med følgende kommandoer:

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

Efter succes vil bloggen automatisk blive opdateret. Skål.