聊聊 GitHub Actions 博文發(fā)布工作流程
最近寫了幾篇文章，想對(duì)每次編寫的文檔做個(gè)版本控制。想到了Github， 將所有的文檔備份到Github。不想每次手動(dòng)運(yùn)行hugo 編譯和發(fā)布腳本，于是就有了下面的GithubActions工作流。借助GitHubActions完成對(duì)博客文章的自動(dòng)化發(fā)布部署。
版本庫(kù)
首先，我們?cè)贕ithub上面創(chuàng)建一個(gè)倉(cāng)庫(kù)，用于存儲(chǔ)博客的數(shù)據(jù)。靜態(tài)博客推薦使用Hugo，非常簡(jiǎn)單。使用Markdown語(yǔ)法，官方提供了很多不錯(cuò)的主題模板。
這里我是用主干main 分支存儲(chǔ)項(xiàng)目的代碼， 單獨(dú)創(chuàng)建一個(gè)分支存儲(chǔ)編譯后的靜態(tài)HTML資源文件。我們切換到另外一個(gè)分支看下：
工作面板
新建一個(gè)工作板可以自定義狀態(tài)，簡(jiǎn)單的將每次的博客優(yōu)化需求記錄在這里。這里的每一項(xiàng)任務(wù)都可以轉(zhuǎn)換為issue，提交代碼可以對(duì)應(yīng)的issue關(guān)聯(lián)。
CI/CD集成與發(fā)布
使用Github actions 作為構(gòu)建。設(shè)置在main分支提交代碼即構(gòu)建。
- name: github pages
- on:
- push:
- branches: [ main ]
簽出主干分支代碼，刪除pages-git 分支(該分支存放靜態(tài)文件，需要頻繁更新)。
- 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 生成靜態(tài)文件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
刪除當(dāng)前目錄除public目錄外的所有文件， 然后將public目錄文件移動(dòng)到當(dāng)前目錄。
- - 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
提交當(dāng)前的工作目錄到pages-git 分支。(到此pages-git分支已經(jīng)存儲(chǔ)了更新后的靜態(tài)文件)
- - name: Push changes
- uses: ad-m/github-push-action@master
- with:
- github_token: ${{ secrets.GIT_TOKEN }}
- branch: "pages-git"
github pages訪問(wèn)太慢了， 準(zhǔn)備使用國(guó)內(nèi)的gitee pages服務(wù)。在gitee創(chuàng)建一個(gè)倉(cāng)庫(kù)。最后一部分代碼是將當(dāng)前pages-git 分支代碼鏡像到gitee 項(xiàng)目的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 }}
到此，代碼已經(jīng)同步到了Gitee Pages。接下來(lái)觸發(fā)Gitee Pages 服務(wù)更新。(指定靜態(tài)目錄分支部署)
瀏覽器訪問(wèn)devopsgo.gitee.io 就可以訪問(wèn)了。到此發(fā)布完成了。
工作流已經(jīng)創(chuàng)建好了， 最后每次發(fā)布博文的時(shí)候。使用vscode編寫markdown文檔，然后本地hugo serve 調(diào)試。完成后提交到主干分支，隨后GitHub Actions 就會(huì)運(yùn)行CI/CD，自動(dòng)發(fā)布。
擴(kuò)展參考：SSH發(fā)布到云主機(jī)
- # - 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
到此，整個(gè)工作流程就完成了。望對(duì)你有所幫助!
