文章详情

短信预约-IT技能 免费直播动态提醒

请输入下面的图形验证码

提交验证

短信预约提醒成功

聊聊 GitHub Actions 博文发布工作流程

2024-12-03 12:49

关注

 最近写了几篇文章,想对每次编写的文档做个版本控制。想到了Github, 将所有的文档备份到Github。不想每次手动运行hugo 编译和发布脚本,于是就有了下面的GithubActions工作流。借助GitHubActions完成对博客文章的自动化发布部署。

版本库

首先,我们在Github上面创建一个仓库,用于存储博客的数据。静态博客推荐使用Hugo,非常简单。使用Markdown语法,官方提供了很多不错的主题模板。


这里我是用主干main 分支存储项目的代码, 单独创建一个分支存储编译后的静态HTML资源文件。我们切换到另外一个分支看下:


工作面板

新建一个工作板可以自定义状态,简单的将每次的博客优化需求记录在这里。这里的每一项任务都可以转换为issue,提交代码可以对应的issue关联。


CI/CD集成与发布

使用Github actions 作为构建。设置在main分支提交代码即构建。

  1. name: github pages 
  2. on
  3.   push: 
  4.     branches: [ main ] 

签出主干分支代码,删除pages-git 分支(该分支存放静态文件,需要频繁更新)。

  1. jobs: 
  2.   deploy: 
  3.     runs-on: ubuntu-18.04 
  4.     steps: 
  5.       - uses: actions/checkout@v2 
  6.         with
  7.           submodules: true  # Fetch Hugo themes (true OR recursive) 
  8.           fetch-depth: 0    # Fetch all history for .GitInfo and .Lastmod 
  9.  
  10.       - nameDelete branch 
  11.         uses: dawidd6/action-delete-branch@v3 
  12.         with
  13.           github_token: ${{ secrets.GIT_TOKEN }} 
  14.           branches: "pages-git" 

hugo --minify 生成静态文件public 目录。

  1. name: Setup Hugo 
  2.        uses: peaceiris/actions-hugo@v2 
  3.        with
  4.          hugo-version: '0.74.2' 
  5.          # extended: true 
  6.  
  7.      - name: Build 
  8.        run: | 
  9.          hugo --minify 
  10.           
  11.          ls public 
  12.          tar zcf ${version}-public.tar.gz public 
  13.          ls  

删除当前目录除public目录外的所有文件, 然后将public目录文件移动到当前目录。

  1. namecommit 
  2.        run: | 
  3.          rm -fr archetypes 
  4.          rm -fr content 
  5.          rm -fr demo 
  6.          rm -fr static 
  7.          rm -fr themes 
  8.          rm -fr .DS_Store 
  9.          rm -fr 1.1.0-public.tar.gz 
  10.          rm -fr README.md 
  11.          rm -fr config.toml 
  12.          mv public/* ./ 
  13.          sleep 3 
  14.          ls -l  
  15.          rm -fr public  
  16.          git config --global user.email xxx@qq.com 
  17.          git config --global user.name cccc 
  18.          git add . 
  19.          git commit -m "update" -a 

提交当前的工作目录到pages-git 分支。(到此pages-git分支已经存储了更新后的静态文件)

  1. name: Push changes 
  2.   uses: ad-m/github-push-action@master 
  3.   with
  4.     github_token: ${{ secrets.GIT_TOKEN }} 
  5.     branch: "pages-git" 

github pages访问太慢了, 准备使用国内的gitee pages服务。在gitee创建一个仓库。最后一部分代码是将当前pages-git 分支代码镜像到gitee 项目的pages-git分支。

  1. name'get code ' 
  2.         uses: actions/checkout@v2 
  3.         with
  4.           submodules: true  # Fetch Hugo themes (true OR recursive) 
  5.           fetch-depth: 0    # Fetch all history for .GitInfo and .Lastmod 
  6.           ref: "pages-git" 
  7.       - name'Mirror to gitee' 
  8.         uses: pixta-dev/repository-mirroring-action@v1 
  9.         with
  10.           target_repo_url: 
  11.             git@gitee.com:devopsgo/devopsgo.git 
  12.           ssh_private_key: 
  13.             ${{ secrets.GIT_PRIVATE_KEY }} 

到此,代码已经同步到了Gitee Pages。接下来触发Gitee Pages 服务更新。(指定静态目录分支部署)


浏览器访问devopsgo.gitee.io 就可以访问了。到此发布完成了。


工作流已经创建好了, 最后每次发布博文的时候。使用vscode编写markdown文档,然后本地hugo serve 调试。完成后提交到主干分支,随后GitHub Actions 就会运行CI/CD,自动发布。




扩展参考:SSH发布到云主机

  1. # - name: copy file via ssh password 
  2.     #   uses: appleboy/scp-action@master 
  3.     #   with
  4.     #     host: ${{ secrets.SSH_HOST }} 
  5.     #     username: ${{ secrets.SSH_USER }} 
  6.     #     password: ${{ secrets.SSH_PASSWD }} 
  7.     #     port: 22 
  8.     #     source: "./${{env.version}}-public.tar.gz" 
  9.     #     target: "/opt/" 
  10.          
  11.     # - name: executing remote ssh commands using password 
  12.     #   uses: appleboy/ssh-action@master 
  13.     #   with
  14.     #     host: ${{ secrets.SSH_HOST }} 
  15.     #     username: ${{ secrets.SSH_USER }} 
  16.     #     password: ${{ secrets.SSH_PASSWD }} 
  17.     #     port: 22 
  18.         # script: | 
  19.         #   rm -fr /var/www/newdevops/* 
  20.         #   mv /opt/${{ env.version }}-public.tar.gz /var/www/newdevops/ 
  21.         #   cd /var/www/newdevops/ && tar zxf ${{ env.version }}-public.tar.gz 
  22.         #   mv public/* ./  && rm -fr public  
  23.         #   chown nginx:nginx /var/www/ -R 
  24.         #   systemctl reload nginx  

到此,整个工作流程就完成了。望对你有所帮助!

 

来源:DevOps云学堂内容投诉

免责声明:

① 本站未注明“稿件来源”的信息均来自网络整理。其文字、图片和音视频稿件的所属权归原作者所有。本站收集整理出于非商业性的教育和科研之目的,并不意味着本站赞同其观点或证实其内容的真实性。仅作为临时的测试数据,供内部测试之用。本站并未授权任何人以任何方式主动获取本站任何信息。

② 本站未注明“稿件来源”的临时测试数据将在测试完成后最终做删除处理。有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341

软考中级精品资料免费领

  • 历年真题答案解析
  • 备考技巧名师总结
  • 高频考点精准押题
  • 2024年上半年信息系统项目管理师第二批次真题及答案解析(完整版)

    难度     813人已做
    查看
  • 【考后总结】2024年5月26日信息系统项目管理师第2批次考情分析

    难度     354人已做
    查看
  • 【考后总结】2024年5月25日信息系统项目管理师第1批次考情分析

    难度     318人已做
    查看
  • 2024年上半年软考高项第一、二批次真题考点汇总(完整版)

    难度     435人已做
    查看
  • 2024年上半年系统架构设计师考试综合知识真题

    难度     224人已做
    查看

相关文章

发现更多好内容

猜你喜欢

AI推送时光机
位置:首页-资讯-后端开发
咦!没有更多了?去看看其它编程学习网 内容吧
首页课程
资料下载
问答资讯