Settu upp Hexo á CentOS 7

Hexo er kyrrstæður bloggvettvangur, byggður með Node.js. Það er hratt miðað við aðra kyrrstæða bloggvettvang, eins og Jekyll.

Í þessari kennslu mun ég útskýra hvernig á að byggja upp og dreifa Hexo bloggi. Skrefin eru frekar einföld, skrifuð fyrir CentOS 7, Node.js 4.4. Staðbundna vélin mín er Fedora 23.

Forkröfur

Við byrjum á nýuppsettu CentOS 7 kerfi. Eftirfarandi hugbúnaðarpakkar eru nauðsynlegar:

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

Þú þarft að skrá þig inn sem rót, eða sem notandi með sudo réttindi.

Settu upp tól

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

Settu upp Nginx

Þú getur sett upp nginxfrá sjálfgefna endurgeymslunni:

$yum install -y nginx

... eða settu upp stöðuga útgáfu frá opinberu Nginx endurhverfum, hér veljum við hið síðarnefnda.

Búðu til endursöluskrá sem heitir nginx.repo, þar sem innihaldið er:

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

... og afritaðu það 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

Settu upp Node.js

Við setjum upp Node.js sem hefur verið studd til lengri tíma frá opinberu Node.js endurhverfunni.

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

Búðu til nýjan notanda

Venjulega er betra að búa til venjulegan notanda til að keyra bloggið þitt, því root hefur ofurnotendaheimildir.

Hér búum við til notanda sem heitir vultrog bætum honum við hópinn wheelog nginx:

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

Búðu til SSH lyklapar

Það er gagnlegt og nauðsynlegt að skrá sig inn með ssh lykli.

$ ssh-keygen -b 4096 -C "[email protected]"

Eftir að hafa búið til ssh lyklaparið okkar, afritaðu opinbera lykilinn (venjulega id_rsa.pub) ~/.ssh/authorized_keysá netþjóninn:

ssh-copy-id -i ~/.ssh/id_rsa.pub [email protected]

Og nú erum við með alla forsmíðapakkana uppsetta.

Byggðu upp Hexo bloggið þitt

Settu upp Hexo

Skráðu þig inn sem vultrnotandi. Síðan skaltu búa til ~/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

Sláðu inn ~/web/web/vultrog settu upp Hexo:

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

Nú er bara að búa til nýja bloggið okkar.

Breyta _config.yml, til að breyta vefslóð bloggsíðunnar þinnar. Þá keyra:

$ hexo g

Bloggið þitt hefur nú verið búið til. HTML skrárnar eru staðsettar undir ~/web/web/vultr/public.

Settu upp Nginx netþjóninn þinn

Á þessum tímapunkti höfum við enn ekki aðgang að vefsíðunni okkar. Þess vegna þurfum við að stilla Nginx.

Nginx keyrir sem notandi sem heitir nginxí nginxhópnum og þess vegna þurfum við að bæta vultrvið hópinn nginx.

$ chown -R vultr:nginx ~/web

Búðu til Nginx stillingarskrá sem heitir vultr.confundir ~/web/þar sem innihaldið er nokkurn veginn svona:

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

Afritaðu vultr.confí /etc/nginx/config.d/og endurræstu Nginx:

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

Nú er bloggið okkar aðgengilegt með vafra.

Notaðu Git til að dreifa blogginu þínu

Þar sem bloggið er þegar uppsett er þessi hluti kennslunnar valfrjáls.

Á þessum tímapunkti er svolítið óþægilegt að skrifa bloggfærslu, því við þyrftum að skrá okkur inn og skrifa á netþjóninn. Betri lausn væri að skrifa á staðbundna vélina okkar, ýta færslunni inn á netþjóninn og láta Hexo búa til kyrrstöðuskrárnar sjálfkrafa. Miðað við að git hafi króka sem geta gert margt, þá getum við notað git krók til að ná þessari uppsetningu.

Búðu til lausa geymslu á þjóninum

Skráðu þig aftur inn á netþjóninn sem notandi vultr. Búðu til lausa geymslu:

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

Skrifaðu bash skrá sem heitir post-receivesem mun birta bloggið okkar eftir hverja ýtingu:

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

Áður en uppsetningin virkar þurfum við líka að keyra þessar skipanir á þjóninum:

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 .

Settu upp staðbundna git geymsluna þína

Á staðbundinni vél þurfum við líka að búa til geymslu. Þessi skref geta verið breytileg ef þú ert að nota skrifborðsstýrikerfi annað en Fedora.

Þú verður að hafa git uppsett.

Settu upp staðbundna git geymslu:

$ mkdir -p ~/vultr/git/vultr`
$ cd ~/vultr/git/vultr and git init
$ git remote add production ssh://[email protected]:/home/vultr/web/git/vultr

Það er gagnlegt að setja Hexo á staðbundna vélina þína til að skrifa færslu. Hér setjum við upp Hexo möppu til að skrifa.

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

Uppsetningunni er lokið. Þú getur ýtt færslu á netþjóninn þinn með eftirfarandi skipunum:

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

Þegar vel tekst til verður bloggið sjálfkrafa uppfært. Skál.