什么是 GitHub Actions ？
GitHub Actions 是一个 CI/CD（持续集成/持续部署）工具，GitHub 于 2018 年 10 月推出，正式版于 2019 年 11 月正式推出。
本文假设你已经有了自己的 hexo 静态博客，因此只简单介绍了自动化部署需要的设置。
创建代码仓库
1.我已经有了 tonywdy.github.io 仓库用来存放静态博客页面，仓库类型是 public
2.新建一个 myblog 仓库用来存放 Hexo 项目的源码，这个仓库的类型是 private
记得勾选 Add a Readme file 来完成 repository 的初始化
生成部署密钥
在Git Bash Here中执行
# 生成秘钥
ssh-keygen -f github-deploy-key
一路按回车直到生成成功
会在当前目录中生成两个文件，私钥文件 github-deploy-key 和公钥文件 github-deploy-key.pub
配置部署密钥
私钥
复制 github-deploy-key 文件内容，在 myblog 仓库 Settings -> Secrets -> New repository secret 页面上添加。
1.在 Name 输入框填写 HEXO_DEPLOY_PRI
2.在 Value 输入框填写 github-deploy-key 文件内容
添加完成
另外建一个用于同步到 gitee 的私钥，用于存储 gitee 的密码
1.在 Name 输入框填写 GITEE_PASSWORD
2.在 Value 输入框填写 gitee 的密码
公钥
复制 github-deploy-key.pub 文件内容，在 wbsu2003.github.io 仓库 Settings -> Deploy keys -> Add deploy key 页面上添加。
1.在 Title 输入框填写 HEXO_DEPLOY_PUB
2.在 Key 输入框填写 github-deploy-key.pub 文件内容
3.勾选 Allow write access 选项
添加完成
同步代码
接下来把群晖上的 blog 提交到了 myblog 仓库
# 将 blog 目录变成 git 可以管理的仓库
git init
# 把文件添加到版本库中
git add .
# 把文件提交到仓库。引号内为提交注释
git commit -m '第一次提交'
# 关联到远程库
git remote add origin https://github.com/wbsu2003/myblog.git
# 或者
git remote add origin git@github.com:wbsu2003/myblog.git
# 把本地库的内容推送到远程
## 第一次使用加上了-u参数，是推送内容并关联分支。
git push -u origin main
# 下次直接提交
git push origin main
# 强制更新
git push -f origin main
如果要同步到本地，可以执行下面的命令进行拉取
# 同步下拉代码
git pull origin main
创建 Workflow
在 myblog 根目录下创建 .github/workflows/deploy.yml 文件，目录结构如下。
myblog (repository)
└── .github
└── workflows
└── deploy.yml
deploy.yml 的内容如下
理论上只要修改环境变量 env 部分和 Install dependencies
# Action 的名字
name: Hexo Auto Deploy
on:
# 触发条件1：main 分支收到 push 后执行任务。
push:
branches:
- main
# 触发条件2：手动按钮
workflow_dispatch:
# 这里放环境变量,需要替换成你自己的
env:
# Hexo 编译后使用此 git 用户部署到 github 仓库
GIT_USER: wbsu2003
# Hexo 编译后使用此 git 邮箱部署到 github 仓库
GIT_EMAIL: wbsu2003@gmail.com
# Hexo 编译后要部署的 github 仓库
GIT_DEPLOY_REPO: wbsu2003/wbsu2003.github.io
# Hexo 编译后要部署到的分支
GIT_DEPLOY_BRANCH: master
# Hexo 编译后使用此 gitee 用户部署到gitee仓库
GITEE_USER: wbsu2003
# Hexo 编译后要部署的 gitee 仓库
GITEE_DEPLOY_REPO: wbsu2003/wbsu2003
# Hexo 编译后要部署到的分支
GITEE_DEPLOY_BRANCH: master
# 注意替换为你的 GitHub 源仓库地址
GIT_SOURCE_REPO: git@github.com:wbsu2003/wbsu2003.github.io.git
# 注意替换为你的 Gitee 目标仓库地址
GITEE_DESTINATION_REPO: git@gitee.com:wbsu2003/wbsu2003.git
jobs:
build:
name: Build on node ${{ matrix.node_version }} and ${{ matrix.os }}
runs-on: ubuntu-latest
if: github.event.repository.owner.id == github.event.sender.id
strategy:
matrix:
os: [ubuntu-18.04]
node_version: [12.x]
steps:
- name: Checkout
uses: actions/checkout@v2
- name: Checkout deploy repo
uses: actions/checkout@v2
with:
repository: ${{ env.GIT_DEPLOY_REPO }}
ref: ${{ env.GIT_DEPLOY_BRANCH }}
path: .deploy_git
- name: Use Node.js ${{ matrix.node_version }}
uses: actions/setup-node@v1
with:
node-version: ${{ matrix.node_version }}
- name: Configuration environment
env:
HEXO_DEPLOY_PRI: ${{secrets.HEXO_DEPLOY_PRI}}
run: |
sudo timedatectl set-timezone "Asia/Shanghai"
mkdir -p ~/.ssh/
echo "$HEXO_DEPLOY_PRI" > ~/.ssh/id_rsa
chmod 600 ~/.ssh/id_rsa
ssh-keyscan -t rsa github.com >> ~/.ssh/known_hosts
# coding 已取消同步
ssh-keyscan -t rsa e.coding.net >> ~/.ssh/known_hosts
ssh-keyscan -t rsa gitee.com >> ~/.ssh/known_hosts
git config --global user.name $GIT_USER
git config --global user.email $GIT_EMAIL
- name: Install dependencies
run: |
npm install hexo-cli -g
npm install
# 根据你安装的组件进行安装
npm uninstall hexo-generator-index --save
npm install hexo-baidu-url-submit hexo-generator-index2 hexo-symbols-count-time hexo-blog-encrypt hexo-deployer-git --save
# 复制中文语言包，解决菜单英文的问题
cp zh-CN.yml node_modules/hexo-theme-next/languages/
- name: Deploy hexo
run: |
npm run deploy
# 以下为发布到gitee
- name: Sync to Gitee
uses: wearerequired/git-mirror-action@master
env:
# 直接使用了 HEXO_DEPLOY_PRI
SSH_PRIVATE_KEY: ${{ secrets.HEXO_DEPLOY_PRI }}
with:
# GitHub 源仓库地址
source-repo: ${{ env.GIT_SOURCE_REPO }}
# Gitee 目标仓库地址
destination-repo: ${{ env.GITEE_DESTINATION_REPO }}
- name: Build Gitee Pages
uses: yanglbme/gitee-pages-action@main
with:
# 你的 Gitee 用户名
gitee-username: ${{ env.GITEE_USER }}
# 注意在 Settings->Secrets 配置 GITEE_PASSWORD
gitee-password: ${{ secrets.GITEE_PASSWORD }}
# 你的 Gitee 仓库，仓库名严格区分大小写，请准确填写，否则会出错
gitee-repo: ${{ env.GITEE_DEPLOY_REPO }}
# 要部署的分支，默认是 master，若是其他分支，则需要指定（指定的分支必须存在）
branch: ${{ env.GITEE_DEPLOY_BRANCH }}
触发部署
我在 hexo 的菜单中建了一个 发文 菜单，地址指向了 myblog 仓库中的 _post 目录
只要将 md 文件通过 Add file –> Upload files 上传到仓库，就会自动触发自动部署
目前的发布时间都在 3 分钟以内
小结
本文是照着参考文档做的，如果您在实践中遇到什么问题，请多看看原文，不管怎么说，我是个学生都能成功，你也一样可以的
参考文档
利用 Github Actions 自动部署 Hexo 博客 | Sanonz
地址：https://sanonz.github.io/2020/deploy-a-hexo-blog-from-github-actions/
利用github Actions自动同步项目到gitee并自动部署Gitee Pages
地址：https://bore.vip/archives/github-actions-sync-to-gitee/
