Redmine安装部署需要多少步骤和注意事项

Redmine 安装部署指南

Redmine 是一款灵活的项目管理工具,基于 Ruby on Rails 开发,支持多种数据库,并提供丰富的插件系统。本文将详细介绍 Redmine 的安装与部署,包括所需的环境配置、安装步骤以及注意事项与实用技巧。

环境准备

  • 操作系统:推荐使用 Ubuntu 22.04 或 CentOS 7/8
  • Ruby 版本:建议使用 Ruby 2.5 及以上版本
  • 数据库:MySQL 或 PostgreSQL
  • Web 服务器:Apache 或 Nginx

安装软件包

在开始安装之前,需要确保系统安装了一些必需的软件包。这些包包括 Ruby、Rails、数据库客户端、以及一些开发工具。

sudo apt update

sudo apt install -y build-essential libmysqlclient-dev libpq-dev libsqlite3-dev libxml2-dev libcurl4-openssl-dev libssl-dev git

安装 Ruby

使用 RVM(Ruby Version Manager)安装 Ruby

使用 RVM 安装 Ruby 可以方便管理 Ruby 的版本。

Redmine安装部署需要多少步骤和注意事项

sudo apt install -y gnupg2

curl -sSL https://get.rvm.io | bash -s stable --ruby

source ~/.rvm/scripts/rvm

rvm install 2.7.6

rvm use 2.7.6 --default

验证 Ruby 安装

ruby -v

确保输出的版本符合要求。

安装 Rails

安装 Rails 框架,确保 Ruby 和 Rails 的版本兼容。

gem install rails -v 6.1.4

安装数据库

安装 MySQL

sudo apt install -y mysql-server

sudo mysql_secure_installation

根据提示设置 root 密码并完成安全配置。

创建 Redmine 数据库

sudo mysql -u root -p

登录 MySQL 后,执行以下命令来创建数据库和用户:

CREATE DATABASE redmine CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

CREATE USER 'redmineuser'@'localhost' IDENTIFIED BY 'securepassword';

GRANT ALL PRIVILEGES ON redmine.* TO 'redmineuser'@'localhost';

FLUSH PRIVILEGES;

EXIT;

下载 Redmine

从官方 GitHub 仓库下载 Redmine 源代码。

cd /opt

sudo git clone https://github.com/redmine/redmine.git

cd redmine

sudo git checkout stable

配置 Redmine

安装依赖项

bundle install --without development test

配置数据库连接

编辑数据库配置文件。

cp config/database.yml.example config/database.yml

nano config/database.yml

在编辑器中修改内容为:

production:

adapter: mysql2

database: redmine

host: localhost

username: redmineuser

password: "securepassword"

encoding: utf8mb4

生成密钥

bundle exec rake generate_secret_token

数据库迁移

RAILS_ENV=production bundle exec rake db:migrate

RAILS_ENV=production bundle exec rake redmine:load_default_data

配置 Web 服务器

使用 Apache 部署 Redmine

sudo apt install -y apache2 libapache2-mod-passenger

创建 Apache 配置文件:

sudo nano /etc/apache2/sites-available/redmine.conf

添加以下配置:

<VirtualHost *:80>

ServerName yourdomain.com

DocumentRoot /opt/redmine/public

PassengerRuby /usr/bin/ruby

<Directory /opt/redmine/public>

Allow from all

Options -MultiViews

Require all granted

</Directory>

</VirtualHost>

启用配置并重启 Apache 服务:

sudo a2ensite redmine.conf

sudo systemctl restart apache2

使用 Nginx 部署 Redmine

sudo apt install -y nginx

创建 Nginx 配置文件:

sudo nano /etc/nginx/sites-available/redmine

添加以下内容:

server {

listen 80;

server_name yourdomain.com;

root /opt/redmine/public;

passenger_enabled on;

passenger_ruby /usr/bin/ruby;

location / {

try_files $uri $uri/index.html $uri.html @app;

}

location @app {

proxy_pass http://your_app;

}

}

启用配置并重启 Nginx 服务:

sudo ln -s /etc/nginx/sites-available/redmine /etc/nginx/sites-enabled/

sudo systemctl restart nginx

注意事项与实用技巧

  • 定期备份:建议定期备份数据库和文件,确保数据安全。
  • 插件管理:使用 gem 或将插件放入 plugins 目录中,并确认其兼容性。
  • 性能优化:考虑使用 Redis 或 Memcached 进行缓存,加速页面加载。
  • 安全设置:务必为数据库用户设置强密码,并限制访问权限。

测试与访问

完成所有配置后,通过浏览器访问您的网站:

http://yourdomain.com

使用默认管理员账户进行登录:

username: admin

password: admin

首次登录后,请务必修改管理员密码以确保系统安全。