领先的项目协作管理软件OpenProject

在这里插入图片描述

本文软件由网友 不长到一百四誓不改名 推荐;

什么是 OpenProject ?

OpenProject 是一个开源、基于 Web 的项目管理系统,提供了免费的社区版和收费的企业版。OpenProject 拥有完善的文档,API,及丰富的功能,可以为项目团队提供整个项目生命周期的支持,因而成为企业的一个很好的选择。

前言

使用 Docker 安装 OpenProject 有两种方式:一种是多容器方式,适合生产环境,另一种是单容器方式,安装简单但不适应于生产环境

群晖本身并不适合作为生产环境的服务器,所以这次老苏选择了单容器方式安装,用于体验功能还是可以的

其实两种方式老苏都尝试了,但是在日常运行的小机器上均失败了,老苏猜测可能是两个原因:

  • 机器内存太小

熟悉老苏的读者都知道,老苏日常安装的小机器只有 4G 内存,很多时候安装失败,可能都是这个原因导致的;

  • 无法生成足够的随机数

老苏在跟踪容器的日志时,发现有一条👇下面这样的错误

rake aborted!  
failed to get urandom

最近几个基于 Ruby 的项目都是这个错误,所以老苏咨询了 ChatGPT,它给出的结论是:因为系统缺乏随机性,无法生成足够的随机数。

老苏用 ChatGPT 给的命令查了一下群晖系统的熵池状态,按照 ChatGPT 的说法,如果该值小于 1000,则表示熵池的可用熵值不足,就可能会导致 failed to get urandom 错误。

cat /proc/sys/kernel/random/entropy_avail

在日常的小机器上,这个值只有 130

而在另一台上,这个值超过了 1000

在这里插入图片描述

至于原因,老苏猜测可能跟系统内核有关系,这也让老苏联想到了,原本基于 Apache 的镜像总会遇到的随机数错误: Function not implemented: AH00141: Could not initialize random number generator

虽然跟ChatGPT 经过了多轮交互,但是给的方案并不能解决这个问题,它提出的办法是通过增加系统负载来增加系统熵池的可用熵值,从而有助于解决 failed to get urandom 错误。

例如:

# 安装群晖诊断工具 Diagnosis Tool
sudo synogear install

# 在 60 秒内使用 4 个工作进程以随机写入方式写入 4GB 的数据。
sudo fio --name=test --ioengine=sync --rw=randwrite --bs=4k --numjobs=4 --size=4G --runtime=60 --time_based

但是老苏发现并没有什么用,和之前的 AH00141 一样,最后还是只能换机器安装

安装

终于到了安装环节了,还是在群晖上以 Docker 方式安装。

在注册表中搜索 openproject ,选择第一个 openproject/community,版本选择 12

之所以选 12 而不是更高版本,是因为在这里,12 相当于往常使用的 latest

docker 文件夹中,创建一个新文件夹 openproject,并在其中建两个子文件夹,分别是 assetspgdata

文件夹装载路径说明
docker/openproject/assets/var/openproject/assets存放资源,例如上传的附件等
docker/openproject/pgdata/var/openproject/pgdata存放数据库

端口

本地端口不冲突就行,不确定的话可以用命令查一下

# 查看端口占用
netstat -tunlp | grep 端口号
本地端口容器端口
709080

默认情况下,容器对外暴露了 PostgreSQL数据库端口5432

老苏觉得没必要,只留下了 Web 端口

环境

可变
OPENPROJECT_HOST__NAMEurl 地址,可以是 IP 也可以是域名
OPENPROJECT_HTTPS是否使用 https 协议
OPENPROJECT_SECRET_KEY_BASE密码,可以用openssl rand -hex 64 生成

SECRET_KEY 可以用 Vaultwarden 的密码生成器,也可以用 openssl rand -hex 64

老苏只修改了几个必要的环境变量

更多的环境变量,可以去看官方文档:https://www.openproject.org/docs/installation-and-operations/configuration/environment/

命令行安装

如果你熟悉命令行,可能用 docker cli 更快捷

# 新建文件夹 openproject 和 子目录
mkdir -p /volume1/docker/openproject/{assets,pgdata}

# 进入 openproject 目录
cd /volume1/docker/openproject

# 运行容器(局域网)
docker run -d \
   --restart unless-stopped \
   --name openproject \
   -p 7090:80 \
   -v $(pwd)/pgdata:/var/openproject/pgdata \
   -v $(pwd)/assets:/var/openproject/assets \
   -e OPENPROJECT_HOST__NAME=192.168.0.199:7090 \
   -e OPENPROJECT_HTTPS=false \
   -e OPENPROJECT_SECRET_KEY_BASE=$(openssl rand -hex 64) \
   openproject/community:12

也可以用 docker-compose 安装,将下面的内容保存为 docker-compose.yml 文件

version: '3'

services:
  cherry:
    image: openproject/community:12
    container_name: openproject
    restart: unless-stopped
    ports:
      - 7090:80
    volumes:
      - ./pgdata:/var/openproject/pgdata
      - ./assets:/var/openproject/assets
    environment:  
      - OPENPROJECT_HOST__NAME=192.168.0.199:7090 
      - OPENPROJECT_HTTPS=false
      - OPENPROJECT_SECRET_KEY_BASE=cb160b11cfaa0419cc979050194fbe974e5151cb11a15241679618d1c12338aea29d00479841376bea0204a3ef3be74fb9c3adb6f0739ddcd712cf1ef7efdc3b

然后执行下面的命令

# 新建文件夹 openproject 和 子目录
mkdir -p /volume1/docker/openproject/{assets,pgdata}

# 进入 openproject 目录
cd /volume1/docker/openproject

# 将 docker-compose.yml 放入当前目录

# 一键启动
docker-compose up -d

运行

第一次启动会花费一些时间

CPU 占用会先飙升,然后逐渐降低

在这里插入图片描述

但是内存会逐渐上升

当日志中看到 Listening on http://0.0.0.0:8080 时,就可以开始访问了

在这里插入图片描述

在浏览器中输入 http://群晖IP:7090 就能看到主界面

在这里插入图片描述

点右上角登录

默认的账号:admin,密码:admin

在这里插入图片描述

第一次需要修改密码

可以选择简体中文

跟着设置向导,完成之后就可以开始使用了

系统提供了演示两个项目

在这里插入图片描述

其中 Demo project 是经典项目管理,而 Scrum project 则是敏捷管理

反向代理

假设我们使用域名 https://project.laosu.ml:444

Openproject 的设置

docker cli 为例,需要修改环境变量,其中:

  • OPENPROJECT_HOST__NAME:主机名改为了域名,有端口的也要的带上;
  • OPENPROJECT_HTTPS:要启动 https 协议,所以要设为 true
# 运行容器(互联网)
docker run -d \
   --restart unless-stopped \
   --name openproject \
   -p 7090:80 \
   -v $(pwd)/pgdata:/var/openproject/pgdata \
   -v $(pwd)/assets:/var/openproject/assets \
   -e OPENPROJECT_HOST__NAME=project.laosu.ml:444 \
   -e OPENPROJECT_HTTPS=true \
   -e OPENPROJECT_SECRET_KEY_BASE=$(openssl rand -hex 64) \
   openproject/community:12

当然你已经安装过的话,可以直接编辑、修改环境变量

在这里插入图片描述

npm 的设置

域名局域网地址备注
project.laosu.ml192.168.0.199:7090Openproject 访问地址

npm 中的设置

SSL 都勾选了

在这里插入图片描述

如果只是这么设置,可以正常打开 https://project.laosu.ml:444,但是在登录时会显示错误

  • 英文会显示👇
[Error 422] Unable to verify Cross-Site Request Forgery token. Did you try to submit data on multiple browsers or tabs? Please close all tabs and try again.
  • 中文会显示👇
[错误 422] 无法验证跨站请求伪造令牌。您是否曾尝试在多个浏览器或选项卡上提交数据?请关闭所有选项卡并重试。

所以老苏又掏出了那段百试百灵的 截端口 代码放入了 Advanced

location / {  
    proxy_set_header Host $host:444;  
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;  
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header X-Forwarded-Protocol $scheme;
    proxy_pass  http://192.168.0.199:7090;  
    proxy_redirect http:// https://;  
}

果然问题解决了 😂

参考文档

opf/openproject: OpenProject is the leading open source project management software.
地址:https://github.com/opf/openproject

opf/openproject-deploy: Recipes to deploy OpenProject with Docker, Docker Compose, Kubernetes, etc.
地址:https://github.com/opf/openproject-deploy

OpenProject - open source project management software
地址:https://www.openproject.org/

Install OpenProject with Docker
地址:https://www.openproject.org/docs/installation-and-operations/installation/docker/

评论 2
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

杨浦老苏

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值