使用Github Action实现Hexo博客自动化部署

本文参考自 Akilar，原文地址：https://akilar.top/posts/f752c86d/

每次部署Hexo都需要运行指令三件套，随着文章越来越多，编译的时间也随之越来越长，通过Github Action，我们只需要在每次完成博客的编写或修改以后，将改动直接push到远程仓库，之后的编译部署的工作统统交给CI来完成即可。

常量说明

本文内容会出现部分常量名来指代一些名词，请读者根据自己实际情况，对照好常量名

常量名常量释义
[Blogroot]本地存放博客源码的文件夹路径
[SourceRepo]存放博客源码的私有仓库名
[SiteBlogRepo]存放编译好的博客页面的公有仓库名
Site指站点，Github中编译好的博客页面仓库名应该为“username.github.io"
[SiteUsername]用户名
Site指站点
[SiteToken]申请到的令牌码
Site指站点, 本文中指代Github Token
[GithubEmail]与github绑定的主邮箱，建议使用Gmail
[TokenUser]Coding配置特有的令牌用户名

以下内容均以Github为例。若使用Gitee、Coding等进行博客部署，请阅读 Akilar的原文

Github Action的使用

获取Token

为了确保交由Github Action来持续部署时，Github Action具备足够的权限来进行hexo deploy操作, 需要先获取Token

访问Github->头像（右上角）->Settings->Developer Settings->Personal access tokens->generate new token,创建的Token名称随意，但必须勾选repo项和workflows项。

Token只会显示一次，请在生成Token之后立即记录下来，否则如果忘记了Token，就必须重新生成重新配置

然后就是创建存放Hexo博客源码的私有仓库[SourceRepo]，请注意仓库必须是私有的，因为我们之后要使用Token来上传代码，如果不设置为私有仓库会导致我们的Token泄漏

配置Github Action

以下我会给出两个版本的脚本，请自行参考。脚本1为初学者版本，无其他插件/压缩；脚本2包含了其他插件可能需要的指令，请自行参照博客的实际情况修改脚本代码

在 [Blogroot] 内新建 .github 文件夹，然后 在 .github 文件夹内部新建一个 workflows 文件夹，最后在 workflows 文件夹内新建一个 autodeploy.yml 文件

在 autodeploy.yml 中输入以下脚本

# 脚本1，供初学者使用，如有其他需要在部署前运行的插件（如gulp、hexo-bangumi-bilibili等，请参考脚本2）
# 当有改动推送到master分支时，启动Action
name: 自动部署

on:
  push:
    branches:
      - master #2020年10月后github新建仓库默认分支改为main，注意更改

  release:
    types:
      - published

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
    - name: 检查分支
      uses: actions/checkout@v2
      with:
        ref: master #2020年10月后github新建仓库默认分支改为main，注意更改

    - name: 安装 Node
      uses: actions/setup-node@v1
      with:
        node-version: "12.x" #action使用的node版本，建议大版本和本地保持一致。可以在本地用node -v查询版本号。

    - name: 安装 Hexo
      run: |
        export TZ='Asia/Shanghai'
        npm install hexo-cli -g

    - name: 缓存 Hexo
      uses: actions/cache@v1
      id: cache
      with:
        path: node_modules
        key: ${{runner.OS}}-${{hashFiles('**/package-lock.json')}}

    - name: 安装依赖
      if: steps.cache.outputs.cache-hit != 'true'
      run: |
        npm install --save

    - name: 生成静态文件
      run: |
        hexo clean
        hexo generate

    - name: 部署 #此处master:master 指从本地的master分支提交到远程仓库的master分支，若远程仓库没有对应分支则新建一个。如有其他需要，可以根据自己的需求更改。
      run: |
        cd ./public
        git init
        git config --global user.name '${{ secrets.GITHUBUSERNAME }}'
        git config --global user.email '${{ secrets.GITHUBEMAIL }}'
        git add .
        git commit -m "${{ github.event.head_commit.message }} $(date +"%Z %Y-%m-%d %A %H:%M:%S") Updated By Github Actions"
        git push --force --quiet "https://${{ secrets.GITHUBUSERNAME }}:${{ secrets.GITHUBTOKEN }}@github.com/${{ secrets.GITHUBUSERNAME }}/${{ secrets.GITHUBUSERNAME }}.github.io.git" master:main

# 脚本2，仅供有其他需要在部署前运行的插件（如gulp、hexo-bangumi-bilibili等）的博客使用，请根据自己博客的实际情况修改下面的脚本代码
name: 自动部署
# 当有改动推送到master分支时，启动Action
on:
  push:
    branches:
      - master
      #2020年10月后github新建仓库默认分支改为main，注意更改
  release:
    types:
      - published

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
    - name: 检查分支
      uses: actions/checkout@v2
      with:
        ref: master

    - name: 安装 Node
      uses: actions/setup-node@v1
      with:
        node-version: "12.x" #action使用的node版本，建议大版本和本地保持一致。可以在本地用node -v查询版本号。

    - name: 安装 Hexo
      run: |
        export TZ='Asia/Shanghai'
        npm install hexo-cli -g

    - name: 缓存 Hexo
      uses: actions/cache@v1
      id: cache
      with:
        path: node_modules
        key: ${{runner.OS}}-${{hashFiles('**/package-lock.json')}}

    - name: 安装依赖
      if: steps.cache.outputs.cache-hit != 'true'
      run: |
        npm install gulp-cli -g #全局安装gulp
        npm install --save

    - name: 生成静态文件
      run: |
        hexo clean
        hexo bangumi -u #bilibili番剧更新
        hexo generate
        gulp

    - name: 部署 #此处master:master 指从本地的master分支提交到远程仓库的master分支，若远程仓库没有对应分支则新建一个。如有其他需要，可以根据自己的需求更改。
      run: |
        cd ./public
        git init
        git config --global user.name '${{ secrets.GITHUBUSERNAME }}'
        git config --global user.email '${{ secrets.GITHUBEMAIL }}'
        git add .
        git commit -m "${{ github.event.head_commit.message }} $(date +"%Z %Y-%m-%d %A %H:%M:%S") Updated By Github Actions"
        git push --force --quiet "https://${{ secrets.GITHUBUSERNAME }}:${{ secrets.GITHUBTOKEN }}@github.com/${{ secrets.GITHUBUSERNAME }}/${{ secrets.GITHUBUSERNAME }}.github.io.git" master:main

注意，因为美国一些政治正确的原因，Github于2020年10月后的新建仓库的主分支都改名为 ”main“ 而不是 ”master“，但是Git软件默认的主分支还是 ”master“，所以请用Git查询自己本地的分支，然后把本地的分支推送到Github的 ”main“ 分支上去。例如，我本人的本地分支为 master，那么最后一行就应该为 ”master:main"，如果你的本地分支名称不是 “master”，就必须修改，否则就不能部署成功

在本地设置远程仓库和分支

以下分为两种情况：使用过Git管理过博客源代码，和没有使用过Git管理博客源代码

没有使用过Git管理博客源代码

  1. 删除或者先把[Blogroot]/themes/butterfly/.git移动到非博客文件夹目录下,原因是主题文件夹下的.git文件夹的存在会导致其被识别成子项目，从而无法被上传到源码仓库。

  2. 在博客根目录[Blogroot]路径下运行指令

git init #初始化
git remote add origin git@github.com:[GithubUsername]/[SourceRepo].git #[SourceRepo]为存放源码的github私有仓库
git checkout -b master # 切换到master分支，
#2020年10月后github新建仓库默认分支改为main，注意更改
# 如果不是，后面的所有设置的分支记得保持一致
  1. 添加屏蔽项

因为能够使用指令进行安装的内容不包括在需要提交的源码内，所有我们需要将这些内容添加到屏蔽项，表示不上传到github上。这样可以显著减少需要提交的文件量和加快提交速度。
打开[Blogroot]/.gitignore,输入以下内容：

.DS_Store
Thumbs.db
db.json
*.log
node_modules/
public/
.deploy*/
.deploy_git*/
.idea
themes/butterfly/.git

如果你的主题不是butterfly，那么最后一行请改为你使用的主题

  1. 运行Git，提交代码

请记住下面三行指令，以后博客部署都是通过这3行指令来完成

git add .
git commit -m "github action update" #引号内的内容可以自行更改作为提交记录。
git push origin master
#2020年10月后github新建仓库默认分支改为main，注意更改
使用过Git管理过博客源代码
  1. 添加屏蔽项

因为能够使用指令进行安装的内容不包括在需要提交的源码内，所有我们需要将这些内容添加到屏蔽项，表示不上传到github上。这样可以显著减少需要提交的文件量和加快提交速度。
打开[Blogroot]/.gitignore,输入以下内容：

.DS_Store
Thumbs.db
db.json
*.log
node_modules/
public/
.deploy*/
.deploy_git*/
.idea
themes/butterfly/.git

如果你的主题不是butterfly，那么最后一行请改为你使用的主题

  1. 提交源码到私有仓库

在博客根目录[Blogroot]下启动终端，使用git指令重设仓库地址。这样在新建仓库，我们仍旧可以保留珍贵的commit history，便于版本回滚

git remote rm origin # 删除原有仓库链接
git remote add origin git@github.com:[GithubUsername]/[SourceRepo].git #[SourceRepo]为新的存放源码的github私有仓库
git checkout -b master # 切换到master分支，
#2020年10月后github新建仓库默认分支改为main，注意更改
# 如果不是，后面的所有设置的分支记得保持一致
git add .
git commit -m "github action update"
git push origin master
#2020年10月后github新建仓库默认分支改为main，注意更改

查看部署情况

打开Github的私有源码仓库，找到Action

如果出现了上面这样全部打了勾勾，就算是部署成功了。恭喜你，以后就能够通过Github Action直接一键部署，而不是每次部署之前都要用hexo手动编译等待编译完才能部署了

后记

这里可能有同学要问，github action有啥用？这不就是从hexo cl && hexo g && hexo s的三件套变成了git add .,git commit -m "commit content",git push三件套吗？
其实github action的最大作用就是进一步提高速度和便携性，首先，配置要求提交源码这点，萌新小白就没必要再靠本地不断新建压缩包来备份源码了，借助git的版本管理，不管怎么改都可以快速回滚
然后，git提交是增量更新，每次只提交新增或者删改的内容，而hexo deploy是在本地每次重新生成所有静态文件以后再整个提交。github action能帮我们节省大把时间，把最耗时的hexo generate和hexo deploy的工作丢给CI处理。让我们能够专心与编写博客内容，而不是水文3分钟，提交半小时

以后如果有机会，我会再讲讲如何用Github+npm搭建一个属于自己的免费图床和资源床（挖坑环节）

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：/a/578649.html

如若内容造成侵权/违法违规/事实不符，请联系我们进行投诉反馈qq邮箱809451989@qq.com，一经查实，立即删除！

相关文章

OSPF路由计算

OSPF路由计算

1.区域内路由计算 （1）LSA的基本概念 LS Age：当LSA被始发时，该字段为0，随着LSA在网络中被泛洪，该时间逐渐累加，当到达MaxAge（缺省值为3600s）时，LSA不再用于路…
阅读更多...
传统过程自动化工厂的智能扩展

传统过程自动化工厂的智能扩展

一 通过NOA概念，公开、安全地迈向未来 随着数字化转型在过程自动化工业中的不断深入，许多公司都面临着同一挑战——如何平衡创新和传统。放眼望去，过程自动化工业和信息技术似乎在以不同的速度发展。虽然过程自动化工厂通过使用传统的自动化…
阅读更多...
基于springboot实现企业oa管理系统项目【项目源码+论文说明】计算机毕业设计

基于springboot实现企业oa管理系统项目【项目源码+论文说明】计算机毕业设计

基于springboot实现企业oa管理系统演示 摘要 随着信息技术在管理上越来越深入而广泛的应用，管理信息系统的实施在技术上已逐步成熟。本文介绍了企业OA管理系统的开发全过程。通过分析企业OA管理系统管理的不足，创建了一个计算机管理企业OA管理系统的方案…
阅读更多...
C语言数据结构之栈

C语言数据结构之栈

目录 1.栈的概念及结构2.栈的实现3.栈的代码实现4.相关例题 •͈ᴗ•͈ 个人主页：御翮 •͈ᴗ•͈ 个人专栏：C语言数据结构 •͈ᴗ•͈ 欢迎大家关注和订阅!!! 1.栈的概念及结构 栈：一种特殊的线性表，其只允许在固定的一端进行插…
阅读更多...
AI大模型系列：自然语言处理，从规则到统计的演变

AI大模型系列：自然语言处理，从规则到统计的演变

自然语言处理，从规则到统计的演变 自然语言处理（Natural Language Processing，NLP）是人工智能的一个重要分支，主要研究如何让计算机理解、解释和生成人类语言。从自然语言处理的字面上来看，最重要的是“语言…
阅读更多...
Unity | 集成 Protobuf（proto 转 cs 插件及序列化与反序列化）

Unity | 集成 Protobuf（proto 转 cs 插件及序列化与反序列化）

1. 添加 dll 1. 下载 protobuf 源码 根据需要下载 protobuf 指定版本的源码，这里以 v3.21.12（protobuf-csharp-3.21.12.zip）为例： 下载地址：「https://github.com/protocolbuffers/protobuf/releases」 2. 下载 Vis…
阅读更多...
防火墙技术基础篇：认识安全策略、安全区域、域间转发及报文转发流程

防火墙技术基础篇：认识安全策略、安全区域、域间转发及报文转发流程

防火墙技术基础篇：认识安全策略、安全区域、域间转发及报文转发流程 一、安全策略匹配机制 简单通俗的讲，防火墙设备最基本的用途就是定义数据如何转发，靠什么定义呢？最基本的就是安全策略，当流量来到防火墙之后首先…
阅读更多...
组播技术原理概述

组播技术原理概述

组播与广播和单播的对比 l 组播、广播和单播工作模式的对比 单播：数据报文从一台主机，点对点的发给另外一台主机 广播：数据报文从一台主机，发给广播域内的全部主机 组播：数据报文从一台主机，发给…
阅读更多...
JS----前端将列表数据转树型数据

JS----前端将列表数据转树型数据

前端将列表数据转树型数据 场景：后端返回列表数据，由前端根据业务需求完成树型数据转换， 常用于侧边导航菜单，下拉树型数据项等 export function listToTree(data: []) {var map: any {},tree: any []data.forEach((item: any…
阅读更多...
ansible-playbook获取当前执行任务的ip及hostname

ansible-playbook获取当前执行任务的ip及hostname

目录 概述注意实践代码 概述 注意 此问题，配置上一个文件即可解决 实践 代码 --- - name: Get IP Addresshosts: allgather_facts: notasks:- name: Get IP Addressansible.builtin.setup:register: host_ip- name: Print IP Addressansible.builtin.debug:msg:…
阅读更多...
网络程序 -- TCP版服务器

网络程序 -- TCP版服务器

一 多进程版TCP服务器 1.1 核心功能 对于之前编写的 字符串回响程序 来说，如果只有一个客户端进行连接并通信，是没有问题的，但如果有多个客户端发起连接请求，并尝试进行通信，服务器是无法应对的 原因在于 服务器是一个…
阅读更多...
数据结构 - 队列 [动画+代码注释超详解]，萌新轻松上手！！！

数据结构 - 队列 [动画+代码注释超详解]，萌新轻松上手！！！

一. 队列的概念 队列是一种特殊的线性表，用于存储元素，并且按照先进先出(First In First Out)的顺序进行管理，这意味着最先加入队列的元素将会是最先从队列中被移除的元素 队列的原型：只允许在一端进行插入数据的操作&#xff0c…
阅读更多...
【嵌入式AI开发】轻量级卷积神经网络MobileNetV2详解

【嵌入式AI开发】轻量级卷积神经网络MobileNetV2详解

前言：MobileNetV2网络先升维后降维，在降维时使用线性激活函数，带残差的Inverted bottleck模块，防止ReLU信息丢失。在图像分类、目标检测、语义分割等任务上实现了网络轻量化、速度和准确度的权衡。 回顾MobileNetV1的理论和MobileNetV2项目实战可查阅如下链接： 【嵌入式AI…
阅读更多...
使用SDRPI运行openwifi和设置网口

使用SDRPI运行openwifi和设置网口

目录 一 制作启动盘 二 使用串口的方式启动openwifi 三 无线连接 四 网口设置，有线连接 五 使用SSH登录 一 制作启动盘 在github上下载img文件，由于github上下载速度比较慢，我会上传网盘链接 githun下载img文件地址: https://git…
阅读更多...
OS对软件的管理，进程，PCB、子进程

OS对软件的管理，进程，PCB、子进程

进程 可执行程序加载到内存中，操作系统为内个程序都形成一个PCB对象（结构体对象），PCB里存放着这个程序的所有的属性。进程可执行程序PCB ，CPU执行程序也是先通过该程序的PCB找到相应的程序代码，然后一条一…
阅读更多...
SpringCloud之Hystrix

SpringCloud之Hystrix

Hystrix理解 熔断器本身是一种开关装置，用于在电路上保护线路过载。当线路中有电器发生短路时，熔断器能够及时切断故障电路，防止发生过载、发热甚至起火等严重后果。这种保护机制被借鉴到分布式系统的设计中，形成了类似Hystrix中…
阅读更多...
基于SpringBoot+Vue校园二手交易系统的设计与实现

基于SpringBoot+Vue校园二手交易系统的设计与实现

系统介绍 自从新冠疫情爆发以来，各个线下实体越来越难做，线下购物的人也越来越少，随之带来的是一些不必要的浪费，尤其是即将毕业的大学生，各种用品不方便携带走导致被遗弃，造成大量的浪费。本系统目的就是让…
阅读更多...
安装好fedora_kde系统后的操作

安装好fedora_kde系统后的操作

文章目录 1 前言2 办公软件2.1 输入法2.1.1 安装 fcitx52.1.2 安装 fcitx5-rime2.1.3 安装 東風破2.1.4 使用 東風破 安装 郭斌勇 大神的 新世纪五笔 项目2.1.5 配置 fcitx5-rime2.1.6 重新部署 3 感谢阅读~ 1 前言 本文用的是 fedora 40 kde plasma 6。 因为有很多的软件都同时…
阅读更多...
2024全国大学生高新技术竞赛——算法智星挑战赛（A~J）

2024全国大学生高新技术竞赛——算法智星挑战赛（A~J）

好多都是之前的原题&#xff0c;甚至有上次第二届全国大学生信息技术认证挑战赛的原题&#xff0c;刚打完又来一遍&#xff0c;没绷住。 A. 手机 原题之一&#xff0c;具体出处忘了 最无脑的方法直接用map记录每个按下的值就行了&#xff0c;代码仅供参考。 #include <bit…
阅读更多...
MATLAB矩阵

MATLAB矩阵

MATLAB 矩阵 矩阵是数字的二维数组。 在MATLAB中&#xff0c;您可以通过在每行中以逗号或空格分隔的数字输入元素并使用分号标记每行的结尾来创建矩阵。 例如&#xff0c;让我们创建一个45矩阵一- 示例 a [ 1 2 3 4 5; 2 3 4 5 6; 3 4 5 6 7; 4 5 6 7 8] MATLAB将执行上述语…
阅读更多...
最新文章

Copyright @ 2022~2023