其實 hexo 作者 TC 已經有發過一篇文章在講這個主題了,也講得很清楚了,基本上矇著眼睛照做就行了。
而這篇主要是再補充幾個細節。

SSH KEY

矇著眼照做那篇,到這行:

1
$ travis encrypt-file ssh_key --add

這邊會幫你上傳 ssh_key 到 Travis 上,--add這個flag可以幫你插入解密指令到.travis.ymlbefore_install
不過這 flag 真的很機車,會把你的.travis.yml排版全搞亂,順便把註解刪光光!
建議不要加--add自己手動插入解密指令,排版就不會亂掉。
而且用 Windows 的人會在解密文件時莫名失敗,所以只能用 Mac 或 Unix 環境做這件事(File decryption fails on Windows),超雷…

另外,如果因某種天災人禍導致忘記或沒辦法用指令插入解密指令,還是可以上 Travis 上的設定中看到環境變數名稱。

repository > more options 可以設定、看到 Travis 的環境變數repository > more options 可以設定、看到 Travis 的環境變數

USE SSH

Travis 是用 GitHub 的 Deploy key 來存取 repository 的,關於如何產生以及設定 Deploy key 都照著 TC 那篇文章做就可以了。
如果不幸在hexo deploy時遇到錯誤如下:

1
2
remote: Invalid username or password.
fatal: Authentication failed for "...."

那可以檢查一下 hexo 的_config.yml deploy的部分,要用 ssh 的形式設定 repository

_config.yml
1
2
3
4
deploy:
type: git
repo: [email protected]:SSARCandy/ssarcandy.github.io.git
branch: master

SETTING UP .travis.yml

我這個網站結構如下:

[develop] -> default branch,我在這條 branch 新增文章、修改樣式等等
[master] -> 放 static-files,也就是 hexo generate 出來的東東

讓 Travis 自動部屬時,Clone 的是 develop branch, 經過hexo generate後推到master branch 上,為了避免 forced-update,在.travis.yml中需要再設定一下。

附上我的 .travis.yml,基本上跟 TC 那篇 87% 像啦…

title: .travis.yml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
language: node_js
node_js:
- "4"
before_install:
# Decrypt the private key
- openssl aes-256-cbc -K $encrypted_d7634ff77415_key -iv $encrypted_d7634ff77415_iv -in .travis/ssh_key.enc -out ~/.ssh/id_rsa -d
# Set the permission of the key
- chmod 600 ~/.ssh/id_rsa
# Start SSH agent
- eval $(ssh-agent)
# Add the private key to the system
- ssh-add ~/.ssh/id_rsa
# Copy SSH config
- cp .travis/ssh_config ~/.ssh/config
# Set Git config
- git config --global user.name "ssarcandy"
- git config --global user.email [email protected]
# Install Hexo
- npm install hexo -g
# Clone the repository
- git clone https://github.com/SSARCandy/ssarcandy.github.io .deploy_git
# My static-files store on master branch
- cd .deploy_git && git checkout master
- cd ..
script:
- hexo generate
- hexo deploy
branches:
only:
- develop

比較需要解說的是這段

1
2
3
4
# Clone the repository
- git clone https://github.com/SSARCandy/ssarcandy.github.io .deploy_git
- cd .deploy_git && git checkout master
- cd ..

.deploy_git是 hexo 會產生的資料夾,用於紀錄 git history,不過由於每次 clone 都是全新的,所以每次.deploy_git也都會是新的,這會導致每次更新都會是 forced-update。
所以,複製一份 repo (at master branch),並改名叫.deploy_git就是為了讓新產生出的靜態檔案可以有之前的 git history,就可以避免 forced-update。