基于GitHub Actions 设计博文发布工作流-阿里云开发者社区

开发者社区> devopsvip> 正文

基于GitHub Actions 设计博文发布工作流

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

image.png

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

版本库

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


image.png


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


image.png


工作面板

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


image.png


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 服务更新。(指定静态目录分支部署)


image.png



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

image.png


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

image.png



image.png


image.png


扩展参考: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

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

版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。

相关文章
函数计算 4-5 月功能发布
函数计算4-5月发布了访问用户 VPC 资源,HTTP 触发器,环境变量等重磅功能,以及在控制台、工具链、SDK 上一系列改进,快来看看吧!
1281 0
升级 | Java开源诊断工具 Arthas 发布v3.1.0
Arthas 自2018年9月份上线以来「传送门」,已收获近万个star,感谢开发者们的认可。此次Arthas 3.1.0版本的发布,不仅带来大家投票出来的新LOGO,还带来强大的新功能和更好的易用性,下面一一介绍。
8214 0
使用 pip 发布 Python 程序
pypi 写过 Python 程序的小伙伴们都知道,需要 import 个非 Python 自带的软件包时,都要用到 pip 这个程序。平时我们都是用 pip,如果我们写好了一个程序,想让大家都能用的到,那么是不是也可以通过 pip 发布出去呢? 答案当然是可以了,这篇文章我们就来看看如何用 pip 发布一个 python 程序。
1723 0
使用Github Action发布函数到阿里云serverless平台
本文简述了如何通过自定义Github Action自动化部署云函数到阿里云serverless平台中
1066 0
【MaxCompute季报】MaxCompute新功能发布 2019Q2
2019年Q2 MaxCompute发布了一系列新功能。 本文对主要新功能和增强功能进行了概述。 SQL新功能 华北张家口节点正式开服售卖 国际Region Spark商业化发布 存储降价 元数据服务Information Schema MaxCompute搬站迁移工具MMA 数据脱敏 Tunn...
923 0
+关注
devopsvip
加油!
4
文章
0
问答
文章排行榜
最热
最新
相关电子书
更多
《2021云上架构与运维峰会演讲合集》
立即下载
《零基础CSS入门教程》
立即下载
《零基础HTML入门教程》
立即下载