Встановіть Hexo на CentOS 7

Hexo — це статична блогова платформа, створена за допомогою Node.js. Це швидко в порівнянні з іншими статичними блог-платформами, такими як Jekyll.

У цьому підручнику я поясню, як створити та розгорнути блог Hexo. Дії досить прості, написані для CentOS 7, Node.js 4.4. Моя локальна машина — Fedora 23.

Передумови

Ми починаємо зі щойно встановленої системи CentOS 7. Необхідні наступні програмні пакети:

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

Вам потрібно буде увійти як root або як користувач з привілеями sudo.

Встановити утиліти

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

Встановіть Nginx

Ви можете встановити nginxз репо за замовчуванням:

$yum install -y nginx

... або встановіть стабільну версію з офіційного репо Nginx, тут ми вибираємо останню.

Створіть файл репо з іменем nginx.repo, вміст якого:

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

... і скопіюйте його на /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

Встановіть Node.js

Ми встановлюємо Node.js, який давно підтримується з офіційного репозиторія Node.js.

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

Створити нового користувача

Зазвичай для ведення блогу краще створити звичайного користувача, оскільки root має права суперкористувача.

Тут ми створюємо користувача з іменем vultrі додаємо його до групи wheelта nginx:

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

Згенеруйте пару ключів SSH

Корисно та необхідно увійти за допомогою ключа ssh.

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

Після створення нашої пари ключів ssh скопіюйте відкритий ключ (зазвичай id_rsa.pub) ~/.ssh/authorized_keysна сервер:

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

І тепер ми встановили всі пакети перед збіркою.

Створіть свій блог Hexo

Встановіть Hexo

Увійдіть як vultrкористувач. Потім створіть ~/web/web/vultrі ~/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

Введіть ~/web/web/vultrі встановіть Hexo:

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

Тепер нам залишається лише створити наш новий блог.

Редагувати _config.yml, щоб змінити URL-адресу сайту блогу. Потім запустіть:

$ hexo g

Ваш блог створено. Файли HTML розташовані під ~/web/web/vultr/public.

Налаштуйте свій сервер Nginx

На даний момент ми все ще не можемо отримати доступ до нашого веб-сайту. Тому нам потрібно налаштувати Nginx.

Nginx працює як користувач, названий nginxу nginxгрупі, і тому нам потрібно додати vultrдо group nginx.

$ chown -R vultr:nginx ~/web

Створіть файл конфігурації Nginx з ім'ям vultr.confпри ~/web/якій вміст більш-менш , як це:

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

Копіювати vultr.confв /etc/nginx/config.d/і перезапустити Nginx:

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

Тепер наш блог доступний за допомогою веб-браузера.

Використання Git для розгортання свого блогу

Оскільки блог уже налаштовано, ця частина підручника є необов’язковою.

На даний момент трохи незручно писати повідомлення в блозі, тому що нам потрібно було б увійти та писати на сервері. Кращим рішенням було б написати на нашій локальній машині, перемістити повідомлення на сервер і дозволити Hexo автоматично генерувати статичні файли. Враховуючи, що git має гачки, які можуть робити багато речей, ми можемо використовувати гачок git для досягнення цього налаштування.

Створіть оголене сховище на сервері

Увійдіть на сервер знову як користувач vultr. Створіть оголене сховище:

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

Напишіть файл bash з іменем, post-receiveякий буде розгортати наш блог після кожного натискання:

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

Перш ніж розгортання запрацює, нам також потрібно запустити ці команди на сервері:

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 .

Налаштуйте свій локальний репозиторій git

На локальній машині нам також потрібно створити репозиторій. Ці дії можуть відрізнятися, якщо ви використовуєте настільну ОС, відмінну від Fedora.

Вам потрібно встановити git.

Налаштуйте локальний репозиторій 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

Корисно встановити Hexo на локальній машині, щоб написати допис. Тут ми встановлюємо каталог Hexo для запису.

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

Налаштування завершено. Ви можете надіслати повідомлення на свій сервер за допомогою таких команд:

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

У разі успіху блог буде автоматично оновлено. На здоров'я.