利用GitHub+Actions自動部署Hexo部落格

前言

早就聽聞GitHub+Actions真相，于是今天便試了下，作為小康部落格的第二個平台。至于為什麼要自動部署，我在另一篇文章介紹過了。

準備倉庫

私有倉庫： blog

這裡是存放 Hexo 部落格源碼的

公有倉庫： 使用者名.github.io

這裡是用來 public 靜态頁面的，最好是空的，當然是你現在的hexo部落格也可以。

建立密鑰對

為了友善運作GitHub Actions時登入GitHub賬号，我們使用SSH方式登入。就是要把裝置的私鑰交給GitHub Actions，公鑰交給GitHub，需要去Settings裡去配置。

ssh-keygen -t rsa -C "Github 的郵箱位址"

如 ssh-keygen -t rsa -C "[email protected]"

複制

密鑰對生成後預設的位置是使用者檔案。以windows為例：密鑰對檔案在

C:\Users\使用者名

裡，其中Users可能因為系統原因顯示的是

使用者

。這個檔案夾裡會有一個

.ssh

的目錄，這個裡面就是我們的密鑰對。

其中

id_rsa

是私鑰，

id_rsa.pub

是公鑰。

配置公鑰，應該已經配好，不然如何上到的項目資源，配置路徑：github網站–>Settings–>SSH and GPG keys

新增一個公鑰，然後把

id_rsa.pub

這個檔案用文本文檔打開，将内容複制進去。

配置私鑰，blog私有倉庫的Settings->Secrets裡添加私鑰，名稱為 HEXO_DEPLOY_PRIVATE_KEY 找到你的私有項目（用于存儲部落格源碼的倉庫）

将你的私鑰添加進去，名字寫

HEXO_DEPLOY_PRIVATE_KEY

。

添加Actions

點選私有倉庫裡的

Actions

。

點選

New workflow

來建立一個新的actions。

然後在内容框填入以下代碼

# workflow name
name: Hexo Blog CI

# master branch on push, auto run
on: 
  push:
    branches:
      - master
      
jobs:
  build: 
    runs-on: ubuntu-latest 
        
    steps:
    # check it to your workflow can access it
    # from: https://github.com/actions/checkout
    - name: Checkout Repository master branch
      uses: actions/checkout@master 
      
    # from: https://github.com/actions/setup-node  
    - name: Setup Node.js 10.x 
      uses: actions/setup-node@master
      with:
        node-version: "10.x"
    
    - name: Setup Hexo Dependencies
      run: |
        npm install hexo-cli -g
        npm install
    
    - name: Setup Deploy Private Key
      env:
        HEXO_DEPLOY_PRIVATE_KEY: ${{ secrets.HEXO_DEPLOY_PRIVATE_KEY }}
      run: |
        mkdir -p ~/.ssh/
        echo "$HEXO_DEPLOY_PRIVATE_KEY" > ~/.ssh/id_rsa 
        chmod 600 ~/.ssh/id_rsa
        ssh-keyscan github.com >> ~/.ssh/known_hosts
        
    - name: Setup Git Infomation
      run: | 
        git config --global user.name '名字' 
        git config --global user.email '郵件'
    - name: Deploy Hexo 
      run: |
        hexo clean
        hexo generate 
        hexo deploy

複制

然後點選送出即可

這樣設定後就不需要在hexo指令三連進行部署了，直接将代碼推送到私有倉庫，1分鐘後即可看到效果。

常見問題

域名問題

每次部署完都需要重新綁定域名

解決方式很簡單，在部落格根目錄的配置檔案中找到

skip_render

字段，添加值

'CNAME'

如果是多個值的配置

skip_render: 
  - '404/index.html'
  - 'CNAME'

複制

然後在

/source

的目錄中建立一個檔案，命名為

CNAME

，裡邊的内容寫你的域名。隻寫域名即可。例如

www.antmoe.com

，不需要添加

http(s)://

其他問題

請在下面留言，并寫上常用的郵箱（及時得知部落客的回複，郵箱不會洩露）和你的昵稱。部落客看到後會及時幫助解決問題的。