公告

暂无数据-可能是正在加载中或者加载遇到问题

呓语梦轩-站点信息

总字数:
处理中
总文章数:
处理中
总评论数:
处理中

呓语梦轩-随机跳转

hexo + github-action持续集成

温馨提示:本文适用于

署名-非商业性使用(BY-NC)

禁止商用-转载请标注出处

阅读量 EEROE awaae(player8635) 2024-06-07 17:18:30
Categories: Tags: 本文已启用fancybox灯箱
Cover Image

Github action从发布到现在有一段时间了,它可以以一个文件为基础,操作用户的存储库进行修正、检查、持续集成的操作,它不仅仅是一种持续集成和持续交付 (CI/CD) 平台,可用于自动执行生成、测试和部署管道。开发者更可以使用Github action创建工作流来构建和测试存储库的每个拉取请求,或将合并的拉取请求部署到生产环境

同样,它也解放了我们的双手,让我们可以在本地编写完毕后直接上传到github,让github为我们分发和部署我们的项目

而对于我这个玩破博客的人来说,hexo最大的痛点就是只能在本地保存,没有办法揣在兜里就能走(没有管理后台),没法及时保存,及时发布,及时更新。同时,也让多用户协同发生了亿点点不太愉快。

准备

注意
本文中的演示密钥等皆不会上传到生产环境。

准备工作

在开始之前,你要完成一些非常简单的准备工作,比如一个github账号,一个已经在本地运行的hexo博客框架,还有任意一个页面代理的网站,类似awaae001.github.io

先在本地确定你的hexo是正常的:

hexo clean
hexo deploy

如果不是正常的,那请先部署一个hexo博客框架再进行教程!

至于如何设置和使用 Hexo,请参考:

文件获取
外部链接【安全】:
CSDN-hexo史上最全搭建教程
Hexo是一款基于Node.js的静态博客框架,依赖少易于安装使用,可以方便的生成静态网页托管在GitHub上,是搭建博客的首选框架。大家可以进入hexo官网进行详细查看,因为Hexo的创建者是台湾人,对中文的支持很友好,可以选择中文进行查看。

如果一切正常,那么请你确定你的hexo主配置文件_config.yml是否有以下的配置,而且注意:repository对应的是你的仓库SSH位置

deploy:
type: git
repository:
github: git@github.com:awaae001/awaae001.github.io.git
#coding: git@e.coding.net:g-sulf7984/awaae001/awaae001.git

密钥生成

互联网上面的教程有一部分是使用github-token来进行推送操作,不同的方式有不同的好,我们这里选择在本地生成独属于这个仓库的ssh-key,这个密钥如果控制得当,它将会只有你.github.io仓库的权限,我们不建议你使用你绑定的github-ssh-key,这会非常危险!

Git-Bash中输入命令(windows),linux\MacOS 在终端中输入:

ssh-keygen -t rsa -b 4096 -C "Hexo Deploy Key" -f github-deploy-key -N ""

这会在当前目录生成两个文件:

生成ssh-key

请保管好你的密钥!

我们把私钥放到我们存放 Hexo 原始文件的代码仓库里面,它的位置在你hexo文件夹的/目录,直接复制粘贴就好了,用于用于触发 Actions 时使用

把公钥放到 GitHub Pages 对应的代码仓库里面,建议放在你的主题/source(资源)文件夹下面,用于 Hexo 部署时的写入工作。可以参考下图进行操作

放在文件夹里面

至此,准备结束

Github

变量-博客仓库

将你的博客上传到github仓库,记得使用.gitignore配置文件排除一部分的文件,如果你上传这些文件的话,你的github仓库可能会拒绝你的操作,因为这些文件可以重复生成,而且非常巨大!

.DS_Store
Thumbs.db
db.json
*.log
node_modules/
public/
.deploy*/
_multiconfig.yml

GitHub 上打开保存 Hexo 的仓库,访问 Settings (设置)-> Secrets and variables (机密和变量)->New repository secret(新存储库密钥【绿色】),将会出现一个页面:

填写环境变量

你应该这样填写:

保存退出

变量-github.io仓库

和你第一次部署一样,你要往仓库中写入你的公钥,让系统对过来的读写请求进行验证,同样,这也是非常重要的一部分,让我们进入存放网页的仓库(就是你的.github.io站点仓库),访问:访问 Settings (设置)-> Deploy keys (部署密钥)->add Deploy keys(添加部署密钥)。

添加部署密钥

你应该这样填写:

保存退出

创建 Workflow

到最后一步了,我们要在你的hexo仓库中创建一个.github/workflows/deploy.yml,文件名可以自定义,但是文件必须要在.github/workflows/下面,要不然会将无法正确的激活 CI/CD 工作流,文件的内容如下:

name: Hexo Blog CI

on:
push:
branches:
- main
watch:
types: [started]

jobs:
build:
runs-on: ubuntu-latest

steps:
- name: Checkout Repository master branch
uses: actions/checkout@main

- name: Setup Node.js latest
uses: actions/setup-node@main
with:
node-version: "latest"

- name: Setup Hexo Dependencies
run: |
npm i hexo-cli -g
npm i yarn -g
yarn

- name: Setup Deploy Private Key
env:
ACTION_DEPLOY_KEY: ${{ secrets.HEXO_DEPLOY_KEY }}
run: |
mkdir -p ~/.ssh/
echo "$ACTION_DEPLOY_KEY" > ~/.ssh/id_rsa
chmod 700 ~/.ssh
chmod 600 ~/.ssh/id_rsa
ssh-keyscan github.com >> ~/.ssh/known_hosts
git config --global user.email "3271436144@qq.com"
git config --global user.name "awaae001"

- name: Deploy Hexo
run: |
hexo clean
hexo deploy

保存后,它会持续监测main分支的更改,一旦监测到更改,他就会在最新版ubuntu系统下为使用最新版的Node.js来您部署你的hexo

git config --global user.email "3271436144@qq.com"
git config --global user.name "awaae001"

注意将这些内容替换成你的用户名和邮件哦

注意 :${{ secrets.HEXO_DEPLOY_KEY }} 就是对应我们之前设置的私钥,如果你更改了你的私钥,请更改这里的变量名字,否则将无法使用。

效果

效果图

前面有绿色钩钩的,就表示部署成功,红色叉叉的表示失败。如果部署失败,还会收到 GitHub 的邮件提醒(当然,部署成功也会有)

最后

其实到这里就要结束了,你在部署了github action后就可以去试试qexo或者是github.dev,你也可以享受直接在VScode源代码管理界面直接提交的便利。而且使用ssh-KEY还会方便你以后将hexo上传到服务器哦!

本站评论因服务器问题,请要发图片的各位自行至 博主自建图床 上传再分享
欢迎阅读本站评论区 指南 再进行评论