我的博客发布上线方案 — Hexo

Michael_Lin 发布于2019-06-24 18:21 / 3625人阅读

摘要：首发于樊浩柏科学院之前一直在使用推荐的发布方案，缺点是本地依赖环境，无法随时随地地更新博客。为了摆脱环境约束进而高效写作，有了下述的发布方案。我的写作环境为，博客发布在阿里云的上，文章托管在。

首发于 樊浩柏科学院

之前一直在使用 Hexo 推荐的发布方案，缺点是本地依赖 Hexo 环境，无法随时随地地更新博客。为了摆脱 Hexo 环境约束进而高效写作，有了下述的发布方案。

本文的发布方案中，Git 仓库只是托管 md 文件，通过 Webhook 通知服务器拉取 md 文件，然后执行构建静态文件操作，完成一个发布过程。

我的写作环境为 Typora（Win10），博客发布在阿里云的 ECS（CentOS）上，文章托管在 GitHub。

需求迭代

随着时间成本的增高，只能利用碎片时间来进行写作。因此，我的写作场景变成了这样：

习惯使用 MarkDown 写原稿，有 MarkDown 编辑器就行；

写作场地不限定，有电脑就行；

写作时间不确定，有灵感就写；

新的问题

之前（包括 Hexo 推荐）的发布方案，都是先本地编写 MarkDown 源文件，然后本地构建静态文件，最后同步静态文件到服务器。发布流程图如下：

显而易见，若继续使用之前的发布方案，那么每当更换写作场地时都需要安装 Hexo 环境，写作场地和时间都受到限制，不满足需求。

新的方案

问题主要是，本地受制于构建静态文件时需要的 Hexo 环境，那么是否可以将构建静态文件操作放到服务器端？

发布流程

首先，看下新方案的发布流程图：

如流程图所示，整个发布系统共涉及到 3 个环境，分别为本地（写作）、Git 仓库（托管 md 源文件）、服务器（Web 服务）环境。在服务器环境构建静态文件，因此只需要在服务器端安装 Hexo 环境。

一个完整的发布流程包含 3 个部分：

流程 ① ：写作流程；

流程 ② ：发布流程；

流程 ③ ：构建流程；

写作流程

采用按分支开发策略，当写作完成后，只需要 push 修改到对应分支即可。只要有 MarkDown 编辑器，以及任何文本编辑器，甚至马克飞象都可以随时随地写作。

当然，你可能说还需要 Git 环境呀？好吧，如果你是一名合格的 Coder，竟然没有 Git，你知道该干嘛了！再说没有 Git 环境，还可以通过 GitHub 来完成写作。

发布流程

采用 master 发布策略，当需要发布时，需要将对应开发分支 merge 到 master 分支，然后push master分支，即可实现发布。

构建流程

这里使用到 Webhook 机制，触发服务器执行构建操作，构建脚本见 Webhook 脚本部分。

当流程 ① 和 ② 结束后，Git 仓库都会向服务器发起一次 HTTP 请求，记录如下：

当收到构建请求后，执行构建操作。构建流程图如下：

首先检查当前变更分支，只有为 master 分支时，执行 pull 操作拉取 md 文件更新，然后再执行 hexo g完成静态文件的构建。

Webhook脚本

Webhook 脚本使用 PHP 实现，代码如下：

主流程方法如下：

public function run()
{
    //校验token
    if ($this->checkToken()) {
        echo "ok";
    } else {
        echo "error";
    }
    fastcgi_finish_request();       //返回响应
    if ($this->checkBranch()) {     //校验分支
        $this->exec();              //执行操作逻辑
    }
}

这里使用 shell 脚本实现构建所需的所有操作，方便扩展。执行操作方法如下：

public function exec()
{
    //shell文件
    $path = $this->config["bash_path"];
    $result = shell_exec("sh $path 2>&1");
    $this->accessLog($result);
    return $result;
}

构建 shell 脚本如下：

#!/usr/bin/env bash

export NODE_HOME=/usr/local/node
export PATH=$NODE_HOME/bin:$PATH

pwd="/data/html/hexo"
cd $pwd/source
git pull
cd $pwd
$pwd/node_modules/hexo/bin/hexo g

总结

新发布方案与之前方案的区别是：前者只需本地编写 md 文件，博客服务器构建静态文件；后者本地编写 md 文件后，需要本地构建静态文件，然后博客服务器只同步静态文件。

当然，有很多办法可以解决当前问题，比如可以使用持续集成。本文只是提供一个发布思路，在项目的生成环境中，我们也很容易应用上这种发布思路，开发出自己的发布系统。

相关文章 »

启用Hexo开源博客系统（2017-03-01）

文章版权归作者所有，未经允许请勿转载,若此文章存在违规行为，您可以联系管理员删除。

转载请注明本文地址：https://www.ucloud.cn/yun/11988.html

我的博客发布上线方案 — Hexo

摘要：首发于樊浩柏科学院之前一直在使用推荐的发布方案，缺点是本地依赖环境，无法随时随地地更新博客。为了摆脱环境约束进而高效写作，有了下述的发布方案。我的写作环境为，博客发布在阿里云的上，文章托管在。首发于樊浩柏科学院之前一直在使用 Hexo 推荐的发布方案，缺点是本地依赖 Hexo 环境，无法随时随地地更新博客。为了摆脱 Hexo 环境约束进而高效写作，有了下述的发布方案。 show...

yangrd 2019-07-01 12:37 评论0 收藏0
Hexo 博客终极玩法：云端写作，自动部署

摘要：配置触发方式一般会得到这么个语雀配置配置一个仓库的可以选择所有更新触发或者主动触发，主动触发的意思即发布需要勾选一个选项才会触发。 Hexo + Github + 语雀 + yuque-hexo +travis-ci+severless 打造全自动持续集成个人博客，云端写作，自动部署，完美体验~ 一、Hexo+Github 的痛点 1.为啥要用hexo+github？作为一个程序猿，...

AlphaWallet 2019-08-02 14:04 评论0 收藏0
Hexo 博客终极玩法：云端写作，自动部署

摘要：配置触发方式一般会得到这么个语雀配置配置一个仓库的可以选择所有更新触发或者主动触发，主动触发的意思即发布需要勾选一个选项才会触发。 Hexo + Github + 语雀 + yuque-hexo +travis-ci+severless 打造全自动持续集成个人博客，云端写作，自动部署，完美体验~ 一、Hexo+Github 的痛点 1.为啥要用hexo+github？作为一个程序猿，...

EsgynChina 2019-08-23 14:33 评论0 收藏0
为什么我选择用 Github issues 来写博客

摘要：为什么不选择其他方案在文章的开头我有提到，我曾经尝试过用，，自行搭建服务等途径去尝试维护博客。但这些尝试的结果均不合我意，最后无疾而终。我们使用作为博客平台，也就是相当于管理后端。showImg(https://user-gold-cdn.xitu.io/2019/5/22/16adf79473dbdf59); 对于爱写东西的人来说，挑一个合适的博客平台是非常重要的。而作为一个 Web 开发...

gnehc 2019-05-23 12:20 评论0 收藏0
为什么我选择用 Github issues 来写博客

摘要：为什么不选择其他方案在文章的开头我有提到，我曾经尝试过用，，自行搭建服务等途径去尝试维护博客。但这些尝试的结果均不合我意，最后无疾而终。我们使用作为博客平台，也就是相当于管理后端。 showImg(https://segmentfault.com/img/remote/1460000019265125?w=700&h=420); 对于爱写东西的人来说，挑一个合适的博客平台是非常重要的。...

Scliang 2019-08-26 13:54 评论0 收藏0