需求
最近想实现一个自动部署惊天博客的功能，我有一个静态博客项目,是使用hugo进行编译和部署的，之前自己写了一个脚本将变动的博客自动编译部署到github page 上，也不是很麻烦。但是需要在本机执行一次命令，没有完全自动化，以前了解过github action的功能，可以在某个分支提交代码时触发一个任务，很适合我这个场景，今天来尝试一下。
github action 其实就是设置一个触发条件，然后github提供一个运行环境去执行我们实现定义好的程序，每次执行这个任务时，所给的环境都是崭新的，不保存数据。并且任务的执行时长和一天内的任务执行次数是有限制的。不然早就被薅秃了。
我的需求是，当我在博客项目main 分支 推送代码时，触发github action 执行 hugo --minify 将markdown 文件编译成静态的 html 文件，然后推送到我的github page 上，完成部署。锁执行的任务就只有三步——下载代码，编译和部署。
先说编译，这一步是需要用到hugo命令的，github action 给我们提供的环境肯定时没有这个命令的，我们需要下载安装，非常棒的是，github 收录了开发者已经写好的 action ，我们可以直接拿来用就好了，这个仓库中就有 hugo 相关的action—— peaceiris/actions-hugo@v2
同理， 部署步骤也有人提供了对应的action，我们也是直接拿来用就好了。—— peaceiris/actions-gh-pages@v3
编译之前其实还有一步，那就是下载代码，在一个全新的环境中，如果没有代码，难道要编译空气？下载代码肯定离不开 git 工具，难道要我们自己装一个 git ? 这倒不用自己做，也有现成的 action —— actions/checkout@v2
实现
我们的需求和步骤已经梳理完了，下面看怎么操作吧
- 在项目根目录下新建
.github/workflows/pages.yml文件， 其中 yml 文件是可以随意命名的，但路径是固定的。 - 编写
page.yml
name: dcblog_action # 名字
on: # 触发条件
push: # 有推送动作时触发
branchesjkj:
- main # 这里的意思是当 main分支发生push的时候，运行下面的jobs
jobs: # 要执行的任务，可以时多个
deploy: # 任务名
runs-on: ubuntu-18.04 # 在什么环境运行任务
steps:
- uses: actions/checkout@v2 # 引用actions/checkout这个action，与所在的github仓库同名
with:
submodules: true # Fetch Hugo themes (true OR recursive) 获取submodule主题
fetch-depth: 0 # Fetch all history for .GitInfo and .Lastmod
- name: Setup Hugo # 步骤名自取
uses: peaceiris/actions-hugo@v2 # hugo官方提供的action，用于在任务环境中获取hugo
with:
hugo-version: 'latest' # 获取最新版本的hugo
- name: Build
run: hugo --minify # 使用hugo构建静态网页
- name: Deploy
uses: peaceiris/actions-gh-pages@v3 # 一个自动发布github pages的action
with:
external_repository: dccmmtop/dccmmtop.github.io # 发布到哪个repo
personal_token: xxxx # 发布到其他repo需要提供上面生成的personal access token
publish_dir: ./public # 注意这里指的是要发布哪个文件夹的内容，而不是指发布到目的仓库的什么位置，因为hugo默认生成静态网页到public文件夹，所以这里发布public文件夹里的内容
publish_branch: master # 发布到哪个branch
personal_token 可以去你的github setting 中获取,记得保密.
验证
下面在main 分支上推送一次代码，可以在github action 标签页下看到action 运行成功的标识，以及日志:
