使用GitHub Actions自動編譯部署hexo部落格
阿新 • • 發佈:2021-01-10
### 前言
使用hexo部落格也挺久的,最開始是本地hexo clean && hexo g,最後hexo d推送到伺服器。後來是本地hexo clean && hexo g,最後將生成檔案推送到GitHub,GitHub actions 推送到伺服器。後來本地檔案丟失,GitHub 僅僅存著編譯好public資料夾內容,該丟失就丟失了。有GitHub actions何不直接把編譯、部署都交給他,還能備份部落格,本地也不用安裝一堆環境,使用這個方法也有段時間了,記錄下。為了方便建站和編寫,還是本地建議安裝hexo。
---
### 一、初始配置
#### ssh金鑰配置
**ps: 只有且使用一個金鑰就不要看了**
##### github配置
建立私有倉庫``` fungit.org ``` ,不要初始化倉庫。
本地生成兩份ssh金鑰,一份用來本地push到GitHub,一份GitHub actions用來推送到伺服器
```bash
ssh-keygen -t rsa -b 4096 -f /c/Users/Administrator/Documents/ssh/fungit_blog_github
ssh-keygen -t rsa -b 4096 -f /c/Users/Administrator/Documents/ssh/github_to_server
```
在GitHub私有倉庫``` fungit.org ```新增 Depoly key,把剛剛生成的fungit_blog_github.pub新增進去,勾選write許可權,用來推送本地檔案。
新增一個Secret,把剛剛生成的github_to_server新增進去(注意是私鑰)名為```GITHUB_TO_SERVER_KEY```,用來GitHub actions推送到伺服器。
##### 伺服器配置
新建git使用者並配置密碼
```bash
useradd -m -s /bin/bash git
passwd git
```
將認證公鑰加入git使用者認證檔案
```bash
ssh-copy-id -i /c/Users/Administrator/Documents/ssh/github_to_server.pub git@ip -p 22222
```
* -i: 指定檔案
* -p: ssh連線埠
你也可以手動在/home/git 新建```.ssh/authorized_keys``` 檔案,把github_to_server.pub新增到authorized_keys。```.ssh```資料夾預設許可權為700,authorized_keys檔案預設許可權是600。
##### 本地配置
安裝hexo最新版本,最好安裝git-scm, git bash挺好用的。
本地配置多個ssh-key,需要手動配置使用指定的ssh金鑰。使用git bash,新建```config```檔案
```bash
vim ~/.ssh/config
#新增以下內容
Host fungit.blog
HostName github.com
IdentityFile C:\\Users\\Administrator\\.ssh\\fungit_blog_github
PreferredAuthentications publickey
IdentitiesOnly yes
```
* Host: 區分預設的github.com,倉庫連結使用```fungit.blog``` 替換 ```github.com```推送時就會匹配IdentityFile對應的金鑰檔案。
配置hexo站點
```
hexo init fungit.org
cd fungit.org
rm -rf .git
git init
```
連線私有倉庫``` fungit.org ```
```
git remote -add origin [email protected]:kroyoo/fungit.org.git
```
* 注意```[email protected]```使用上面config配置的```[email protected]```替換。
測試是否可以正常通訊
```bash
$ ssh -T [email protected]
Hi fungit.org! You've successfully authenticated, but GitHub does not provide shell access.
```
**至此,ssh金鑰配置完成,當然,如果本地只有使用一個預設金鑰id_rsa,不用那麼麻煩,直接新建站點連線倉庫就行了。**
---
### 二、自動化部署
#### 本地配置
如果你是跟我一樣不喜歡本地安裝依賴,只需手動把依賴新增到```package.json```
我的```package.json```檔案參考:
```json
{
....
...
"dependencies": {
"hexo": "^5.0.0",
"hexo-deployer-git": "^2.1.0",
"hexo-generator-archive": "^1.0.0",
"hexo-generator-category": "^1.0.0",
"hexo-generator-index": "^2.0.0",
"hexo-generator-tag": "^1.0.0",
"hexo-renderer-ejs": "^1.0.0",
"hexo-renderer-jade": "^0.5.0",
"hexo-renderer-marked": "^3.0.0",
"hexo-renderer-stylus": "^2.0.0",
"hexo-server": "^2.0.0",
"hexo-wordcount": "^6.0.1"
}
}
```
#### GitHub Actions配置
不多說,先看yaml檔案:
```yaml
name: Auto Deploy
on:
watch:
types: [started]
push:
branches:
- main
jobs:
build:
runs-on: ubuntu-18.04
if: github.event.repository.owner.id == github.event.sender.id
steps:
- name: Checkout source
uses: actions/checkout@v2
with:
ref: main
- name: Setup Node.js
uses: actions/setup-node@v1
with:
node-version: '12'
- name: Setup Hexo
run: |
git config --global user.email "[email protected]"
git config --global user.name "deploy"
npm install hexo-cli -g --no-audit
npm install --no-audit
- name: hexo clean and hexo g
run: |
hexo clean
hexo g
- name: Deploy to Server
uses: easingthemes/[email protected]
env:
SSH_PRIVATE_KEY: ${{ secrets.GITHUB_TO_SERVER_KEY }}
ARGS: "-rltgoDzvO --delete"
SOURCE: "public/"
REMOTE_HOST: ${{ secrets.SERVER_IP }}
REMOTE_PORT: ${{ secrets.SERVER_PORT }}
REMOTE_USER: ${{ secrets.SERVER_USER }}
TARGET: ${{ secrets.REMOTE_TARGET }}
- name: Deploy gh-pages
env:
ACTION_DEPLOY_KEY: ${{ secrets.HEXO_DEPLOY_KEY }}
run: |
rm -rf ~/.ssh
mkdir -p ~/.ssh/
echo 'fungit.org' > public/CNAME
echo "$ACTION_DEPLOY_KEY" > ~/.ssh/id_rsa
chmod 700 ~/.ssh
chmod 600 ~/.ssh/id_rsa
ssh-keyscan github.com >> ~/.ssh/known_hosts
hexo deploy
```
為了方便,使用了```easingthemes/[email protected]```推送工具,詳細可以去了解下。隨便看看```peaceiris/actions-gh-pages@v3```還有最後我推送到gh-pages分支的寫法。
* SOURCE: 需要推送的目錄,hexo生成在public。
* SSH_PRIVATE_KEY: ssh私鑰、私鑰。前面配置的GITHUB_TO_SERVER_KEY。
* TARGET: 伺服器目錄如/home/wwwroot/fungit.org
**ps: 所需依賴最好放在```package.json```裡面,這樣Vervel部署也方便。** 部署到ph-pages分支和連線vercel是為了以後伺服器炸了、遷移方便切過去(懶,不想修)
Vercel:
![](https://imgs.fungit.org/2021/01/08/03dabad2211c2885bb284cb674e09bb7.png)
---
GitHub Actions:
![1a93fecec483802e8ca45ff24944294d.png](https://imgs.fungit.org/2021/01/08/1a93fecec483802e8ca45ff24944294d.png)
作者: Yeksha
連結: https://fungit.org/2021/github-acionts-automatically-compile-deploy/
來源: Fungit
著作權歸作者所有。商業轉載請聯絡作者獲得授權,非商業轉載請註明