使用GitHub 自动部署
发表于更新于
字数总计:585阅读时长:2分钟阅读量:
1.准备工作
- GitHub 官方的 action:GitHub Actions
- GitHub 仓库
**一般命名为 {{username}}.github.io
这种形式。
在本仓库上再创建一个分支用于保存 Hexo 开发源码。
使用建好的分支进行 Hexo 源码备份,使用 master
分支进行博客源码部署。
**这里也可以建两个仓库分别进行博客源码和 Hexo 开发源码的保存,跟建两个分支一样。
**确认 **_config.yml
文件中有类似如下的 GitHub Pages
配置:
1 2 3 4
| deploy: type: git repository: git@github.com:xpnobug/blog.git branch: master
|
**注意:将 **repository
修改为自己的仓库地址。
2.创建 GitHub Personal Access Token(创建个人访问令牌)
用于 GitHub Actions 所构建得虚拟系统可以内容推送到仓库。
**要使用令牌从命令行访问仓库,请选择 **repo(仓库)。
3.设置仓库 Secrets
将创建好的 Personal Access Token 添加到仓库的 Secrets 中 设置名称:ACCESS_TOKEN
4.创建 workflow 脚本
**在项目根目录下创建 **.github/workflows
文件夹,并在文件夹下创建 YAML 文件用于编写任务执行脚本。
脚本内容如下:
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 54 55 56 57 58
| name: Blog CI/CD
# 触发条件:在 push 到 hexo-blog-backup 分支后触发 on: push: branches: - master
env: TZ: Asia/Shanghai
jobs: blog-cicd: name: Hexo blog build & deploy runs-on: ubuntu-latest # 使用最新的 Ubuntu 系统作为编译部署的环境
steps: - name: Checkout codes uses: actions/checkout@v2
- name: Setup node # 设置 node.js 环境 uses: actions/setup-node@v1 with: node-version: '12.x'
- name: Cache node modules # 设置包缓存目录,避免每次下载 uses: actions/cache@v1 with: path: ~/.npm key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
- name: Install hexo dependencies # 下载 hexo-cli 脚手架及相关安装包 run: | npm install -g hexo-cli npm install
- name: Generate files # 编译 markdown 文件 run: | hexo clean hexo generate
- name: Deploy hexo blog env: # Github 仓库 GITHUB_REPO: github.com/xpnobug/blog # 将编译后的博客文件推送到指定仓库 run: | cd ./public && git init && git add . git config user.name "xpnobug" git config user.email "669307582@qq.com" git add . git commit -m "GitHub Actions Auto Builder at $(date +'%Y-%m-%d %H:%M:%S')" git push --force --quiet "https://${{ secrets.ACCESS_TOKEN }}@$GITHUB_REPO" master:hexo-blog
|
**workflow 详细语法见: **GitHub 操作的工作流程语法
最后,只需要将源码推送到指定分支,GitHub Actions 就会自动部署项目.