禅道軟件安裝教程
原創-
2024-08-02 11:04:00
-
6790
本篇目錄
一、禅道軟件簡介
禅道項目管理软件是一款国产开源項目管理软件。它集項目集管理、産品管理、項目管理、質量管理、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 version3. 开始安装
在本快速入门教程中, 您只需执行一行命令即可进行安装, 其模板如下所示:
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:宿主机映射端口
最後根據提示進行操作,即可安裝成功。
欢迎下載使用禅道,如果在使用过程过中遇到任何问题,欢迎聯系我們,我们会给予您及时的幫助。
掃碼添加微信,解決您的使用問題
-
禅道産品
禅道開源版 禅道企業版 禅道旗艦版 禅道IPD版 -
核心功能
産品管理 項目管理 質量管理 效能管理 -
使用文檔
基本版手冊 企業版手册 旗艦版手册 IPD版手冊 開發中心手冊 -
幫助中心
积分問答 常見問題 論壇交流 使用視頻 Gitee GitHub -
關于我們
關于我們 禅道軟件 最新動態 禅道活動 -
禅道社區
禅道博客 積分排行 積分商城 禅道書院 -
聯系方式
聯系人:楊苗 電話:13165050229 微信:13165050229 Q Q:2692096539北京、上海、深圳分部