如何在Debian 9上安装和配置Redmine

Redmine是一个免费的开源项目管理和问题跟踪应用程序。 它是跨平台和跨数据库的，建立在Ruby on Rails框架之上。

Redmine包括对多个项目，Wiki，问题跟踪系统，论坛，日历，电子邮件通知等的支持。

在本教程中，我们将向您展示如何在Debian 9服务器上安装和配置最新版本的Redmine，该服务器使用MySQL作为数据库后端，而Passenger + Nginx作为Ruby应用服务器。

先决条件

在继续本教程之前，请确保您已满足以下先决条件：

• 有一个域名指向您的服务器公用IP。 我们将使用 example.com 。以具有sudo特权的用户身份登录。已安装Nginx。已为您的域安装了SSL证书。

创建一个MySQL数据库

Redmine支持MySQL / MariaDB，Microsoft SQL Server，SQLite 3和PostgreSQL。 我们将使用MariaDB作为数据库后端。 确保您的计算机上至少安装了MySQL 5.7或MariaDB 10.3。

如果您的Debian服务器上未安装MariaDB或MySQL，则可以按照以下说明进行安装。

首先输入以下内容登录到MySQL控制台：

sudo mysql

运行以下SQL语句以创建一个新的数据库：

CREATE DATABASE redmine CHARACTER SET utf8mb4;

创建一个新的MySQL用户帐户并授予对数据库的访问权限：

GRANT ALL ON redmine.* TO 'redmine'@'localhost' IDENTIFIED BY 'change-with-strong-password'; 不要忘记 change-with-strong-password 带有强密码的更改。

完成后，通过键入以下内容从MariaDB控制台注销：

EXIT;

安装Ruby

在Debian上安装Ruby的最简单方法是使用 apt 软件包管理器：

通过键入以下命令安装Ruby：

sudo apt install ruby-full

在撰写本文时，Debian存储库中的版本为 2.3.3p222 ，最新版本的Redmine支持该版本。

安装Passenger和Nginx

Passenger是一款适用于Ruby，Node.js和Python的快速，轻量级的Web应用程序服务器，可以与Apache和Nginx集成。 我们将乘客安装为Nginx模块。

在继续以下步骤之前，请确保已安装Nginx。

安装必要的软件包以启用https存储库：

sudo apt install dirmngr gnupg apt-transport-https ca-certificates software-properties-common

导入存储库GPG密钥并启用Phusionpassenger存储库：

sudo apt-key adv --recv-keys --keyserver hkp://keyserver.ubuntu.com:80 561F9B9CAC40B2F7 sudo add-apt-repository 'deb https://oss-binaries.phusionpassenger.com/apt/passenger stretch main'

更新软件包列表，并使用以下命令安装Passenger Nginx模块：

sudo apt update sudo apt install libnginx-mod-http-passenger

在Debian上安装Redmine

首先安装构建Redmine所需的依赖项：

sudo apt install build-essential libmariadbclient-dev imagemagick libmagickwand-dev curl ruby-dev libxslt-dev libxml2-dev zlib1g-dev

在撰写本文时，Redmine的最新稳定版本为4.0.4。

在继续下一步之前，您应该检查Redmine下载页面以获取较新版本。

1.下载Redmine

使用以下curl命令下载Redmine存档：

sudo curl -L http://www.redmine.org/releases/redmine-4.0.4.tar.gz -o /tmp/redmine.tar.gz

下载完成后，解压缩存档并将其移至 /opt 目录：

cd /tmp sudo tar zxf /tmp/redmine.tar.gz sudo mv /tmp/redmine-4.0.4 /opt/redmine

2.配置Redmine数据库

复制Redmine示例配置文件：

sudo cp /opt/redmine/config/database.yml.example /opt/redmine/config/database.yml

使用文本编辑器打开文件：

sudo nano /opt/redmine/config/database.yml

搜索 production 部分，然后输入我们之前创建的MySQL数据库和用户信息：

/opt/redmine/config/database.yml

production: adapter: mysql2 database: redmine host: localhost username: redmine password: "change-with-strong-password" encoding: utf8

完成后，保存文件并退出编辑器。

3.安装Ruby依赖项

导航到redmine目录并安装bundler和其他Ruby依赖项：

cd /opt/redmine/ sudo gem install bundler --no-rdoc --no-ri sudo bundle install --without development test postgresql sqlite sudo gem install bundler --no-rdoc --no-ri sudo bundle install --without development test postgresql sqlite

4.生成密钥并迁移数据库

运行以下命令以生成密钥并迁移数据库：

cd /opt/redmine/ sudo bundle exec rake generate_secret_token sudo RAILS_ENV=production bundle exec rake db:migrate

5.设置正确的权限

Nginx以 www-data 用户和组身份运行。 通过发出以下chown命令来设置正确的权限：

sudo chown -R www-data: /opt/redmine/

配置Nginx

到目前为止，如果没有检查本教程的先决条件，那么您应该已经在系统上安装了带有SSL证书的Nginx。

打开文本编辑器并创建以下Nginx服务器块文件：

sudo nano /etc/nginx/sites-available/example.com /etc/nginx/sites-available/example.com

# Redirect HTTP -> HTTPS server { listen 80; server_name www.example.com example.com; include snippets/letsencrypt.conf; return 301 https://example.com$request_uri; } # Redirect WWW -> NON WWW server { listen 443 ssl http2; server_name www.example.com; ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem; ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem; include snippets/ssl.conf; return 301 https://example.com$request_uri; } server { listen 443 ssl http2; server_name example.com; root /opt/redmine/public; # SSL parameters ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem; ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem; include snippets/ssl.conf; include snippets/letsencrypt.conf; # log files access_log /var/log/nginx/example.com.access.log; error_log /var/log/nginx/example.com.error.log; passenger_enabled on; passenger_min_instances 1; client_max_body_size 10m; } 不要忘记用Redmine域替换example.com并为SSL证书文件设置正确的路径。 所有HTTP请求都将重定向到HTTPS。 本指南中创建了此配置中使用的摘录。

通过创建指向 sites-enabled 目录的符号链接来启用服务器块：

sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/

在重新启动Nginx服务之前，请进行测试以确保没有语法错误：

sudo nginx -t

如果没有错误，输出应如下所示：

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok nginx: configuration file /etc/nginx/nginx.conf test is successful

最后，通过键入以下内容来重新启动Nginx服务：

sudo systemctl restart nginx

访问Redmine

打开浏览器，键入您的域，并假设安装成功，将出现类似于以下的屏幕：

更改密码后，您将被重定向到用户帐户页面。

结论

您已在Debian系统上成功安装Redmine。 现在，您应该查看Redmine文档，并了解有关如何配置和使用Redmine的更多信息。

Debian Redmine红宝石MySQL Nginx