最近写了几篇文章，想对每次编写的文档做个版本控制。想到了Github， 将所有的文档备份到Github。不想每次手动运行hugo 编译和发布脚本，于是就有了下面的GithubActions工作流。借助GitHubActions完成对博客文章的自动化发布部署。
版本库
首先，我们在Github上面创建一个仓库，用于存储博客的数据。静态博客推荐使用Hugo，非常简单。使用Markdown语法，官方提供了很多不错的主题模板。
这里我是用主干main 分支存储项目的代码， 单独创建一个分支存储编译后的静态HTML资源文件。我们切换到另外一个分支看下：
工作面板
新建一个工作板可以自定义状态，简单的将每次的博客优化需求记录在这里。这里的每一项任务都可以转换为issue，提交代码可以对应的issue关联。
CI/CD集成与发布
使用Github actions 作为构建。设置在main分支提交代码即构建。
- name: github pages
- on:
- push:
- branches: [ main ]
签出主干分支代码，删除pages-git 分支(该分支存放静态文件，需要频繁更新)。
- jobs:
- deploy:
- runs-on: ubuntu-18.04
- steps:
- - uses: actions/checkout@v2
- with:
- submodules: true # Fetch Hugo themes (true OR recursive)
- fetch-depth: 0 # Fetch all history for .GitInfo and .Lastmod
- - name: Delete branch
- uses: dawidd6/action-delete-branch@v3
- with:
- github_token: ${{ secrets.GIT_TOKEN }}
- branches: "pages-git"
hugo --minify 生成静态文件public 目录。
- - name: Setup Hugo
- uses: peaceiris/actions-hugo@v2
- with:
- hugo-version: '0.74.2'
- # extended: true
- - name: Build
- run: |
- hugo --minify
- ls public
- tar zcf ${version}-public.tar.gz public
- ls
删除当前目录除public目录外的所有文件， 然后将public目录文件移动到当前目录。
- - name: commit
- run: |
- rm -fr archetypes
- rm -fr content
- rm -fr demo
- rm -fr static
- rm -fr themes
- rm -fr .DS_Store
- rm -fr 1.1.0-public.tar.gz
- rm -fr README.md
- rm -fr config.toml
- mv public/* ./
- sleep 3
- ls -l
- rm -fr public
- git config --global user.email xxx@qq.com
- git config --global user.name cccc
- git add .
- git commit -m "update" -a
提交当前的工作目录到pages-git 分支。(到此pages-git分支已经存储了更新后的静态文件)
- - name: Push changes
- uses: ad-m/github-push-action@master
- with:
- github_token: ${{ secrets.GIT_TOKEN }}
- branch: "pages-git"
github pages访问太慢了， 准备使用国内的gitee pages服务。在gitee创建一个仓库。最后一部分代码是将当前pages-git 分支代码镜像到gitee 项目的pages-git分支。
- - name: 'get code '
- uses: actions/checkout@v2
- with:
- submodules: true # Fetch Hugo themes (true OR recursive)
- fetch-depth: 0 # Fetch all history for .GitInfo and .Lastmod
- ref: "pages-git"
- - name: 'Mirror to gitee'
- uses: pixta-dev/repository-mirroring-action@v1
- with:
- target_repo_url:
- git@gitee.com:devopsgo/devopsgo.git
- ssh_private_key:
- ${{ secrets.GIT_PRIVATE_KEY }}
到此，代码已经同步到了Gitee Pages。接下来触发Gitee Pages 服务更新。(指定静态目录分支部署)
浏览器访问devopsgo.gitee.io 就可以访问了。到此发布完成了。
工作流已经创建好了， 最后每次发布博文的时候。使用vscode编写markdown文档，然后本地hugo serve 调试。完成后提交到主干分支，随后GitHub Actions 就会运行CI/CD，自动发布。
扩展参考：SSH发布到云主机
- # - name: copy file via ssh password
- # uses: appleboy/scp-action@master
- # with:
- # host: ${{ secrets.SSH_HOST }}
- # username: ${{ secrets.SSH_USER }}
- # password: ${{ secrets.SSH_PASSWD }}
- # port: 22
- # source: "./${{env.version}}-public.tar.gz"
- # target: "/opt/"
- # - name: executing remote ssh commands using password
- # uses: appleboy/ssh-action@master
- # with:
- # host: ${{ secrets.SSH_HOST }}
- # username: ${{ secrets.SSH_USER }}
- # password: ${{ secrets.SSH_PASSWD }}
- # port: 22
- # script: |
- # rm -fr /var/www/newdevops/*
- # mv /opt/${{ env.version }}-public.tar.gz /var/www/newdevops/
- # cd /var/www/newdevops/ && tar zxf ${{ env.version }}-public.tar.gz
- # mv public/* ./ && rm -fr public
- # chown nginx:nginx /var/www/ -R
- # systemctl reload nginx
到此，整个工作流程就完成了。望对你有所帮助!
