Zainstaluj Hexo na CentOS 7

• Wymagania wstępne
• Zbuduj swojego bloga Hexo
• Używanie Git do wdrożenia swojego bloga

Hexo to statyczna platforma blogowa, zbudowana z Node.js. Jest szybki w porównaniu do innych statycznych platform blogowych, takich jak Jekyll.

W tym samouczku wyjaśnię, jak zbudować i wdrożyć blog Hexo. Kroki są dość proste, napisane dla CentOS 7, Node.js 4.4. Moja lokalna maszyna to Fedora 23.

Wymagania wstępne

Zaczynamy od świeżo zainstalowanego systemu CentOS 7. Wymagane są następujące pakiety oprogramowania:

• gcc-c i gcc-c ++
• zrób i git
• nginx
• openssl
• nodejs i npm

Musisz zalogować się jako root lub jako użytkownik z uprawnieniami sudo.

Zainstaluj narzędzia

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

Zainstaluj Nginx

Możesz zainstalować nginxz domyślnego repozytorium:

$yum install -y nginx

... lub zainstaluj stabilną wersję z oficjalnego repozytorium Nginx, tutaj wybieramy ten drugi.

Utwórz plik repo o nazwie nginx.repo, którego zawartość to:

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

... i skopiuj to do /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

Zainstaluj Node.js

Instalujemy od dawna obsługiwany plik Node.js z oficjalnego repozytorium Node.js.

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

Utwórz nowego użytkownika

Zazwyczaj lepiej jest utworzyć zwykłego użytkownika do prowadzenia bloga, ponieważ root ma uprawnienia superużytkownika.

Tutaj tworzymy nazwę użytkownika vultri dodajemy go do grupy wheeloraz nginx:

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

Wygeneruj parę kluczy SSH

Przydatne i konieczne jest zalogowanie się za pomocą klucza ssh.

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

Po utworzeniu naszej pary kluczy ssh skopiuj klucz publiczny (zwykle id_rsa.pub) ~/.ssh/authorized_keysna serwer:

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

A teraz mamy zainstalowane wszystkie pakiety wstępne.

Zbuduj swojego bloga Hexo

Zainstaluj Hexo

Zaloguj się jako vultrużytkownik. Następnie utwórz ~/web/web/vultri ~/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

Wejdź ~/web/web/vultri zainstaluj Hexo:

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

Teraz musimy tylko stworzyć nasz nowy blog.

Edytuj _config.yml, aby zmienić adres URL witryny bloga. Następnie uruchomić:

$ hexo g

Twój blog został wygenerowany. Pliki HTML znajdują się pod ~/web/web/vultr/public.

Skonfiguruj serwer Nginx

W tym momencie nadal nie możemy uzyskać dostępu do naszej strony internetowej. Dlatego musimy skonfigurować Nginx.

Nginx działa jako użytkownik o nazwie nginxw nginxgrupie i dlatego musimy dodać vultrdo grupy nginx.

$ chown -R vultr:nginx ~/web

Utwórz plik konfiguracyjny Nginx o nazwie, vultr.confpod ~/web/którym treść jest mniej więcej taka:

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

Skopiować vultr.confdo /etc/nginx/config.d/i restart Nginx:

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

Teraz nasz blog jest dostępny w przeglądarce internetowej.

Używanie Git do wdrożenia swojego bloga

Ponieważ blog jest już skonfigurowany, ta część samouczka jest opcjonalna.

W tym momencie pisanie postów na blogu jest trochę niewygodne, ponieważ musielibyśmy się zalogować i napisać na serwerze. Lepszym rozwiązaniem byłoby napisanie na naszym komputerze lokalnym, przekazanie postu na serwer i umożliwienie Hexo automatycznego generowania plików statycznych. Biorąc pod uwagę, że git ma haki, które mogą zrobić wiele rzeczy, możemy użyć haka git, aby osiągnąć tę konfigurację.

Utwórz puste repozytorium na serwerze

Zaloguj się ponownie do serwera jako użytkownik vultr. Utwórz puste repozytorium:

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

Napisz plik bash o nazwie, post-receivektóry będzie wdrażał naszego bloga po każdym wypchnięciu:

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

Przed wdrożeniem będzie działać, musimy również uruchomić następujące polecenia na serwerze:

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 .

Skonfiguruj lokalne repozytorium git

Na komputerze lokalnym musimy również utworzyć repozytorium. Te kroki mogą się różnić, jeśli używasz stacjonarnego systemu operacyjnego innego niż Fedora.

Musisz mieć zainstalowany git.

Skonfiguruj lokalne repozytorium git:

$ 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

Przydatne jest zainstalowanie Hexo na lokalnym komputerze, aby napisać post. Tutaj konfigurujemy katalog Hexo do pisania.

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

Konfiguracja jest zakończona. Możesz przekazać post na swój serwer za pomocą następujących poleceń:

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

Po sukcesie blog zostanie automatycznie zaktualizowany. Twoje zdrowie.