时间戳版本，这个版本会随着每次镜像更新会自动生成，如有固定版本需求可以考虑时间戳版本如 18.7 有多个版本18.7-20230918 和 18.7-20230916 ，在0916時，18.7最新版本就等于18.7-20230916, 在0918时18.7版本最新版本等于18.7-20230918

latest版本是最新開源穩定版本鏡像

更多版本Tag可以從https://hub.docker.com/r/easysoft/zentao/tags 浏覽獲取

二、獲取鏡像

推薦從國內鏡像倉庫拉取我們構建好的Docker鏡像

docker pull hub.zentao.net/app/zentao:[TAG]

如需使用指定的版本，可以拉取一个包含版本标签的镜像，在Docker Hub仓库中查看可用版本列表

docker pull hub.zentao.net/app/zentao:[TAG]

三、運行鏡像

禅道容器鏡像做了特殊處理，將所有需要持久化的數據都保存到了 /data 目錄，因此，运行禅道容器镜像，您只需要将持久化目錄挂载到容器的 /data 目錄即可

如果挂载的目錄为空，首次启动会自动初始化相关文件

后续默认使用最新開源版镜像为例, 如果使用docker部署，推荐使用compose管理维护

3.1 使用内置数据库

通过設置 MYSQL_INTERNAL=true 会启动内置的MySQL服務, 默认用戶名为 root,密碼是 123456

推荐使用外部数据库部署，内置数据库仅供測試使用。

docker run -d -v <你的宿主机目錄>/data:/data -p 80:80 -e MYSQL_INTERNAL=true hub.zentao.net/app/zentao

3.2 使用外部数据库

docker run -it \
    -v $PWD/data:/data \
    -p 80:80 \
    -e ZT_MYSQL_HOST=<你的MySQL服務地址> \
    -e ZT_MYSQL_PORT=<你的MySQL服務端口> \
    -e ZT_MYSQL_USER=<你的MySQL服務用戶名> \
    -e ZT_MYSQL_PASSWORD=<你的MySQL服務密码> \
    -e ZT_MYSQL_DB=<禅道数据库名> \
    hub.zentao.net/app/zentao

3.3 使用内置Redis

从 21.2 版本开始，镜像内置Redis服務，可以通过設置 REDIS_INTERNAL=true 环境变量，开启内置的Redis服務，密碼是 pass4Redis

推荐使用外部Redis服務，内置Redis仅供測試使用。

3.4 使用compose运行

示例如下:

services:
# db service for zentao
  zentao-db:
    image: mariadb:10.6
    container_name: zentao-db
    ports:
      - '3306:3306'
    volumes:
      - /data/zentao-mysql:/var/lib/mysql
    environment:
      - MYSQL_ROOT_PASSWORD=pass4Zentao
      - MYSQL_DATABASE=zentao
    networks:
      - zentao-net
# zentao service
  zentao:
    image: hub.zentao.net/app/zentao:21.2
    container_name: zentao
    ports:
      - '80:80'
    volumes:
      - /data/zentao-file:/data
    depends_on:
      - zentao-db
    environment:
      - ZT_MYSQL_HOST=zentao-db
      - ZT_MYSQL_PORT=3306
      - ZT_MYSQL_USER=root
      - ZT_MYSQL_PASSWORD=pass4Zentao
      - ZT_MYSQL_DB=zentao
      - PHP_MAX_EXECUTION_TIME=120
      - PHP_MEMORY_LIMIT=512M
      - PHP_POST_MAX_SIZE=128M
      - PHP_UPLOAD_MAX_FILESIZE=128M
    networks:
      - zentao-net
networks:
  zentao-net:
    driver: bridge

將上面文件保存爲 docker-compose.yml

# 執行  
docker-compose up -d 
# 新版本docker插件方式
docker compose up -d

3.5 完整版compose示例(支持外部数据库和redis)

从21.3开始，如果已经配置了redis相关环境变量，会自动将session存储設置为redis,

services:
# db service for zentao
  zentao-db:
    image: bitnami/mariadb:10.6
    # 国内镜像
    # image: hub.zentao.net/app/mariadb:10.6-bitnami
    container_name: zentao-db
    pull_policy: if_not_present
    restart: always
    volumes:
      - 'zentao_db:/bitnami/mariadb'
      # 使用宿主机目錄挂载数据
      # - '/data/zentao/mariadb:/bitnami/mariadb'
    networks:
      - zentao-net
    environment:
      - MARIADB_USER=my_user
      - MARIADB_PASSWORD=my_password
      - MARIADB_DATABASE=zentao
      - MARIADB_CHARACTER_SET=utf8mb4
      - MARIADB_COLLATE=utf8mb4_unicode_ci
      - MARIADB_ROOT_PASSWORD=pass4Zentao
    healthcheck:
      test: ['CMD', '/opt/bitnami/scripts/mariadb/healthcheck.sh']
      interval: 15s
      timeout: 5s
      retries: 6
  zentao-cache:
    image: bitnami/redis:6.2
    # 国内镜像
    # image: hub.zentao.net/app/redis:6.2-bitnami
    container_name: zentao-cache
    pull_policy: if_not_present
    restart: always
    environment:
      - REDIS_PASSWORD=pass4Zentao
    volumes:
      - 'zentao_cache:/bitnami/redis/data'
      # 使用宿主机目錄挂载数据
      # - '/data/zentao/redis:/bitnami/redis/data'
    networks:
      - zentao-net
# zentao service
  zentao:
    image: easysoft/zentao
    # 国内镜像
    # image: hub.zentao.net/app/zentao
    container_name: zentao
    pull_policy: always
    restart: always
    ports:
      - '80:80'
    volumes:
      - 'zentao_data:/data'
      # 使用宿主机目錄挂载数据
      # - '/data/zentao/data:/data'
    depends_on:
      - zentao-db
      - zentao-cache
    environment:
      - ZT_MYSQL_HOST=zentao-db
      - ZT_MYSQL_PORT=3306
      - ZT_MYSQL_USER=root
      - ZT_MYSQL_PASSWORD=pass4Zentao
      - ZT_MYSQL_DB=zentao
      # 从21.3版本开始，如果已经設置了redis相关环境变量自动开启redis session缓存，可不用配置如下环境变量
      - PHP_SESSION_TYPE=redis
      - PHP_SESSION_PATH=tcp://zentao-cache:6379?auth=pass4Zentao
      - PHP_EXT_REDIS=true
      - PHP_SESSION_REDIS_DATABASE=6 # 如果session是redis默认使用6, session database和cache database不要复用
      # end
      - ZT_REDIS_HOST=zentao-cache
      - ZT_REDIS_PORT=6379
      - ZT_REDIS_PASSWORD=pass4Zentao
      - ZT_REDIS_SERIALIZER=igbinary # php, igbinary
      # - ZT_REDIS_DATABASE=0 # 默认禅道为0
      - ZT_CACHE_ENABLE=true
      - ZT_CACHE_TYPE=redis
      - ZT_CACHE_SCOPE=private
      - ZT_CACHE_LIFETIME=0
      - PHP_MAX_EXECUTION_TIME=120
      - PHP_MEMORY_LIMIT=512M
      - PHP_POST_MAX_SIZE=128M
      - PHP_UPLOAD_MAX_FILESIZE=128M
    networks:
      - zentao-net
      # 指定mac地址設置网络如下，需要删除`- zentao-net`
      # zentao-net:
      # 02:42:ac:11:00:02为示例mac地址
      #   mac_address: 02:42:ac:11:00:02
networks:
  zentao-net:
    driver: bridge
# persistence for mysql, cache and zentao
volumes:
  zentao_db:
  zentao_cache:
  zentao_data:

注意点: 存储根据需要設置，示例使用docker volume，可以选择映射宿主句目錄(如果遇到数据库或者redis没法启动，需要将映射目錄权限設置为777）如果配置有问题，可以参考7.2提供的compose配置示例

四、環境變量

變量名	默認值	說明
DEBUG	false	是否打開調試信息，默認關閉
PHP_SESSION_TYPE	files	php session 类型，files \| redis
PHP_SESSION_PATH	/data/php/session	php session 存储路径
PHP_MAX_EXECUTION_TIME	120	最大執行时间，单位秒，有助于防止有问题程序占尽服務器资源。默认120
PHP_MEMORY_LIMIT	256M	單個php進程允許分配的最大內存
PHP_POST_MAX_SIZE	128M	允許最大Post數據大小
PHP_UPLOAD_MAX_FILESIZE	128M	單個文件上傳的最大值
MYSQL_INTERNAL	false	使用內部的MySQL，默認關閉
REDIS_INTERNAL	false	使用內部的Redis，默認關閉
RR_INTERNAL	true	Roadrunner服務，默认开启
ZT_MYSQL_HOST	127.0.0.1	MySQL 主机地址
ZT_MYSQL_PORT	3306	MySQL 端口
ZT_MYSQL_DB	zentao	zentao數據庫名稱
ZT_MYSQL_USER	root	MySQL用戶名
ZT_MYSQL_PASSWORD	pass4zenTao	MySQL密碼
ZT_REDIS_HOST	默認爲空	Redis連接地址
ZT_REDIS_PORT	6379	Redis端口
ZT_REDIS_PASSWORD	默認爲空	Redis密碼
ZT_REDIS_SERIALIZER	默認爲空，推荐使用igbinary	序列化工具值php, igbinary
LDAP_ENABLED	false	是否啓用LDAP
LDAP_HOST	127.0.0.1	LDAP服務主机地址
LDAP_PORT	389	LDAP服務端口
LDAP_BASEDN	dc=quickon,dc=org	LDAP BaseDN
LDAP_ADMINUSER	cn=admin,dc=quickon,dc=org	LDAP 管理员
LDAP_BINDPASSWORD	pass4zenTao	LDAP Bind 密码
LDAP_USERKEY	uid	LDAP 用戶名称的字段名
LDAP_EMAILKEY	mail	LDAP 用戶邮箱的字段名
LDAP_GROUP	1	默认用戶组(1: 管理员, 2: 研发, 3: 測試, 类比)
LDAP_REALNAME	name	LDAP 用戶真实姓名的字段名
LDAP_REPEATPOLICY	number	LDAP 用戶重名策略，number:数字后缀，dept:部门后缀
LDAP_AUTOCREATE	1	LDAP 用戶自动创建，1:自动创建，0:不自动创建
SMTP_ENABLED	false	啓用SMTP
SMTP_FROMNAME	ZenTao $VERSION	SMTP發件人顯示名稱
SMTP_HOST	127.0.0.1	SMTP 服務主机地址
SMTP_PORT	25	SMTP 服務端口号
SMTP_USER	zentao@easycorp.cn	SMTP發件人郵箱地址
SMTP_PASS	pass4zenTao	SMTP發件人郵箱密碼
IS_CONTAINER	true	是否在容器內運行，zentao更新時使用
PHP_MAX_INPUT_VARS	2000	限定 PHP 脚本所能接收的最大输入变量数量

4.1 Session配置

如果使用内置的 redis 作为 session存储，需要設置3个环境变量：

1. 启用内置 Redis服務：REDIS_INTERNAL=true

2. session 存储类型：PHP_SESSION_TYPE=redis

2. session 存储路径: PHP_SESSION_PATH=tcp://127.0.0.1:6379?auth=pass4Redis

使用内置Redis服務配置PHP session：

dokcer run -it -e REDIS_INTERNAL=true -e PHP_SESSION_TYPE=redis -e PHP_SESSION_PATH=tcp://127.0.0.1:6379?auth=pass4Redis -p 8080:80 hub.zentao.net/app/zentao:latest

使用獨立的MySQL和Redis：

# 运行redis
docker run -d --rm --name redis redis:3.2.12-alpine3.8
# 运行mysql
docker run -d --rm --name mysql -e MYSQL_ROOT_PASSWORD=pass4you -e MYSQL_DATABASE=zentao mariadb:10.6
# 运行禅道
docker run -d --rm --name zentao \
--link mysql \
--link redis \
-e ZT_MYSQL_HOST=mysql \
-e ZT_MYSQL_PORT=3306 \
-e ZT_MYSQL_USER=root \
-e ZT_MYSQL_PASSWORD=pass4you \
-e ZT_MYSQL_DB=zentao \
-e PHP_SESSION_TYPE=redis \
-e PHP_SESSION_PATH=tcp://redis:6379 \
-v /data/zentao:/data \
-p 8088:80 \
hub.zentao.net/app/zentao:latest

4.2 调整最大上传文件的限制

通过設置 PHP_POST_MAX_SIZE 、PHP_UPLOAD_MAX_FILESIZE 这两个环境变量的值来调整最大上传文件的限制，另外，如果考虑到用戶网速的因素，建议把PHP_MAX_EXECUTION_TIME 也加大一些，这样可以保证用戶的文件可以上传完成

# 运行mysql
docker run -d --rm --name mysql -e MYSQL_ROOT_PASSWORD=pass4you -e MYSQL_DATABASE=zentao mariadb:10.6
# 运行禅道
docker run -d --rm --name zentao \
--link mysql \
--link redis \
-e ZT_MYSQL_HOST=mysql \
-e ZT_MYSQL_PORT=3306 \
-e ZT_MYSQL_USER=root \
-e ZT_MYSQL_PASSWORD=pass4you \
-e ZT_MYSQL_DB=zentao \
-e PHP_MAX_EXECUTION_TIME=300 \
-e PHP_POST_MAX_SIZE=512M \
-e PHP_UPLOAD_MAX_FILESIZE=512M \
-v /data/zentao:/data \
-p 8088:80 \
hub.zentao.net/app/zentao:latest

五、Kubernetes通過helm命令安裝開源版示例

helm版本要求高于3.8.2版本，推荐下載最新版本helm

helm repo add zentao https://hub.zentao.net/chartrepo/stable 
helm repo update
helm search repo zentao/zentao
helm upgrade -i zentao zentao/zentao --set ingress.enabled=true --set ingress.host=zentao.example.local

zentao/zentao 開源版本
zentao/zentao-max 旗艦版本
zentao/zentao-biz 企業版本
zentao/zentao-ipd 旗艦版本
zentao/zentaopaas devops版本

注意: 如果mysql或者redis没法正常启动，查看日志提示持久化目錄权限问题，需要保证目前权限777即可；如果禅道遇到没有相关权限的话，卸载重新安装，在pod启动完成后先将/data目錄给予777权限 chomd 777 -R /data, 然后再走安装引导流程

5.1 高级自定义配置

# 下載zentao charts
helm pull zentao/zentao --untar 
# 自定义配置 zentao/values.yaml为custom.yaml(只自定义原配置需要修改的值) 
helm upgrade -i zentao zentao/zentao -f custom.yaml
# 给个简单示例，如果禅道開源版我想禁用NodePort
方法1:
helm upgrade -i zentao zentao/zentao --set service.type=ClusterIP
方法2:
helm upgrade -i zentao zentao/zentao -f custom.yaml
# cat custom.yaml
service:
  type: ClusterIP

六、版本升級

目前容器鏡像已做特殊處理，同一發行版可以直接修改鏡像版本號直接升級

七、其他

7.1 绑定IP和MAC地址

# 创建docker网络, ip子网地址示例172.172.172.0/24，网络驱动名示例zentao-net
docker network create --subnet=[ip范围] [网络驱动名] 
# 启动容器指定
docker run \
--name [容器名] \
-p [主机端口]:80 \
--network=[网络驱动名] \
--ip [容器IP] \
--mac-address [mac地址] \
-v [主机禅道目錄]:/data \
-e MYSQL_INTERNAL=true \
-d hub.zentao.net/app/zentao:[镜像标签]

7.2 附录

Docker方式部署禅道

easysoft/zentao鏡像

compose配置示例

禅道産品
禅道開源版禅道企業版禅道旗艦版禅道IPD版
核心功能
産品管理項目管理質量管理效能管理
使用文檔
基本版手冊企業版手册旗艦版手册 IPD版手冊開發中心手冊
幫助中心
积分問答常見問題論壇交流使用視頻 Gitee GitHub
關于我們
關于我們禅道軟件最新動態禅道活動
禅道社區
禅道博客積分排行積分商城禅道書院
聯系方式
聯系人：金娟電話：18562856230 微信：18562856230 Q Q：1826606239
北京、上海、深圳分部

友情鏈接： ZTF自动化測試框架 ZenData測試数据生成器喧喧IM 敏捷開發敏捷咨詢測試窝悅庫網盤 Ledge知識平台渠成軟件 ZDOO全協同企業管理軟件融管理社區 ZenDAS數據分析工具 ZenShot跨平台截圖工具飛信釘即時通訊解決方案項目管理 IPD學習網 PMP百科網艾體驗創無記2049

午夜伧理A级日韩1片

本篇目錄

本篇目錄

一、鏡像地址

二、獲取鏡像

三、運行鏡像

3.1 使用内置数据库

3.2 使用外部数据库

3.3 使用内置Redis

3.4 使用compose运行

3.5 完整版compose示例(支持外部数据库和redis)

四、環境變量

4.1 Session配置

4.2 调整最大上传文件的限制

五、Kubernetes通過helm命令安裝開源版示例

5.1 高级自定义配置

六、版本升級

七、其他

7.1 绑定IP和MAC地址

7.2 附录

禅道産品

核心功能

使用文檔

幫助中心

關于我們

禅道社區

聯系方式

北京、上海、深圳分部