通过gitee管理hexo管理发布内容

技术分享

发布日期: 2021-02-02

更新日期: 2023-01-13

文章字数: 1.4k

阅读时长: 5 分

阅读次数:

想法

最原始的办法是通过ftp或者winscp这样的工具能实现内容上传，但是不够简化，首先你要登录服务器，然后找到相应文件夹进行更新。
第二种方法是先更新gitee仓库，然后通过ssh登录服务器，然后从仓库pull下所有代码
第三种方法是不需要gitee仓库，直接在服务器建一个空仓库，然后把本地发布文件push到服务器仓库上

上面3种方法，第1种最原始，第2种比较繁琐，第3种简单可操作，但是第3种有一个问题，就是代码管理全部在服务器上，可视性比较差，能不能通过gitee管理代码，包括原始文件，然后一旦用户push，通过钩子函数，触发服务器主动拉取，这样，所有操作都简化为了本地的一个git push指令。说干就干，问了一圈度娘，果然高手在民间，几个关键步骤都有相应的帖子介绍。

第一步建立hexo空仓库

本地把项目文件统统push上去，除了node_module文件夹。这样，项目文件也不会丢失，便于以后复用。

第二步建立服务器到hexo仓库私钥通信

1. 创建ssh连接密钥

参看 https://gitee.com/help/articles/4181#article-header0

ssh-keygen -t rsa -C "xxxxx@xxxxx.com"  
# Generating public/private rsa key pair...

产生两个文件：id_rsa id_rsa.pub
切换到 ~/.ssh目录，cat id_rsa.pub 文件，复制，这个就是gitee需要的公钥，注意最后的用户信息不要复制
gitee仓库上操作后，服务器就能免登录操作仓库了
gitee仓库管理上添加公钥

2. 创建webhooks钩子函数并在服务器上处理

分两步，一是gitee上进行添加webhooks钩子，不懂得可以参照官方文档 https://gitee.com/help/categories/40
第二步，在服务器上添加地址监听，对上一步填写的post地址进行维护，大意就是一旦收到post请求，就执行一个sh命令，这个命令可以pull下仓库代码。
gitee上添加wenhooks
我这里用的是nodejs的express模块监听某个端口，文件名为wenhooks.js，具体代码如下

var http = require('http')
var createHandler = require('gitee-webhook-handler')
var handler = createHandler({ path: '/webhooks_push', secret: 'cqmygysdssjtwmydtsgx'});
function run_cmd(cmd, args, callback) {
  var spawn = require('child_process').spawn;
  var child = spawn(cmd, args);
  var resp = "";
  child.stdout.on('data', function(buffer) { resp += buffer.toString(); });
  child.stdout.on('end', function() { callback (resp) });
}
handler.on('error', function (err) {
  console.error('Error:', err.message)
})
handler.on('Push Hook', function (event) { // # 这个地方就是GitHub 和 Gitee 不一样的地方，需要注意
  console.log('Received a push event for %s to %s',
    event.payload.repository.name,
    event.payload.ref);
    run_cmd('sh', ['/*/*/deploy.sh'], function(text){ console.log("sh deploy success");console.log(text) });//# 需要执行的脚本位置,需要自行修改成自己的，这行代码比较重要，是要让系统去执行一个脚本命令
})
try {
  http.createServer(function (req, res) {
    handler(req, res, function (err) {
      res.statusCode = 404
      res.end('no such location')
    })
  }).listen(1999) // # 服务监听的端口，自行修改
}catch(err){
  console.error('Error:', err.message)
}

然后编辑一下脚本文件deploy.sh，大概内容如下：

cd /hexo项目路径 #需要改成自己的项目地址，这行比较重要，当时因为这个问题折腾了好久，所有的都对，就是pull失败
git pull git@gitee.com:zdong22/hexo.git

node下的pm2工具启动进程，非常方便
pm2 start webhooks.js --name webhook
pm2

3.起一个Nginx服务

需要使用ssl，这样传输更安全
首先监听80端口和443端口，然后80端口重定向到443端口
修改nginx.conf文件内容如下：

//80端口配置
server
{
        listen 80;
        server_name zhangdong.site;
        index index.html index.htm index.php;
        root  /hexo项目路径;

        error_page   404   /404.html;
        include enable-php.conf;
        
        #将 http 重定向 https
        return 301 https://$server_name$request_uri;
}
//443端口配置
#https zhagndong.site
server {
        listen 443 ssl;
        server_name zhangdong.site;
        root /项目路径;
        index index.php index.html index.htm;

        location / {
                # First attempt to serve request as file, then
                # as directory, then fall back to displaying a 404.
                try_files $uri $uri/ /index.php?$query_string;
        }

        location ~ \.php$ {
                try_files $uri /index.php =404;
                fastcgi_split_path_info ^(.+\.php)(/.+)$;
                fastcgi_pass unix:/var/run/php/php7.0-fpm.sock;
                fastcgi_index index.php;
                fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
                include fastcgi_params;
        }
        # ssl证书地址
        ssl_certificate     /网站证书.pem;  # pem文件的路径
        ssl_certificate_key  /网站证书.key; # key文件的路径
        # ssl验证相关配置
        ssl_session_timeout  5m;    #缓存有效期
        ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:ECDHE:ECDH:AES:HIGH:!NULL:!aNULL:!MD5:!ADH:!RC4;    #加密算法
        ssl_protocols TLSv1 TLSv1.1 TLSv1.2;    #安全链接可选的加密协议
        ssl_prefer_server_ciphers on;   #使用服务器端的首选算法

}

4. 服务器设置一下git参数

pull只拉取public文件夹就行了，其它的不需要
具体方法是：
打开.git文件夹

[root@iZbp13m488196desr77aezZ .git]# ls
branches  config  description  FETCH_HEAD  HEAD  hooks  index  info  logs  objects  ORIG_HEAD  refs

修改config文件,sparesecheckout 从false改为true

[root@iZbp13m488196desr77aezZ .git]# cat config
[core]
        repositoryformatversion = 0
        filemode = true
        bare = false
        logallrefupdates = true
        sparsecheckout = true
[remote "origin"]
        url = git@gitee.com:zdong22/hexo.git
        fetch = +refs/heads/*:refs/remotes/origin/*

修改config文件
修改.git/info下的sparse-checkout文件，添加一行，public/

[root@iZbp13m488196desr77aezZ info]# ls
exclude  sparse-checkout
[root@iZbp13m488196desr77aezZ info]# cat sparse-checkout
public/
[root@iZbp13m488196desr77aezZ info]#

修改sparse-checkout文件