0%

使用Travis自动部署你的gitbook

配置 GitHub Token

利用 GitHub Token,Travis CI 才有权限访问你在 GitHub 上的仓库,所以不要轻易将 Token 泄露。

进入 https://github.com/settings/tokens,生成用于 Travis CI 的 Token,其中权限的勾选,酌情勾选,博主全部勾选。

配置 Travis CI

同步账号

在进入 https://travis-ci.org 进行配置前,你需要将你的项目推送到 GitHub 上,比如博主这里推送到 TravisCIStudy 的仓库,然后在 Travis CI 网站同步你的账号。

Travis CI 仓库设置

同步完仓库后,在右侧列表找到仓库,打开按钮,并点击Settings进入仓库设置。

1. 仓库设置项说明

进入后,可以看到总共有四部分设置区域:

设置名 解释说明
General 通用设置,关于是否构建分支等
Auto Cancellation 自动取消,关于是否自动取消构建分支等
Environment Variables 环境变量,填写 Token
Cron Jobs 定时任务,修改任务执行频率和条件

2. 环境变量填写

前两部分设置,按照默认即可,Environment Variables中填写刚刚生成的 GitHub Token,下图所示。

注意:

由于 Travis CI 适用于公共仓库,并且 Travis CI 构建和部署的日志也是对外公开的,所以最好不要将Display value in build log按钮打开

3. 定制任务设置

在定时任务中,可以选择任务执行的分支;间隔:每月、每周亦或是每天;选项中,可以选择是否总是执行,或是在 24 小时内只执行一次。选择完成后,按添加即可。

到这里 GitHub 和 Travis CI 仓库连接的相关参数配置完成,现在只要在项目的根目录添加.travis.yml文件后,推送到远程仓库后,Travis CI 服务检测到有该文件,便会自动执行任务。那么.travis.yml配置文件该怎么配置呢,请看下文所述。

编写. 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
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
# 指定环境语言
language: node_js
# 指定sudo权限
sudo: required
# 指定node版本
node_js: stable
# 指定缓存模块,缓存可以加速编译
cache:
directories:
- node_modules

# 邮件通知,这里配置不管成功或是失败都通知
notifications:
email:
recipients:
- [email protected]
- [email protected]
on_success: always # default: change
on_failure: always # default: always

# 构建的分支
branches:
only:
- gitbook

# 调整时区
before_install:
- export TZ='Asia/Shanghai'

# 安装环境
install:
- npm install -g gitbook-cli
- gitbook install

# gitbook生成静态文件
script:
- gitbook build

# 生成文件后,进入静态文件目录,部署到指定仓库,需要填写用户名,邮件
after_script:
- cp ./seo/* ./_book/
- cd ./_book
- git init
- git config user.name "taylortaurus"
- git config user.email "[email protected]"
- git add .
- git commit -m "Update GitBook By TravisCI With Build $TRAVIS_BUILD_NUMBER"
- git push --force --quiet "https://${GH_TOKEN}@${GH_REF}" master:master
- git push --force --quiet "https://taylortaurus:${CO_TOKEN}@${CO_REF}" master:master

# 环境变量
env:
global:
# Github Pages
- GH_REF: github.com/taylortaurus/TravisCIStudy
# Coding Pages
- CO_REF: git.coding.net/taylortaurus/TravisCIStudy.git

至此,所有的配置均完成,现在只要将.travis.yml配置文件推送到远程仓库,静等结果。