远程管理hugo源文件以自动更新blog

/2021/07/20210714-workflows/featured-image.jpg

远程管理hugo源文件以自动更新blog

基于Github-Actions-Workflows

胡子叔叔 published in 写作

2021-07-14 252 words 2 minutes

Contents

将博客源文件托管在某个地方，换台电脑继续编辑。再加上触发机制更好，即一上传⏫就同步更新博客～

在之前快速搭建个人博客的文章中有提到

将 public 文件夹下的文件推送至GitHub仓库

每次这么操作还是有点繁琐的，所以就想如果更新完hugo源文件，博客自动更新就好了。此外，换台电脑💻，依然正常操作就更更更好了～

终于，是找到了GitHub的 Actions 中 Workflows 功能

将Hugo源文件维护在GitHub上，只要源文件的仓库更新，自动更新存有 public 文件的仓库，那么博客也就随之更新了。

在此记录下实现过程 👇

1. 生成SSH key （Windows 环境）

参考这个

通过git bash cd 至 .ssh 文件夹

1

cd ~/.ssh/

如果提示 No such file or directory，可以手动的创建一个 .ssh文件夹，BY mkdir ~/.ssh

配置全局 name 和 email

1
2


git config --global user.name "你的用户名"
git config --global user.email "你的公司或个人邮箱"

生成 key

1

ssh-keygen -t rsa -C "你的公司或个人邮箱"

连续按 3 次回车

最后得到俩文件： id_rsa 和 id_rsa.pub

2. 创建并配置仓库

参考这个

2.1 配置hugo源文件的仓库

仓库名称不限，在此以 unclehuzi.github.io.source 为例

进入unclehuzi.github.io.source仓库，添加Secrets，名称为ACTIONS_DEPLOY_KEY，将 id_rsa 文件的内容粘过去，得到内容如下所示

上传 hugo源文件

把 themes 主题文件夹中的 .git 文件删除

不然Github 会检测到是别的仓库，上传后文件夹是灰色的

2.2 配置 unclehuzi.github.io 仓库

仓库名称有讲究，得是这个 github_user_name.github.io

进入unclehuzi.github.io 仓库，添加Deploy keys ，名称不限制，将id_rsa.pub文件的内容粘过去。

2.3 配置工作流（Workflows）

进入unclehuzi.github.io.source仓库，创建 Actions

代码如下 👇

 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


name: Deploy Hugo Site to Github Pages on Master Branch

on:
  push:
    branches:
      - master  # Attention 1

jobs:
  build-deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      
      - name: Setup Hugo
        uses: peaceiris/actions-hugo@v2
        with:
          hugo-version: '0.83.1'
          extended: true  # 使用扩展版
          # Attention 2

      - name: Build
        run: hugo #--minify

      - name: Deploy
        uses: peaceiris/actions-gh-pages@v3
        with:
          deploy_key: ${{ secrets.ACTIONS_DEPLOY_KEY }} # 这里的 ACTIONS_DEPLOY_KEY 则是上面设置 Private Key的变量名
          external_repository: unclehuzi/unclehuzi.github.io # Pages 远程仓库 
          publish_dir: ./public
          keep_files: false # remove existing files
          publish_branch: master  # deploying branch
          # Attention 3
          commit_message: ${{ github.event.head_commit.message }}

Attention 1

source 仓库的分支名称为 master
Attention 2

hugo 的版本
Attention 3

unclehuzi.github.io 仓库的分支名称

3. Finished

以后维护好source这个仓库就能实现

触发机制以自动更新blog
换个电脑 💻 继续写blog

Contents