禅道是用于项目管理的软件,开源版功能也足够使用,鉴于每个公司都需要搭建一套项目管理软件,之前就有计划写一篇禅道和内部聊天工具的搭建文章,之前公司里使用的是禅道12,最近发现禅道发布了15.0.3,于是又基于docker方式重新升级了禅道,顺便把新版本的搭建方式写下来
打开禅道官网,在Banner图上点击开源版15.0.3,往下找到下载链接部分,下载Linux一键安装包64位,在下载链接右边官方说了要解压到/opt目录下,下面采用docker来部署,没有在官网上找到最新版本的docker镜像
下载
先创建docker目录
cd /usr/local
mkdir docker/zentao -p
cd docker/zentao
将下载好的一键安装包放到/usr/local/docker/zentao目录下并解压,解压后目录名叫zbox
tar -xzvf ZenTaoPMS.15.0.3.zbox_64.tar.gz
相关命令
从官网的下载页面可以看到命令说明
zbox start
启动apache和mysqlzbox restart
重启zbox stop
关闭
docker-compose.yml
version: '3.1'
services:
zentao_15:
image: ubuntu:18.04
restart: always
container_name: zentao_15
ports:
- 280:80
- 11444:11444
- 11443:11443
volumes:
- ./zbox:/opt/zbox
- ./xxd.conf:/opt/zbox/run/xxd/config/xxd.conf
- ./start.sh:/start.sh
command: ["/bin/bash", "/start.sh"]
思路是以ubuntu镜像启动一个容器,将zbox目录挂载到容器中,再提供一个shell脚本文件在容器启动时执行该脚本
xxd.conf
xxd.conf是xxd的配置文件,xxd是禅道客户和喧喧的服务器端程序,配置并启动xxd才能使用禅道的客户端和喧喧,xxd.conf这个配置文件可在禅道部署好之后在禅道后台生成并下载,下文会说
[server]
ip=0.0.0.0 # 监听的IP地址,不要使用127.0.0.1。
commonPort=11443 # 登录和附件上传接口(http),确保防火墙开放此端口。
chatPort=11444 # 聊天消息通讯端口(websocket),确保防火墙开放此端口。
https=off # HTTPS(on|off)。使用HTTPS可以保证消息全程加密。
enableAES=1 # 与后端服务器通讯时的 AES 加密开关,1 为开启 0 为关闭。
enableClientAES=1 # 是否启用与客户端通信时的 AES 加密。
enableCompression=1 # 是否启用 websocket 和 http 通信压缩。
uploadPath=files/ # 附件保存的目录。默认存放在xxd/files/。
uploadFileSize=32M # 上传文件的大小,以M为单位。
pollingInterval=60 # 轮询时间,单位为秒,最小值为 5。
maxOnlineUser=0 # 在线用户上限,0为无限制。
logPath=log/ # 程序运行日志的保存路径。
certPath=cert/ # 证书的保存路径。
debug=0 # Debug级别,可设置0|1|2
[backend]
# xxd可以对接多个后台程序。每一个后台程序由入口文件 + 私钥组成。
# 客户端登录时如果没有指定后台程序,会默认登录到第一个后台程序。
default=http://IP:端口/zentao/x.php,KEY
整个xxd.conf中最重要的是[backend]
里面的default=...
,其中IP、端口和KEY需要指定,我们也不知道,只能在部署好禅道后去后台生成
start.sh
start.sh是在容器启动时执行的脚本,需要执行启动禅道和xxd的命令
#!/bin/bash
# 启动禅道
/opt/zbox/zbox start
# 启动xxd
/opt/zbox/run/xxd/xxd
# 一个死循环,每次睡眠3600秒,即1小时
for (( ;; )); do
sleep 3600;
done
shell脚本中有死循环的目的是让容器永远不会关闭,要不然shell脚本执行完容器就关闭了
目录
最终的目录如下
|-- docker-compose.yml
|-- start.sh
|-- xxd.conf
|-- zbox
`-- ZenTaoPMS.15.0.3.zbox_64.tar.gz
启动
docker-compose up -d
启动后访问http://IP:280/
,账号和密码默认是admin
和123456
,登录后请务必及时修改
xxd配置文件生成
使用admin
账号登录禅道,点击左侧的后台
->客户端
,在打开的页面中点击参数设置
,什么也不用修改,点击保存,接下来点击只下载配置文件
按钮,就可以得到xxd.conf
文件了
桌面客户端
在后台右上角找到下载入口,如下:
下载安装好之后,打开时服务端地址填你的禅道地址,如:http://192.168.3.3:280/
,用户名和密码填禅道里任意用户的用户名和密码,admin
账号也可以登录
桌面客户端的功能主要是团队内部聊天工具和内嵌的禅道入口,当有新的任务或bug提交时,相关人员都会收到客户端推送提醒,使用客户端就可以不用在浏览器上打开禅道了
手机APP
在应用市场搜索喧喧,安装打开后服务器端地址和桌面客户端填写的一模一样,在喧喧里能做的事只有内部聊天