最後活躍 3 months ago

🛠️ 基于 GitHub Actions 的 Hexo 静态博客自动化部署流程。

修訂 4c01658e6f71bcfaeca68f38d38a497268627752

deploy.yml 原始檔案
1name: 🚀 自动部署
2
3on:
4 # 🌿 当推送到 main 分支时触发
5 push:
6 branches:
7 - main
8
9 # 🎉 当发布新版本(Release)时触发
10 release:
11 types:
12 - published
13
14 # ⏯️ 手动触发(通过 Actions 页面)
15 workflow_dispatch:
16
17# 🕎 设置时区为中国上海
18env:
19 TZ: Asia/Shanghai
20
21jobs:
22 deploy:
23 runs-on: ubuntu-latest
24 steps:
25 # 🔍 检出代码(默认是触发的分支,这里明确指定 main)
26 - name: 🔎 检查分支
27 uses: actions/checkout@v3
28 with:
29 ref: main
30
31 # 📦 缓存 node_modules 以加速构建
32 - name: 🧠 缓存项目 npm 包
33 id: cache-node-modules
34 uses: actions/cache@v3
35 with:
36 path: node_modules
37 key: ${{ runner.os }}-nodeModules-${{ hashFiles('package-lock.json', 'package.json') }}
38 restore-keys: |
39 ${{ runner.os }}-nodeModules-
40
41 # 🟩 安装 Node.js 环境
42 - name: 🏗️ 安装 Node
43 uses: actions/setup-node@v3
44 with:
45 node-version: "20.x"
46
47 # 🛠️ 全局安装 Hexo CLI(用于生成静态文件)
48 - name: 📥 安装 Hexo
49 run: npm install -g hexo-cli
50
51 # 📥 安装项目依赖(仅当缓存未命中时)
52 - name: ⚙️ 安装依赖
53 if: steps.cache-node-modules.outputs.cache-hit != 'true'
54 run: npm ci # ✅ 推荐使用 npm ci 替代 npm install,更稳定快速
55
56 # 🧹 清理旧的生成文件
57 - name: 🧹 清理文件树
58 run: npm run clean
59
60 # 🏗️ 生成静态文件并压缩
61 - name: 🏗️ 生成静态文件并压缩
62 run: npm run build
63
64 # 🚀 部署到 GitHub Pages(推送到 page 分支)
65 - name: 🚀 部署
66 run: |
67 cd ./public
68 git init
69 git config user.name "${{ github.actor }}"
70 git config user.email "${{ github.actor }}@users.noreply.github.com"
71 git add .
72
73 # 📝 提交信息:原始 commit + 带时区的时间戳
74 local_time=$(date +"%Z %Y-%m-%d %A %H:%M:%S")
75 git commit -m "${{ github.event.head_commit.message }} ·· [$local_time]" || echo "No changes to commit"
76
77 # 🔁 强制推送到 page 分支(用于 GitHub Pages)
78 git push --force --quiet "https://${{ github.actor }}:${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository }}.git" master:page