Ubuntu环境Docker安装禅道项目管理软件开源版

文章目录

前言
一、部署前准备
二、安装部署ZenTao
总结

前言

ZenTaoPMS（禅道项目管理软件）是由易软天创公司开发的开源项目管理软件，集产品管理、项目管理、质量管理、文档管理、组织管理及事务管理于一体，主要用户为软件供应链企业。其基于LGPL协议开源，允许用户免费获取并修改源代码。

本文主要介绍在Ubuntu系统环境下，通过docker来部署禅道项目管理软件。

一、部署前准备

系统环境：Ubuntu 20.04 LTS
部署环境：已安装Docker CE
硬件要求：
CPU‌：2核以上，建议2.0GHz+
内存‌：4GB及以上
硬盘‌：建议 ≥100GB（尤其需存储大量附件或文档时）‌

二、安装部署ZenTao

1.获取镜像

bash 复制代码

#1.拉取最新版镜像
docker pull easysoft/zentao:latest
#2.拉取指定版本镜像（以21.2为例）
docker pull easysoft/zentao:21.2

2.运行服务

运行容器方案1，直接使用docker命令
新建本地data文件目录：

bash 复制代码

#新建文件夹，可以根据自己的实际情况创建本地data文件路径
mkdir -p /opt/zentao/mysqldata
# 检查 data 目录权限
ls -ld /opt/zentao/mysqldata
# 如果权限不足，修改为 777（临时测试）
chmod -R 777 /opt/zentao/mysqldata
# 如果权限不足
chown -R 1000:1000 /opt/zentao/

运行部署zentao：

bash 复制代码

#运行部署zentao
docker run -d \
  --name zentao-t \
  -v /home/zentao/mysqldata:/data \
  -p 8088:80 \
  -e MYSQL_INTERNAL=true \
  easysoft/zentao:latest 
#说明：
--name:容器名称
/opt/zentao/mysqldata：本地存储数据文件路径
MYSQL_INTERNAL=true：使用内置数据库
easysoft/zentao:latest：镜像名称

运行容器方案2，通过Docker Compose 管理 Zentao 和 MySQL 分离部署

bash 复制代码

#创建
mkdir -p /opt/zentao/{mysqldata,mysql/conf,zentaopms}
# 如果权限不足，修改为 777（临时测试）
chmod -R 777 /opt/zentao/mysqldata
# 如果权限不足
chown -R 1000:1000 /opt/zentao/

检查 Docker Compose 版本

bash 复制代码

#查看Docker Compose
docker-compose --version  # V1（已弃用）
docker compose version    # V2（推荐）
#如果目前是v1版，建议升级到v2
apt-get install docker-compose-plugin
#如果没有安装，运行安装Docker Compose
apt install docker-compose-v2

编写docker-compose.yml文件

bash 复制代码

#使用vim命令创建docker-compose.yml文件
vim /opt/zentao/docker-compose.yml
#复制以下配置到docker-compose.yml文件
services:
  mysql:
    image: mysql:8.0
    container_name: zentao-mysql
    volumes:
      - /opt/zentao/mysqldata:/var/lib/mysql  # 数据持久化
      - /opt/zentao/mysql/conf:/etc/mysql/conf.d  # 自定义配置
    environment:
      - MYSQL_ROOT_PASSWORD=123456  # 替换为强密码
      - MYSQL_DATABASE=zentao
      - MYSQL_USER=zentao
      - MYSQL_PASSWORD=zentao
      - TZ=Asia/Shanghai  # 时区配置
    command:
      - --default-authentication-plugin=mysql_native_password
      - --character-set-server=utf8mb4
      - --collation-server=utf8mb4_unicode_ci
    ports:
      - "3306:3306"
    restart: always

  zentao:
    image: easysoft/zentao:latest
    container_name: zentao
    ports:
      - "18088:80"
    volumes:
      - /opt/zentao/zentaopms:/www/zentaopms
    environment:
      - MYSQL_HOST=mysql  # 连接 Docker Compose 内部的 MySQL 服务
      - MYSQL_PORT=3306
      - INSTALL_DB=0  # 不自动初始化数据库（由 mysql 服务初始化）
    depends_on:
      - mysql
    restart: always

启动服务

bash 复制代码

#切换到/opt/zentao目录
cd /opt/zentao
#启动服务
docker compose up -d   # docker compose v2 
#完成启动后，查看容器运行
docker ps
#查看zentao容器运行日志
docker logs -f  zentao

使用docker logs -f zentao查看日志发现如下状况，就可以网页访问配置使用zentao了

3.配置Zentao

根据安装时配置的端口，在局域网内，使用服务器的ip地址+配置端口，打开网页进行访问，如下所示，点击开始安装：
选择已阅并同意，点击下一步
系统检查全部通过，点击下一步
生成配置文件，点击下一步
等待数据库自动配置成功，点击下一步
保存配置文件，点击下一步
设置公司名称和管理员账号密码，点击保存
刷新访问到管理后台主页

总结

以上就是ZenTaoPMS（禅道项目管理软件）在Ubuntu环境下通过Docker安装部署的详细步骤。