一、禅道软件简介
禅道项目管理软件是一款国产开源项目管理软件。它集项目集管理、产品管理、项目管理、质量管理、DevOps、知识库、BI效能、工作流、学堂、反馈管理、组织管理和事务管理于一体,是一款专业的研发项目管理软件,完整覆盖了研发项目管理的核心流程。
禅道目前提供多种解决方案: 规模化敏捷解决方案、DevOps一体化解决方案、自动化测试解决方案,研发效能解决方案、禅道基于IM+AI的研发协同解决方案、企业创新能力解决方案、企业决策分析解决方案,让每一个项目都可实现高效管理。
二、安装方式
(一)使用禅道智能应用平台安装
禅道智能应用平台是一个开源轻量级应用交付平台。通过应用市场,可以一键安装企业级软件,不仅具备高可用特性,还支持自动与手动备份,当有新版本发布时,可以查看软件的更新日志,决定是否升级,快捷方便。
禅道智能应用平台特点
- 云原生应用市场。这是禅道智能应用平台的核心功能,用户可以通过应用市场,选择和安装需要的应用。
- 多租户。平台支持多租户管理,用户可将应用装在不同空间,各空间有独立资源配额与权限控制规则。
- 服务管理。即对从应用市场安装的应用进行管理,可进行启动、关闭、重启、删除、升级等操作,查看输出日志。服务原生具高可用特性(多节点集群),单节点时能在服务出问题时重启。
- 域名管理。服务安装时分配默认域名,可修改。若有自己的 DNS 服务,可将泛解析设到平台,用自己的域名地址。
- 平台管理。平台集成命令行管理工具,支持一键安装与卸载及集群节点扩容,能方便查看后台服务运行状态。
在Linux系统中安装禅道智能应用平台
如果您刚接触禅道智能应用平台,建议使用我们提供的 All-in-One 安装模式, 它能够帮助您零配置快速部署。
1. 准备 Linux 机器
若要以 All-in-One 模式进行安装,您仅需参考以下对机器硬件和操作系统的要求准备一台主机。
1.1 硬件推荐配置
操作系统 | 最低配置 |
Debian Bookworm(推荐) Bullseye | 2 核 CPU, 4 GB 内存, 40 GB 磁盘空间 |
Ubuntu 22.04, 20.04 | 2 核 CPU, 4 GB 内存, 40 GB 磁盘空间 |
1.2 节点要求
- 节点必须能够通过
SSH
连接。 - 节点上可以使用
sudo
/curl
等基础命令。
1.3 容器运行时
您的集群必须有一个可用的容器运行时。 如果您使用 q 搭建集群, 会探测本地是否已安装docker, 如果已安装docker则使用docker, 否则将使用默认内置的containerd
1.4 网络和DNS要求
- 建议您的操作系统处于干净状态(不安装任何其他软件),否则可能会发生冲突。
- 支持访问公网,如果有网络访问控制,需要放行
*.qucheng.com
/*.qucheng.cn
2. 下载安装禅道智能应用平台命令行工具
curl -sfL https://pkg.qucheng.com/quickon/get.sh | sh -
执行脚本完成后, 检查是否安装成功
q version
3. 开始安装
在本快速入门教程中, 您只需执行一行命令即可进行安装, 其模板如下所示:
q init -p quickon
3.1 开源版
一般来说,对于All-in-One安装, 不需要修改任何配置。如果你想自定义集群网络、访问域名等高级的功能,可以通过参数来配置:
# 示例, 更多参数参考使用 q init --help
q init -p quickon --domain <自定义域名>
4. 验证安装结果
输出信息会显示Web控制台的IP地址和端口号, 默认的端口是32379
您可能需要配置端口转发规则并在安全组中开放端口,以便外部用户访问控制台。
(二)禅道官网下载安装
如何用Windows安装禅道
1. 下载windows一键安装包
进入禅道官网,进入 下载中心 ,下载对应版本的windows一键安装包。
2. 运行安装包
双击下载的文件解压到某一分区的目录下,进入 ZenTao 文件夹,点击 ZenTao.exe 文件启动面板。
注意:若安装包所在路径包含中文等特殊符号,启动禅道时会出现错误提示。需要修改路径后重新启动禅道。
3. 设置
点击设置按钮,可以卸载服务、查看服务、设置语言、查看帮助、检查更新、切换主题操作。
卸载服务时,会卸载运行控制面板里所有的服务。
4. Apache服务相关操作
Apache可以进行查看日志、修改端口、修改密码、安装服务、卸载服务、停止服务、启动服务、安装服务操作。
以上操作中除了查看日志,修改端口、重新安装都会重新启动Apache服务。
修改端口时,会自动检查端口是否被占用,如果被占用会有相应的提示并不可修改。
相关的操作,都可以通过查看日志或者右侧的面板日志来查看到。
5. Apache用户访问验证
系统默认不启用Apache用户访问验证,如果不需要,可跳过这一步。
如需Apache用户访问验证,需要勾选启用Apache用户访问验证,点击【访问禅道】,进入验证页面。在验证页面中输入用户名和密码,点击【登录】。
注:Apache用户访问验证的初始账号:zentao,密码:123456。
6. 登录禅道
Apache用户访问验证成功后,进入欢迎页面,点击页面中的【试用按钮】,进入登录页面。
在登录页面中输入用户名和密码,点击按钮【登录】。
初次默认的管理员账号是:用户名:admin 密码:123456。
7. 修改禅道密码
超级管理员登录禅道后,系统会自动检测密码安全级别,提示用户修改密码。按照提示进行修改后,点击按钮【保存】,即为修改成功。
如果需要维护密码安全设置可以到 后台—安全 页面中进行修改。
注意:从禅道18.12系列版本开始,禅道的Windows一键安装包不再集成git和svn。
如果需要使用集成git和svn功能,可下载集成包覆盖到禅道一键安装包的代码目录。
下载地址:https://dl.zentao.net/zbox/win/vcsbundle-2024.03.1-win64.exe
下载解压直接覆盖后,可以在ZenTao/bin 下查看到git 和sliksvn的文件夹。
(三)使用Docker 安装禅道
1. 环境准备
环境与配置 | 测试环境 | 推荐配置 | 备注 |
Docker | 20版本 | 20版本以上 | |
操作系统 | Linux或Windows | Linux | 镜像支持 x86_64 和 arm64 架构 |
CPU | 1核心 | 2核心 | |
内存 | 1G | 4G | |
硬盘 | 10G | 50G以上 |
注意:
- 生产环境可以按照禅道的用户数以及项目的规模增减配置。
- 生产环境建议运行在Linux系统
查看Docker版本:
docker -v
Docker version 27.0.3, build 7d4bcd8
查看CPU架构:
uname -a
Linux nat7 6.6.13+bpo-amd64 #1 SMP PREEMPT_DYNAMIC Debian 6.6.13-1~bpo12+1 (2024-02-15) x86_64 GNU/Linux
2. 下载禅道镜像
目前支持在线下载和离线导入两种部署禅道镜像的方式,可根据自己环境进行选择。
2.1 在线下载
禅道镜像已放于Docker Hub上,地址为:https://hub.docker.com/r/easysoft/zentao/tags
可根据所需版本拉取对应版本的镜像,默认latest为禅道开源最新版本。
sudo docker pull [镜像名]:[镜像标签]
例如拉取禅道开源版20.3版本命令如下:
sudo docker pull hub.zentao.net/app/zentao:20.3
注意:
- 为了方便国内用户拉取镜像,每次发版会在docker官方镜像仓库和禅道镜像仓库都推送镜像。
禅道版本和镜像tag对应关系如下:
禅道版本 | 镜像标签 |
开源版 | 以数字开头,如20.3 |
企业版 | 以biz开头,如biz10.2 |
旗舰版 | 以max开头,如max5.2 |
IPD版 | 以ipd开头,如ipd2.2 |
2.2 离线导入
导入镜像步骤如下:
- 下载禅道镜像归档压缩包到U盘,或者刻录成光盘。
- 将U盘或光盘的禅道镜像归档复制到离线主机的临时目录, 如/tmp
- 解压并载入镜像:
# 命令实例
sudo gunzip -c [镜像归档文件名] | docker load
# 如:
sudo gunzip -c zentao_20.3.tar.gz | docker load
da07e39e2957: Loading layer [======================>] 85.5kB/85.5kB
feab8630a9c5: Loading layer [======================>] 11.73MB/11.73MB
d7508f92bff7: Loading layer [======================>] 86.37MB/86.37MB
5ca65d83e7b7: Loading layer [======================>] 80.38MB/80.38MB
ed0cfb41d961: Loading layer [======================>] 2.673MB/2.673MB
c00e8d737e49: Loading layer [======================>] 10.3MB/10.3MB
a186fa70a0c6: Loading layer [======================>] 7.121MB/7.121MB
95e38b2ff244: Loading layer [======================>] 7.473MB/7.473MB
f4afc75280d8: Loading layer [======================>] 191.7MB/191.7MB
60721d394939: Loading layer [======================>] 89.6kB/89.6kB
6db6be18e64c: Loading layer [======================>] 15.87kB/15.87kB
cf41eda4f35b: Loading layer [======================>] 191.7MB/191.7MB
Loaded image: hub.zentao.net/app/zentao:20.3
3. 启动禅道
3.1 创建docker网络驱动
sudo docker network create --subnet=[ip范围] [网络驱动名]
- ip范围:例如172.172.172.0/24的意思是,IP可以指定范围为172.172.172.1到172.172.172.254;
- 网络驱动名:创建的网络驱动名,可随意指定;
例如:
sudo docker network create --subnet=172.172.172.0/24 zentaonet
3.2 启动禅道容器
命令格式如下:
sudo docker run \
--name [容器名] \
-p [主机端口]:80 \
--network=[网络驱动名] \
--ip [容器IP] \
--mac-address [mac地址] \
-v [主机禅道目录]:/data \
-e MYSQL_INTERNAL=true \
-d hub.zentao.net/app/zentao:[镜像标签]
参数说明:
- 容器名:启动的容器名字,可随意指定;
- 主机端口:主机端口为web访问端口;
- 网络驱动名:上文创建的网络驱动名
zentaonet
; - 容器IP:在网络驱动范围内选择一个作为该容器的固定ip;
- mac地址:指定固定的mac地址,建议范围为02:42:ac:11:00:00 到 02:42:ac:11:ff:ff;
- 主机禅道目录:必须指定,方便附件等数据的持久化;
- MYSQL_INTERNAL=true:启用容器内置MySQL,默认用户名为
root
,密码是123456
- 镜像标签:禅道版本
例如:在主机上创建空目录/data/zentao
,执行如下命令
sudo docker run \
--name zentao \
-p 80:80 \
--network=zentaonet \
--ip 172.172.172.172 \
--mac-address 02:42:ac:11:00:00 \
-v /data/zentao:/data \
-e MYSQL_INTERNAL=true \
-d hub.zentao.net/app/zentao:20.3
注意:
- 如果需要远程连接数据库,可以增加一个端口映射
-p [主机端口]:3306
- 如果在单个主机上部署多个禅道系统,只需要指定不同的 [容器名]、[主机端口]、[容器IP]、[mac地址]、[禅道目录]即可部署多个禅道系统,例如:
sudo docker run \
--name zentao2 \
-p 8080:80 \
-p 3306:3306 \
--network=zentaonet \
--ip 172.172.172.173 \
--mac-address 02:42:ac:11:00:01 \
-e MYSQL_INTERNAL=true \
-v /data/zentao2:/data \
-d hub.zentao.net/app/zentao:20.3
3.3 查看容器是否启动成功
执行如下命令查看容器是否启动成功,如果没有则启动失败,去掉-d选项进行前台运行调试容器,如有任何问题请咨询我们。
# 查看禅道容器
docker ps | grep zentao
# 查看禅道容器日志
docker logs -f zentao
4. 安装禅道
浏览器直接访问 http://宿主机ip:宿主机映射端口
最后根据提示进行操作,即可安装成功。
欢迎下载使用禅道,如果在使用过程过中遇到任何问题,欢迎联系我们,我们会给予您及时的帮助。