docker安装禅道15.0.3和聊天工具

1,414 阅读4分钟

禅道是用于项目管理的软件,开源版功能也足够使用,鉴于每个公司都需要搭建一套项目管理软件,之前就有计划写一篇禅道和内部聊天工具的搭建文章,之前公司里使用的是禅道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和mysql
  • zbox 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/,账号和密码默认是admin123456,登录后请务必及时修改

xxd配置文件生成

使用admin账号登录禅道,点击左侧的后台->客户端,在打开的页面中点击参数设置,什么也不用修改,点击保存,接下来点击只下载配置文件按钮,就可以得到xxd.conf文件了

桌面客户端

在后台右上角找到下载入口,如下:

下载安装好之后,打开时服务端地址填你的禅道地址,如:http://192.168.3.3:280/,用户名和密码填禅道里任意用户的用户名和密码,admin账号也可以登录

桌面客户端的功能主要是团队内部聊天工具和内嵌的禅道入口,当有新的任务或bug提交时,相关人员都会收到客户端推送提醒,使用客户端就可以不用在浏览器上打开禅道了

手机APP

在应用市场搜索喧喧,安装打开后服务器端地址和桌面客户端填写的一模一样,在喧喧里能做的事只有内部聊天