本文将实践使用 Github Actions 创建发布流，实现：利用 Git 本地书写完成文章，推送至 Github 远程库后，自动发布至服务器（腾讯云）。

环境

腾讯云轻量应用服务器，Github，Hexo，Rsync

思路

总体思路就是将原有的 hexo 构建和部署利用 Github Actions去代替。

创建 Hexo 博客项目

Hexo 是基于 NodeJs 的博客框架，你可以在 Hexo 官网 查看更多信息以及使用教程。

首先打开命令行，输入 npm install -g hexo-cli 安装 Hexo-Cli，以便之后可以在命令行直接使用 Hexo；完成之后在命令行输入 hexo -v 查看安装情况，如下图。
hexo-v

创建项目 hexo init my-hexo-project，这个过程会自动安装依赖包。

安装完成后，在当前目录下 cd my-hexo-project 切换至 hexo 项目目录， hexo generate 将会把网站的静态内容生成于的 /public 目录， hexo server -s 在本地启动，分发 /public 下的内容，访问 http://localhost:4000 查看。
hexo网站

很好，Hexo 已经成功启动！

手动部署至腾讯云

将本地项目打包上传至腾讯云服务器。

在服务器上新建 my-hexo-project 文件夹，将文件解压复制到该目录中，项目根目录执行 hexo server -s -p 9008；

1
2
3
4
5
6
7
8
# 打包 zip 并上传至服务器的 /home/baoxuebin/my-hexo-project 目录下，node_modules/可以不用打包，这里使用 scp 进行文件传输
scp ./project.zip hexo@81.69.252.147:/home/baoxuebin/my-hexo-project

# 服务器端的命令：
# 解压
mkdir my-hexo-project & unzip project.zip
# 在 9008 端口启动项目
hexo server -s -p 9008

浏览器访问 http://81.69.252.147:9008/ 查看。

之后所引入的 Github Actions 其实就是代替这一步骤。

创建仓库

Github Actions 基于 Github 的仓库，所以第一步将 Hexo 网站代码同步至 Github。

在本地 hexo 项目（my-hexo-project）根目录下初始化 Git 仓库，并将本地内容提交，如果你对 Git 不熟悉，参考：[Git教程 - 廖雪峰的官方网站](Git教程 - 廖雪峰的官方网站 (liaoxuefeng.com))。

之后在 Github 创建一个项目：

创建仓库

如图填写完成仓库名和描述后，点击 Create repository 创建。然后依照提示内容将本地关联远程库并推送。完整命令如下：

1
2
3
4
5
6
7
8
9
# 创建 Git 仓库
git init
# 提交本地内容
git add .
git commit -m "init project"
# 关联远程库，这里将 your_repository 改为你自己的远程仓库地址
git remote add origin your_repository.git
# 将本地内容推送至远程库
git push --set-upstream origin master

设置 Github Actions

让我们回到 Github 的仓库首页，找到 Actions，点击 set up a workflow yourself，进入 workflow 的编辑页面，如下图：

workflow

将文件名称修改为 hexo_deploy.yml，并将下面内容复制到编辑区。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
# 工作流名称
name: hexo-deploy-ci

# 控制工作流的生效条件，这里设置为 分支 master 有新的推送时触发
on:
  push:
    branches:
      - master

# 条件生效后要执行的任务
jobs:
  # 这里是单个任务
  build:
    # 任务的执行类型
    runs-on: ubuntu-latest

    # 任务执行步骤
    steps:
      # 检出仓库分支
      - name: Checkout Repository master branch
        uses: actions/checkout@v2

      # 指定 Node 版本
      - name: Setup Node.js 12.x
        uses: actions/setup-node@master
        with:
          node-version: "12.x"
      
      # 安装代码需要的依赖
      - name: Install Dependencies
        run: |
          npm install hexo-cli -g
          npm install
      
      # 利用 hexo 生成静态页面
      - name: Generate Page
        run: |
          hexo g
      
      # 使用 rsync 将 public 文件夹传输至至服务器
      - name: rsync deployments
        uses: burnett01/rsync-deployments@4.1
        with:
          # 这里是 rsync 的参数 switches: -avzh --delete --exclude="" --include="" --filter=""
          switches: -avzr --delete
          # 要同步的文件夹
          path: public/
          # 服务器传输至的目录，上文中的 /home/baoxuebin/my-hexo-project/public
          remote_path: 你的服务器上传地址
          remote_host: 修改为你的服务器地址
          remote_user: rsync 用户
          # 密钥作为敏感信息，请勿直接使用；可以在 Github 仓库页面>>Settings>>secrets 添加
          remote_key: ${{ secrets.TENCENT_CLOUD_PRIVATE_KEY }}

设置 Secrets，Name 输入 TENCENT_CLOUD_PRIVATE_KEY，Value 输入你的 SSH 私钥。

actions_secrest

腾讯云怎么获取 SSH 登录密钥？

打开腾讯云控制台，在服务器页面，点击进入“密钥”页面>>创建密钥，保存生成的私钥；
然后再在服务器>>实例信息>>密钥>>点击“绑定密钥”，注意绑定密钥时，服务器必须处于关闭状态。

如果云服务器无法提供 ssh 登录密钥，可以使用一个 rsync 用户，然后为该用户创建 ssh-key。
adduser hexo // 创建用户
ssh-keygen -t rsa -b 4096 // 创建 ssh-key
cat ~/.ssh/id_rsa // 查看 ssh-key

尝试发布

接下来，我们尝试修改 Hello-World.md 如下，并推送至 Github。

1
2
3
4
---
title: 发布测试
---
文章发布成功 :-)

提交成功后，稍等片刻，重新访问 http://81.69.252.147:9008/ ，内容已经更新。

Success

草稿分支

如果你不想每次提交都重新部署，可以新建一个 draft 分支来保存未完成的草稿；之后需要发布时，将 draft 合并至 master 并推送到 Github 完成发布。

在线创作

利用 Github 的在线编辑可以轻松地实现博客的在线编辑。在每篇博客的页面添加一个指向 Github 源代码编辑的链接（如本页面顶部右侧的 ✍️编辑）。

commit

打开 Github 的源代码编辑页面，下方的 Commit changes 区域可以选择 直接提交 或者 创建一个PR。
为了在新创建 PR 时 Github Actions 也会自动发布，(Github actions 监听 PR 的创建，会导致未审核的 PR 内容被发布，这里应该删除)
这里需要修改 workflow 代码如下：

1
2
3
4
5
6
7
8
on:
  push:
    branches:
      - master
  # 创建 PR 的触发
  # pull_request:
  #   branches:
  #     - master

参考文章

Github Docs
CSDN: GitHub Actions + Hexo实现在线写作
阮一峰：GitHub Actions 入门教程