由于 solo 不再支持 servlet 方式部署,此项目停止维护,建议使用 solo-in-docker, 参见 Solo v3.6.7 发布,移除 Servlet 容器支持
solo 博客独立部署方式自动检测更新。
功能:自动检测版本,自动下载更新,自动解压,自动复制配置文件以及其他的文件。目前仅支持 linux 版本。
配置在线生成地址: solo-auto-ui
-
仅支持
linux
系统下的独立部署
、tomcat 部署
。 -
建议您先备份数据库以及配置文件,虽然不对数据库进行任何操作,但是定时备份是好习惯。
-
为避免不必要的错误,请务必使用
root
用户运行。 -
独立部署仅支持系统命令,不能使用别名定义的命令。
-
独立部署请检查
pkill -9 -f org.b3log.solo.Starter
命令是否能够杀死你的solo
进程。
获取最新版本的 release
配置在线生成地址: solo-auto-ui
注意,你的配置将会完全覆盖默认配置!
属性名 | 类型 | 默认值 | 描述 |
---|---|---|---|
latestUrl |
String |
最新版本 solo 的 github restful 接口地址 |
|
homeDir |
String |
/root/ |
解压后的文件夹路径,结尾必须有文件分隔符 |
deploy |
String |
solo |
部署方式,可选 |
tomcatDir |
String |
solo |
|
interval |
Number |
6 |
几小时检测一次版本更新 |
version |
String |
v3.2.0 |
当前已经部署的版本号,格式必须与 github 上相同 |
timeOut |
Number |
30 |
Event Bus 等待时间 |
otherFiles |
Array |
[] |
其他的需要移动的文件名称 |
debug |
Boolean |
false |
简单打印方法信息,方便排错 |
startCommand |
Stirng |
|
启动命令,前面必须加英文符分号 |
请注意:建议以 root 身份运行,否则可能会出现权限问题无法执行命令的情况。
-
前台运行,假设配置文件与
jar
包位于同一目录且名称为solo-auto.json
java -jar soloauto-1.0.0-SNAPSHOT-fat.jar -conf solo-auto.json
-
后台运行,假设配置文件与
jar
包位于同一目录且名称为solo-auto.json
nohup java -jar soloauto-1.0.0-SNAPSHOT-fat.jar -conf solo-auto.json >/dev/null 2>&1 &
建议,先前台运行,检查控制台输出中的配置文件是否有配置错误,确认无误且不报错后,再后台运行。
-
请注意填写以下属性
属性 | 注意 |
---|---|
|
|
|
|
|
|
Q: 为什么会写这个?
A: 从 V2.8.0
开始用 solo
,至今到了 V3.2.0
,以前除了部署应用的时候上一下服务器,其他时候都用不上,hexo
这些博客基本很少更新。现在每次更新都要上去重复一边操作,实在太麻烦了。但是又特别喜欢 solo
这样活跃的博客与社区,所以遇到问题当然是想自己解决下问题。
Q: 为什么不用 docker
?
A: 服务器资源有限,除了 solo
还运行者其他的应用,运行 docker
就会有一些资源被占用,并且想自己 DIY
部分主题比较麻烦,每次都要进服务器,再进容器里面改,为了运行 solo
直接上 docker
觉得没必要。如果后面还有应用使用 docker
会换,或者 D 大说的会重写 Docker
镜像构建的时候可能会换。
Q: 为什么不用 tomcat
?
A: tomcat
跑着其它应用,没做负载均衡,并且担心访问速度,所以直接用 独立容器 + nginx
部署了。v1.1.0 版本已经可以使用tomcat
-
运行在指定端口:请修改
startCommand
, 前面一定要加分号;
{
"startCommand":";nohup java -cp 'WEB-INF/lib/*:WEB-INF/classes' org.b3log.solo.Starter -lp 8765 >/dev/null 2>&1 &"
}
-
如果你需要复制其它文件,可以采用这个配置:请修改
otherFiles
{
"homeDir": "/root/",
"version": "v3.2.0",
"otherFiles": [
"favicon.ico",
"favicon.png",
"background.jpg"
]
}
解释如下:
属性名 | 值 | 解释 |
---|---|---|
homeDir |
/home/echocow/ |
解压后的文件夹路径,结尾必须有文件分隔符,当前版本以及新版本都会存放在此目录 |
version |
v3.2.0 |
当前已经启动且部署好的 solo 版本 |
otherFiles |
["favicon.ico", "favicon.png", "background.jpg"] |
其它需要复制的文件,一旦填写,就会覆盖默认的,所以这里要加上默认的,然后多加了 |
-
如果你不需要复制其它文件,可以采用这个配置
{
"homeDir": "/home/echocow",
"version": "v3.2.0"
}
解释如下:
属性名 | 值 | 解释 |
---|---|---|
homeDir |
/home/echocow/ |
解压后的文件夹路径,结尾必须有文件分隔符,当前版本以及新版本都会存放在此目录,默认 /root/ |
version |
v3.2.0 |
当前已经启动且部署好的 solo 版本 |
-
假设我现在已经部署好了
solo
,并且路径为/home/echo/Other/apache-tomcat-9.0.16/webapps/solo
,配置文件如下:
{
"homeDir": "/home/echo/Other/apache-tomcat-9.0.16/webapps/",
"deploy": "tomcat",
"tomcatDir": "solo",
"version": "v3.2.0",
"otherFiles": [
"favicon.ico",
"favicon.png",
"background.jpg"
]
}
其中 deploy
和 tomcatDir
必填
使用 vertx 事件驱动,使用 Event Bus
点对点消息模式,MainVerticle
获取默认配置,再获取用户配置以覆盖默认配置。然后分别部署两个 Verticle
。
-
WebClientVerticle
定时检测版本 -
FileVerticle
处理文件下载、移动操作
-
WebClientVerticle
检测当前最新版是否与配置中的版本匹配,如果不匹配,携带请求的部分信息通知FileVerticle
。 -
FileVerticle
使用类名注册一个处理器以接受请求,收到通知以后,获取最新版本。 -
下载最新版本的
war
包,解压,然后移动用户自定义的文件(配置文件中otherFiles
)。 -
移动
solo
配置文件:local.properties
,latke.properties
,solo.properties
. -
复制完毕后,使用
pkill -9 -f org.b3log.solo.Starter
杀死以前的solo
进程, -
使用
cd 解压后的路径;nohup java -cp WEB-INF/lib/*:WEB-INF/classes org.b3log.solo.Starter >/dev/null 2>&1 &
命令启动solo
,后面的启动命令用户可以自定义,请注意:自定义启动命令前请务必加上分号! -
FileVerticle
执行完毕,回复WebClientVerticle
,WebClientVerticle
收到回复日志记录。
-
目前没有写
windows
的打算。 -
打算加入邮件或者短信通知,以能够更好的感知博客更新变化。
-
考虑是否加入
web
页面,但是觉得没必要。 -
想过做成
solo
插件,但是文档太少,并且感觉局限性比较大且自己水平有限,所以放弃了。