Github Actions,这里笔者的初步感受就是提供了一个虚拟环境,编译到发布阶段各阶段的辅助工具,创建一个workflow
就可以完成提交代码到编译发布的全过程,解决的就是发布需要人工参与的问题。
预备知识
- https://docs.github.com/en/actions/quickstart:阅读 Quickstart 文档了解 Github Actions 的基本信息,学会如何创建一个 Github Actions 配置文件并对其进行更新。
- https://docs.github.com/en/pages/quickstart:阅读 Quickstart 文档了解 Github Pages 的基本信息,学会如何配置Github Pages信息(自定义域名)。
开启Github Actions
这里我已经准备好了一个仓库https://github.com/HanSanCoder/Resume(演示)
注意这是开启Actions 配置文件读和写的功能,一般这是只开启了读的功能。如果不修改你写的 Actions 配置文件是不被允许保持的!!
Settins > Actions > General
创建配置文件.yml
配置信息可以如下
name: Deploy Resume to GitHub Pages
on:
push:
branches:
- master
jobs:
build-and-deploy:
runs-on: ubuntu-latest
strategy:
matrix:
node-version: [20.x]
steps:
- name: Checkout code
uses: actions/checkout@v2
- name: Setup Node.js and Yarn
uses: actions/setup-node@v3
with:
node-version: ${{ matrix.node-version }}
cache: 'yarn'
- name: Install dependencies
run: yarn install
- name: Build project
run: yarn build
- name: Deploy to GitHub Pages
uses: peaceiris/actions-gh-pages@v3
with:
github_token: ${{ secrets.GITHUB_TOKEN }}
publish_dir: ./dist
user_name: hehansan
user_email: hehansan@gintama.love
实现功能:提交代码到仓库的时候触发workflow,将项目编译运行并发布到github pages。
Github Pages自定义域名(可选)
- 默认域名为<username>.github.io。
- 域名注册商增加一个CNAME记录值。
- github pages 检测自定义的域名是否生效。
可能遇到的问题
- Github Actions配置文件无法提交,记得去开启写的权限。
- 部署成功但是出现404:再提交一次代码到仓库。
- 部署没成功:我不知道,除非让我给你算一卦。
- 自定义域名无法解析:没遇到过,但是我刚才少讲了一步,就是在账号设置里已经在Pages里添加这个域名了。