Asenna Hexo CentOS 7:ään

Hexo on staattinen blogialusta, joka on rakennettu Node.js:n avulla. Se on nopea verrattuna muihin staattisiin blogialustoihin, kuten Jekylliin.

Tässä opetusohjelmassa selitän, kuinka Hexo-blogi luodaan ja otetaan käyttöön. Vaiheet ovat melko yksinkertaisia, kirjoitettu CentOS 7:lle, Node.js 4.4:lle. Paikallinen koneeni on Fedora 23.

Edellytykset

Aloitamme juuri asennetulla CentOS 7 -järjestelmällä. Seuraavat ohjelmistopaketit vaaditaan:

• gcc-c ja gcc-c++
• tee ja git
• nginx
• openssl
• nodejs ja npm

Sinun on kirjauduttava sisään pääkäyttäjänä tai käyttäjänä, jolla on sudo-oikeudet.

Asenna apuohjelmat

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

Asenna Nginx

Voit asentaa nginxoletusreposta:

$yum install -y nginx

... tai asenna vakaa versio virallisesta Nginx reposta, tässä valitsemme jälkimmäisen.

Luo repo-tiedosto nimeltä nginx.repo, jonka sisältö on:

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

... ja kopioi se osoitteeseen /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

Asenna Node.js

Asennamme pitkään tuetun Node.js:n virallisesta Node.js-varastosta.

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

Luo uusi käyttäjä

Yleensä on parempi luoda tavallinen käyttäjä ylläpitämään blogia, koska rootilla on superkäyttäjän oikeudet.

Täällä luomme käyttäjän nimeltä vultrja lisäämme sen ryhmään wheelja nginx:

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

Luo SSH-avainpari

On hyödyllistä ja tarpeellista kirjautua sisään ssh-avaimella.

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

Kun olet luonut ssh-avainparimme, kopioi julkinen avain (yleensä id_rsa.pub) ~/.ssh/authorized_keyspalvelimelle:

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

Ja nyt meillä on kaikki esirakennuspaketit asennettuna.

Rakenna Hexo-blogisi

Asenna Hexo

Kirjaudu sisään vultrkäyttäjänä. Luo sitten ~/web/web/vultrja ~/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

Kirjoita ~/web/web/vultrja asenna Hexo:

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

Nyt meidän on vain luotava uusi blogi.

Muokkaa _config.yml, jos haluat muuttaa blogisivustosi URL-osoitetta. Sitten juokse:

$ hexo g

Blogisi on nyt luotu. HTML-tiedostot sijaitsevat alla ~/web/web/vultr/public.

Asenna Nginx-palvelin

Tässä vaiheessa emme vieläkään voi käyttää verkkosivustoamme. Siksi meidän on määritettävä Nginx.

Nginx toimii kuten käyttäjä nimeltä nginxvuonna nginxryhmässä, ja siksi meidän täytyy lisätä vultrryhmään nginx.

$ chown -R vultr:nginx ~/web

Luo Nginx config tiedosto nimeltä vultr.confnojalla ~/web/, joiden sisältö on enemmän tai vähemmän kuin tämä:

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

Kopioi vultr.confja /etc/nginx/config.d/ja käynnistä Nginx:

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

Nyt blogimme on luettavissa verkkoselaimella.

Gitin käyttäminen blogisi käyttöönottoon

Koska blogi on jo määritetty, tämä opetusohjelman osa on valinnainen.

Tässä vaiheessa blogikirjoituksen kirjoittaminen on hieman hankalaa, koska meidän pitäisi kirjautua sisään ja kirjoittaa palvelimelle. Parempi ratkaisu olisi kirjoittaa paikallisella koneellamme, työntää viesti palvelimelle ja antaa Hexon luoda automaattisesti staattiset tiedostot. Koska gitissä on koukkuja, jotka voivat tehdä monia asioita, voimme käyttää git-koukkua tämän asennuksen saavuttamiseksi.

Luo paljas arkisto palvelimelle

Kirjaudu palvelimelle uudelleen käyttäjänä vultr. Luo paljas arkisto:

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

Kirjoita bash-tiedosto, post-receivejoka ottaa blogimme käyttöön jokaisen työntökerran jälkeen:

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

Ennen kuin käyttöönotto toimii, meidän on myös suoritettava nämä komennot palvelimella:

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 .

Määritä paikallinen git-arkisto

Paikallisella koneella meidän on myös luotava arkisto. Nämä vaiheet voivat vaihdella, jos käytät muuta työpöytäkäyttöjärjestelmää kuin Fedoraa.

Sinulla tulee olla git asennettuna.

Aseta paikallinen git-arkisto:

$ 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

On hyödyllistä asentaa Hexo paikalliselle koneellesi viestin kirjoittamista varten. Täällä asetamme Hexo-hakemiston kirjoittamista varten.

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

Asennus on valmis. Voit työntää viestin palvelimellesi seuraavilla komennoilla:

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

Onnistuessaan blogi päivittyy automaattisesti. Kippis.