本教程适用于以下操作系统版本

  • Debian 12 (Bookworm)
  • Debian 11 (Bullseye)
  • Debian 10 (Buster)

本页内容

  • 准备工作
  • 安装 OpenProject
  • 配置 OpenProject
  • 访问 OpenProject

OpenProject 是一款用 Ruby on Rails 和 AngularJS 编写的项目管理软件。它主要是 ChiliProject 的一个分支,而 ChiliProject 又源自 Redmine。它可以用于跨团队和部门的项目管理,并提供丰富的功能,例如敏捷与 Scrum、缺陷跟踪、Wiki、论坛、任务管理、团队协作、项目路线图以及版本发布管理。

本教程将引导你在 Debian 12 服务器上完成 OpenProject 项目管理软件的安装。你将使用 PostgreSQL 作为数据库后端,并使用 Apache 作为反向代理来搭建 OpenProject。

准备工作

在开始之前,请确保满足以下要求:

  • 一台至少配备 4GB 内存的 Debian 12 服务器
  • 一个拥有 sudo 权限的非 root 用户
  • 一个已指向你服务器 IP 地址的域名

让我们开始吧。

安装 OpenProject

OpenProject 是一款免费且开源的项目管理软件,同时支持传统与敏捷两种项目管理模式。它可以帮助你跟踪项目的整个生命周期。该软件支持 30 多种语言,并提供免费版和付费订阅版两种版本。

OpenProject 可以通过多种方式安装,例如使用包管理器或在 Kubernetes 等容器环境中安装。对于 Ubuntu、Debian、CentOS 等大多数 Linux 发行版,OpenProject 提供了二进制软件包,你可以通过包管理器轻松安装。

首先,使用以下命令为你的 Debian 系统安装基础依赖。输入 y 确认安装。

sudo apt install apt-transport-https ca-certificates wget gpg

在 Debian 12 上安装 OpenProject 项目管理平台

现在,运行下面的命令添加 OpenProject 仓库的 GPG 密钥。

wget -qO- https://dl.packager.io/srv/opf/openproject/key | gpg --dearmor > /etc/apt/trusted.gpg.d/packager-io.gpg

然后,使用以下命令为 Debian 12 版本添加 OpenProject 仓库。

wget -O /etc/apt/sources.list.d/openproject.list \
https://dl.packager.io/srv/opf/openproject/stable/13/installer/debian/12.repo

在 Debian 12 上安装 OpenProject 项目管理平台

添加 GPG 密钥和仓库后,运行以下命令更新你的 Debian 软件包列表。你将看到 OpenProject 仓库已被添加。

sudo apt update

在 Debian 12 上安装 OpenProject 项目管理平台

现在,你可以使用下面的 apt 命令将 OpenProject 软件包安装到 Debian 系统中。输入 Y 继续安装。

sudo apt install openproject

在 Debian 12 上安装 OpenProject 项目管理平台

安装完成后,你将看到如下提示信息。

在 Debian 12 上安装 OpenProject 项目管理平台

配置 OpenProject

现在你已经安装了 OpenProject,可以开始通过命令行对其进行配置。系统默认会创建 openproject 命令行工具,允许你从终端 shell 配置 OpenProject。

openproject 命令允许你以交互方式完成 OpenProject 的安装配置,你可以设置 PostgreSQL、Apache Web 服务器、Memcached,并配置 Git/SVN 集成。

要配置 OpenProject,请执行下面的 openproject 命令。这将以交互方式从 shell 完成 OpenProject 的配置。

sudo openproject configure

选择 OpenProject 版本为 default(默认版)。默认版用于通用项目管理,而 bim 版本则面向建筑行业等特定行业领域。

在 Debian 12 上安装 OpenProject 项目管理平台

选择 Install the new PostgreSQL(安装新的 PostgreSQL),将其作为 OpenProject 安装的数据库。

在 Debian 12 上安装 OpenProject 项目管理平台

当被询问时,选择 Install Apache web server(安装 Apache Web 服务器)。你将使用 Apache 作为 OpenProject 的反向代理。

在 Debian 12 上安装 OpenProject 项目管理平台

现在输入你的 OpenProject 安装的域名。

在 Debian 12 上安装 OpenProject 项目管理平台

安装路径保持留空。你将在根域名/子域名下安装 OpenProject。

在 Debian 12 上安装 OpenProject 项目管理平台

对于 SSL 配置,选择 Yes 或 No。你需要提供 SSL 证书的相关信息。

在 Debian 12 上安装 OpenProject 项目管理平台

跳过 Subversion 仓库集成。

在 Debian 12 上安装 OpenProject 项目管理平台

你也可以为 OpenProject 安装 Git 集成。

在 Debian 12 上安装 OpenProject 项目管理平台

输入 Git 仓库的路径目录。默认情况下,它将使用 /var/db/subversion/git 目录。

在 Debian 12 上安装 OpenProject 项目管理平台

Git CGI 后端路径保持默认即可。

在 Debian 12 上安装 OpenProject 项目管理平台

选择 Install memcached server(安装 memcached 服务器)以继续。

在 Debian 12 上安装 OpenProject 项目管理平台

现在输入你的 OpenProject 安装的管理员邮箱地址。

在 Debian 12 上安装 OpenProject 项目管理平台

然后,选择默认语言为 English(英语)。

在 Debian 12 上安装 OpenProject 项目管理平台

流程结束后,你将看到如下内容:

在 Debian 12 上安装 OpenProject 项目管理平台

通过下面的命令,你可以查看 PostgreSQL、Apache 和 Memcached 服务的状态。请确保这三个服务都在运行。

sudo systemctl status postgresql apache2 memcached

在 Debian 12 上安装 OpenProject 项目管理平台

最后,使用以下命令检查 OpenProject 相关服务。请确保所有服务都处于运行状态。

sudo systemctl status openproject openproject-web openproject-worker

在 Debian 12 上安装 OpenProject 项目管理平台

访问 OpenProject

打开你的网页浏览器,访问 http://project.howtoforge.local/login。你将看到 OpenProject 的登录页面。输入默认用户名 admin 和密码 admin,然后点击 Sign In(登录)。

在 Debian 12 上安装 OpenProject 项目管理平台

现在,将默认管理员密码修改为一个强度更高的新密码,然后点击 Save(保存)确认。

在 Debian 12 上安装 OpenProject 项目管理平台

流程完成后,你将看到类似如下的 OpenProject 仪表盘:

在 Debian 12 上安装 OpenProject 项目管理平台

你可以通过内置的演示项目,查看基于 Scrum 的传统与敏捷项目管理功能。