禅道作为一个开源的项目管理工具,其功能足以满足日常开发、运维、测试及产品版本迭代,重要的是免费、可定制,好处不用多数,业内用的也比较广泛(主要是互联网企业)
关于禅道的部署可以参考官网:https://www.zentao.net/book/zentaopmshelp/405.html
有了docker,使得禅道的部署变得非常简单,只需如下几个步骤即可完成禅道的本地化部署:
- 将镜像pull下来;
- 利用镜像启动容器;
- 打开界面做简单的配置即可使用。
如果你只是测试或小小的应用一下,官网的文档足以解决我们的问题了,笔者也是根据官网部署的。
这里简单梳理下部署步骤,做个记录的同时也分享给各位同学。
1. 运行环境准备
既然是docker部署禅道,首先你的环境要符合docker运行环境,官网推荐docker最好是18版本以上,操作系统也最好是7.x,安装前最好更新系统到最新版本。docker安装最新版即可。
查看docker版本
docker -v
2. 禅道镜像下载
我们可以直接在线下载或导入镜像两种方式获取到禅道的镜像,根据我们的服务器环境(是否能够访问公网)自行选择适合自己的就好,结果是一样的,就是把禅道镜像拉取到本地。
这里以部署开源版禅道12.3.3为例,其他版本类似。
2.1 在线下载镜像
禅道镜像已放于Docker Hub上,地址为: https://hub.docker.com/r/easysoft/zentao/tags
拉取禅道开源版12.3.3版本命令如下: docker pull easysoft/zentao:12.3.3
2.2 离线导入镜像
离线镜像获取
# 下载禅道镜像 wget https://www.zentao.net/dl/docker/zentao_12.3.3.tar.gz # 将镜像导入到本地 gunzip -c zentao_12.3.3.tar.gz | docker load
导入后,查看本地镜像
[root@CN-HZ-Zentao ~]# docker image ls REPOSITORY TAG IMAGE ID CREATED SIZE easysoft/zentao 12.3.3 6b51979725b5 10 months ago 633MB
3. 启动禅道容器
3.1 启动命令
# 官方给的命令: docker run --name [容器名] -p [主机端口]:80 --network=[网络驱动名] --ip [容器IP] --mac-address [mac地址] -v [主机禅道目录]:/www/zentaopms -v [主机mysql目录]:/var/lib/mysql -e MYSQL_ROOT_PASSWORD=[数据库密码] -d easysoft/zentao:[镜像标签] ## 启动参数说明: # 容器名:启动的容器名字,可随意指定; # 主机端口:主机端口为web访问端口; # 网络驱动名:刚刚创建的网络驱动名; # 容器IP:在网络驱动范围内选择一个作为该容器的固定ip; # mac地址:指定固定的mac地址,建议范围为02:42:ac:11:00:00 到 02:42:ac:11:ff:ff; # 主机禅道目录:必须指定,方便禅道代码、附件等数据的持久化,非升级情况需指定空目录; # 主机mysql目录:必须指定,方便禅道数据持久化,非升级情况需指定空目录; # 数据库密码: 容器内置mysql用户名为root,默认密码123456,如果不修改可以不指定该变量,如果想更改密码可以设置 MYSQL_ROOT_PASSWORD变量来更改密码; # 镜像标签:禅道版本。 # 实际上我们只需要按如下命令启动容器即可: docker run --name zentao-server --restart always -d -p 80:80 -v /ichint/zentaopms:/www/zentaopms -v /ichint/mysqldata:/var/lib/mysql -e MYSQL_ROOT_PASSWORD=123456 easysoft/zentao:12.3.3 ## 其中 --restart always 意思是在docker容器异常时自动重启。
3.2 查看是否启动成功
[root@CN-HZ-Zentao ~]# docker ps CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 8c24dfafdbef easysoft/zentao:12.3.3 "/.docker_init.sh" 6 weeks ago Up 6 weeks 0.0.0.0:80->80/tcp, :::80->80/tcp zentao-server
4. 安装禅道
浏览器直接访问 http://宿主机ip:宿主机映射端口
然后点击【登录禅道管理系统】,输入帐号密码,就可以登录我们的禅道了。
5. 存在的问题及解决
问题1:容器内部的时间和宿主机时间不一致
问题2:如果想在外部连接禅道数据库是没办法的
这就需要我们对镜像进行定制和修改。
针对问题1,我们只需要在启动禅道容器的时候,加上参数: -v /etc/localtime:/etc/localtime:ro,即:
docker run --name zentao-server --restart always -d -p 80:80 -v /ichint/zentaopms:/www/zentaopms -v /ichint/mysqldata:/var/lib/mysql -v /etc/localtime:/etc/localtime:ro -e MYSQL_ROOT_PASSWORD=123456 easysoft/zentao:12.3.3
针对问题2,我们需要按如下步骤进行操作:
主要思路是:
- 进入容器
- 修改MySQL默认配置
- 授权登录
- 提交修改生成新的镜像
- 删除之前启动的容器
- 用新的镜像重新启动容器
操作过程中,数据不会丢失,这点不需要担心,因为我们将数据目录都映射到宿主机中了。
## 开启docker部署的禅道数据库外部登录 # 进入容器 docker exec -ti zentao-server bash 找到MariaDB的配置文件"/etc/mysql/mariadb.conf.d/50-server.cnf",把"bind-address...."一行注释掉 接下来还要给账户分配权限,进入mysql命令行界面,输入: mysql -uroot -p 输入密码: ## 在容器内的MySQL中执行如下命令: select User, host from mysql.user; GRANT ALL PRIVILEGES ON *.* TO 'root'@'%' IDENTIFIED BY '123456' WITH GRANT OPTION; FLUSH PRIVILEGES; # 输入exit,退出MySQL,再次输入exit退出容器,然后将刚才对容器的修改进行提交,生成我们自己定义的镜像 docker commit 8c24dfafdbef myzentao:v2 # 然后关闭并删除旧的容器 docker stop zentao-server docker rm zentao-server # 或者:docker rm -f zentao-server # 最后用我们自定义的镜像重新启动一个新的容器,并将数据库端口也映射出来 docker run --name zentao-server --restart always -d -p 80:80 -p 3306:3306 -v /ichint/zentaopms:/www/zentaopms -v /ichint/mysqldata:/var/lib/mysql -v /etc/localtime:/etc/localtime:ro -e MYSQL_ROOT_PASSWORD=123456 -d newzentao:v2
这样我们就可以在外部登录禅道的数据库了。