使用 GitHub Actions 部署 Hugo 到云服务器

期望

我的博客站是使用 hugo 搭建的，每次发布都要手动通过 FTP 上传到服务器，很是繁琐，现在想通过 GitHub Actions 实现每次提交后，自动部署到服务器。（果然懒是第一生产力）

不熟悉 GitHub Actions 的同学建议先看一下下面的入门教程。

GitHub Actions 入门教程 - 阮一峰的网络日志 (ruanyifeng.com)

About workflows - GitHub Docs

实现

前置操作

添加两个部署要用到的仓库秘钥

入口：Settings → Secrets → Actions → New repository secret

• SERVER_IP：服务器地址
• SSH_PRIVATE_KEY：部署用到的服务器 ssh 私钥

代码

name: Auto Deploy Hugo
on:
  push:
    branches:
      - main
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
        with:
          submodules: true
          fetch-depth: 0

      - name: Setup Hugo
        uses: peaceiris/actions-hugo@v2
        with:
          hugo-version: '0.91.2'

      - name: Build
        run: hugo --minify

      - name: Deploy
        uses: wlixcc/[email protected]
        with:
          username: 'root'
          server: '${{ secrets.SERVER_IP }}'
          ssh_private_key: ${{ secrets.SSH_PRIVATE_KEY }}
          local_path: './public'
          remote_path: '/var/www/hugo-blog'

讲解

name: Auto Deploy Hugo # 工作流标题


# 检测到在 main 分支执行 push 动作之后触发
on:
  push:
    branches:
      - main  # 设置要部署的分支


# 工作流程中的一个任务
jobs:
  deploy: # 任务名称


# 执行当前任务需要的的环境
runs-on: ubuntu-latest

# 需要执行的步骤，多个
steps:


 # 第一步，检出代码
 - uses: actions/checkout@v3
        with:
          submodules: true  # Fetch Hugo themes (true OR recursive)
          fetch-depth: 0    # Fetch all history for .GitInfo and .Lastmod


# 配置 hugo 环境
- name: Setup Hugo
        uses: peaceiris/actions-hugo@v2
        with:
          hugo-version: '0.91.2' # hugo 版本，latest: 表示最新版


 # 打包 hugo 
 - name: Build
        run: hugo --minify # 最小化打包


# 部署
- name: Deploy
        uses: wlixcc/[email protected]
        with:
          username: 'root'   # ssh user name
          server: '${{ secrets.SERVER_IP }}' # 引用之前创建好的secret
          ssh_private_key: ${{ secrets.SSH_PRIVATE_KEY }} # 引用之前创建好的secret
          local_path: './public'  # 对应我们项目build的文件夹路径（config.yml）
          remote_path: '/var/www/hugo-blog' # 要部署到的位置

我的博客：使用 GitHub Actions 部署 Hugo 到云服务器 | SuperEggs