Cách cài đặt Redmine trên Rocky Linux

[theanh]

Redmine là một chương trình quản lý dự án và theo dõi vấn đề miễn phí và mã nguồn mở. Đây là phần mềm ứng dụng dựa trên web được viết chủ yếu bằng Ruby on Rails. Nó là nền tảng chéo và hỗ trợ nhiều cơ sở dữ liệu và ngôn ngữ.

Redmine linh hoạt và có thể được sử dụng cho nhiều loại tổ chức và dự án khác nhau, từ các tổ chức nhỏ đến vừa và lớn. Với Redmine, bạn có thể tạo và quản lý nhiều dự án, mỗi dự án có wiki, diễn đàn, theo dõi vấn đề, v.v. riêng. Bạn cũng có thể tạo các vai trò tùy chỉnh phù hợp với nhu cầu của tổ chức mình và nhiều hơn thế nữa.

Redmine được phát hành theo giấy phép GNU GPL v2 và có thể được cài đặt trên bất kỳ hệ điều hành nào, chẳng hạn như Linux, Windows hoặc macOS. Nó hỗ trợ nhiều cơ sở dữ liệu khác nhau, bao gồm PostgreSQL, MySQL và SQLite (chuẩn).

Dưới đây là các tính năng chính của Redmine:

• Hỗ trợ nhiều dự án
• Wiki và Diễn đàn theo từng dự án
• Quản lý tài liệu và tệp
• Tin tức và nguồn cấp dữ liệu và thông báo qua email
• Theo dõi thời gian
• Hỗ trợ nhiều SCM (SVN, Git, CVS, Mercurial, Bazaar)
• Cung cấp khoảng 49 ngôn ngữ hỗ trợ
• Hỗ trợ xác thực LDAP
• v.v.

Điều kiện tiên quyết​

Trong hướng dẫn này, bạn sẽ tìm hiểu cách triển khai công cụ quản lý dự án và theo dõi sự cố Redmine trên hệ thống Rocky Linux với cơ sở dữ liệu PostgreSQL và máy chủ web Apache/httpd.

Dưới đây là môi trường cho ví dụ này:

• Hệ điều hành: Rocky Linux 8.4 (Green Obisidian)
• Địa chỉ IP: 192.168.1.10
• Quyền root
• Tên miền: redmine.example.com

Mục tiêu bạn sẽ học trong hướng dẫn này:

• Cài đặt Ruby bằng RVM (Ruby Version Manager)
• Thiết lập cơ sở dữ liệu PostgreSQL
• Cài đặt Passenger
• Thiết lập máy chủ ảo Apache/httpd cho Redmine (có hoặc không có SSL)
• Cài đặt và cấu hình Redmine

Trước khi bạn bắt đầu sử dụng hướng dẫn này, bạn nên hoàn tất cài đặt PostgreSQL trên hệ thống Rocky Linux.

Cách cài đặt PostgreSQL trên Rocky Linux

Cài đặt các dependency​

Trước tiên, bạn phải cài đặt các dependency sau. Tất cả các gói bên dưới đều cần thiết cho quá trình cài đặt Redmine và đảm bảo thực hiện tất cả các lệnh bên dưới bằng quyền sudo hoặc root.

1. Thêm kho lưu trữ EPEL (Gói bổ sung cho Enterprise Linux) vào hệ thống của bạn.

sudo dnf install epel-release -y

2. Sau khi cài đặt EPEL hoàn tất, hãy cài đặt các gói bằng lệnh DNF bên dưới.

sudo dnf install curl gpg gnupg2 gcc gcc-c++ make patch autoconf automake bison ImageMagick libffi-devel libtool patch redhat-rpm-config readline-devel postgresql-devel zlib-devel openssl-devel -y

3. Tiếp theo, cài đặt máy chủ web apache/httpd trên hệ thống Rocky Linux của bạn bằng cách thực hiện lệnh DNF như bên dưới.

sudo dnf install libcurl-devel httpd-devel httpd apr-devel apr-util-devel -y

Nếu quá trình cài đặt các gói httpd hoàn tất, hãy khởi động và kích hoạt dịch vụ httpd.

sudo systemctl enable --now httpd

Bây giờ hãy xác minh httpd và đảm bảo rằng nó đang hoạt động và đang chạy.

sudo systemctl status httpd

data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22214%22%3E%3C/svg%3E


Các gói cơ bản để cài đặt Redmine đã được cài đặt, chuyển sang bước tiếp theo để cài đặt RVM và Ruby.

Cài đặt RVM và Ruby​

Các Phiên bản mới nhất của Redmine yêu cầu Ruby phiên bản 2.7 để cài đặt. Trong bước này, bạn sẽ cài đặt Ruby phiên bản 2.7 trên hệ thống Rocky Linux bằng RVM hoặc Ruby Version Manager.

Vì vậy, bạn sẽ cài đặt RVM, sau đó cài đặt Ruby.

1. Trước tiên, hãy nhập khóa GPG của nhà phát triển rvm vào hệ thống của bạn.

curl -sSL https://rvm.io/mpapis.asc | gpg2 --import -
curl -sSL https://rvm.io/pkuczynski.asc | gpg2 --import -

2. Bây giờ hãy cài đặt phiên bản ổn định của rvm và tải môi trường rvm bằng các lệnh sau.

curl -L get.rvm.io | bash -s stable
source /etc/profile.d/rvm.sh

data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22369%22%3E%3C/svg%3E


Sau đó, tải lại nguồn rvm một lần nữa và cài đặt tất cả các yêu cầu hệ thống cho rvm.

rvm reload
rvm requirements run

data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22217%22%3E%3C/svg%3E


Nếu tất cả các quy trình đã hoàn tất, bạn đã sẵn sàng cài đặt Ruby.
3. Thực hiện lệnh rvm bên dưới để cài đặt Ruby phiên bản 2.7 trên hệ thống Rocky Linux.

rvm install 2.7

Đợi quá trình cài đặt hoàn tất.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22345%22%3E%3C/svg%3E


Bây giờ hãy kiểm tra phiên bản Ruby khả dụng trên hệ thống của bạn và kiểm tra phiên bản Ruby hiện tại trên hệ thống của bạn.

rvm list
ruby --version

Và bạn sẽ thấy kết quả tương tự như bên dưới.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22285%22%3E%3C/svg%3E


Chỉ có một phiên bản Ruby được cài đặt trên hệ thống của bạn, đó là ruby 2.7.2. Và hiện tại nó đang được sử dụng trên hệ thống của bạn.

Bây giờ hãy chuyển sang giai đoạn tiếp theo để thiết lập cơ sở dữ liệu PostgreSQL cho cài đặt Redmine.

Thiết lập cơ sở dữ liệu PostgreSQL​

Trước khi đi tiếp, hãy đảm bảo bạn đã hoàn tất cài đặt PostgreSQL như bên dưới.

Cách cài đặt PostgreSQL trên Rocky Linux

Sau đó, bạn sẽ tạo cơ sở dữ liệu PostgreSQL và người dùng mới cho Redmine.

1. Đăng nhập vào shell PostgreSQL bằng lệnh sau.

sudo -u postgres psql

2. Tạo người dùng PostgreSQL mới 'redmine' và cơ sở dữ liệu 'redminedb' bằng cách sử dụng truy vấn sau. Và hãy đảm bảo thay đổi mật khẩu bằng mật khẩu mạnh của bạn.

CREATE ROLE redmine LOGIN ENCRYPTED PASSWORD 'StrongPasswordRedmine' NOINHERIT VALID UNTIL 'infinity';
CREATE DATABASE redminedb WITH ENCODING='UTF8' OWNER=redmine;

Nhập '\q' và nhấn 'Enter' để thoát khỏi shell PostgreSQL.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22192%22%3E%3C/svg%3E


Bây giờ bạn đã sẵn sàng cài đặt Redmine trên hệ thống của bạn.

Cài đặt và cấu hình Redmine​

Đối với bước này, bạn sẽ cài đặt Redmine phiên bản 4.2.3, đây là phiên bản mới nhất tại thời điểm này. Bản cài đặt Redmine sẽ có tại '/var/www/redmine'.

1. Thay đổi thư mục làm việc hiện tại thành '/var/www' và tải xuống mã nguồn Redmine 4.2.3.

cd /var/www/
wget https://www.redmine.org/releases/redmine-4.2.3.tar.gz

Bây giờ hãy giải nén mã nguồn Redmine và đổi tên thư mục thành 'redmine'.

tar -xzvf redmine-4.2.3.tar.gz
mv redmine-*/ redmine

2. Tiếp theo, bạn sẽ tạo cấu hình cơ sở dữ liệu Redmine mới.

Thay đổi thư mục làm việc của bạn thành thư mục '/var/www/redmine'.

export REDMINE=/var/www/redmine
cd $REDMINE

Tạo cấu hình cơ sở dữ liệu mới 'config/database.yml' bằng trình soạn thảo nano.

nano config/database.yml

Sao chép và dán nội dung sau cấu hình vào đó. Và hãy đảm bảo thay đổi tên cơ sở dữ liệu, người dùng và mật khẩu bằng thông tin của bạn.

production:
 adapter: postgresql
 database: redminedb
 host: localhost
 username: redmine
 password: "StrongPasswordRedmine"
 encoding: utf8

Lưu cấu hình và thoát.

3. Sau khi cấu hình cơ sở dữ liệu cho Redmine, bạn sẽ cài đặt một số phụ thuộc ruby. Bạn phải chạy các lệnh sau trên thư mục cài đặt Redmine '/var/www/redmine'.

Trước tiên, cài đặt bundler bằng lệnh ruby gem bên dưới.

gem install bundler

Bây giờ hãy thực thi lệnh 'bundle' bên dưới để cấu hình cài đặt Redmine của bạn.

bundle config set --local path 'vendor/bundle'
bundle config set --local without 'development test'

data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22405%22%3E%3C/svg%3E


Bây giờ hãy cài đặt các gói phụ thuộc ruby cho Redmine bằng lệnh bundle bên dưới.

bundle install

Tùy thuộc vào kết nối internet và máy/hệ thống của bạn, lệnh sẽ mất một khoảng thời gian. Nếu bạn không gặp bất kỳ lỗi nào, hãy chuyển sang bước tiếp theo.

4. Sau khi cài đặt tất cả các phụ thuộc của Ruby hoàn tất, hãy tạo mã thông báo bí mật và di chuyển cơ sở dữ liệu bằng lệnh sau.

bundle exec rake generate_secret_token
RAILS_ENV=production bundle exec rake db:migrate

data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22210%22%3E%3C/svg%3E


5. Sau đó, hãy thay đổi quyền sở hữu thư mục cài đặt Redmine thành người dùng 'apache'.

sudo chown -R apache:apache $REDMINE

Quá trình cài đặt và cấu hình Redmine đã hoàn tất, hãy chuyển sang bước tiếp theo để thiết lập máy chủ web httpd và hành khách.

Cài đặt và cấu hình Passenger​

Passenger hoặc Phusion Passenger là máy chủ ứng dụng web được viết bằng Ruby. Trong môi trường sản xuất, nó thường được sử dụng làm giao diện người dùng của các ứng dụng Rails của bạn. Và đối với hướng dẫn này, Redmine của bạn sẽ chạy sau máy chủ web Passenger và httpd.

Passenger có thể được cài đặt thông qua kho lưu trữ RubyGem. Và nó cũng có thể được tích hợp với máy chủ web Apache/httpd và Nginx để xử lý các ứng dụng Ruby, bao gồm cả Rails.

1. Để cài đặt hành khách trên toàn hệ thống, hãy thực hiện lệnh gem bên dưới

gem install passenger

data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22269%22%3E%3C/svg%3E


2. Sau khi cài đặt hành khách hoàn tất, hãy thực hiện lệnh sau để cài đặt mô-đun Apache hành khách.

passenger-install-apache2-module

Trình cài đặt sẽ mô tả tất cả những gì bạn sẽ làm và nhấn 'Enter' khi bạn đọc tất cả các điểm về cài đặt.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22364%22%3E%3C/svg%3E


Chọn 'Ruby' làm ứng dụng của bạn và nhấn 'Enter' để tiếp tục.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22749%22%20height=%22277%22%3E%3C/svg%3E


Bây giờ trình cài đặt yêu cầu bạn thêm một số cấu hình vào Apache/httpd như bạn có thể thấy trên ảnh chụp màn hình bên dưới.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22228%22%3E%3C/svg%3E


Mở shell terminal mới, kết nối với máy chủ của bạn, sau đó tạo cấu hình httpd mới '/etc/httpd/conf.d/passenger.conf' bằng trình soạn thảo nano.

nano /etc/httpd/conf.d/passenger.conf

Dán cấu hình hiển thị trên màn hình của bạn. Dưới đây là cấu hình từ ảnh chụp màn hình ở trên.

LoadModule passenger_module /usr/local/rvm/gems/ruby-2.7.2/gems/passenger-6.0.12/buildout/apache2/mod_passenger.so
 
 PassengerRoot /usr/local/rvm/gems/ruby-2.7.2/gems/passenger-6.0.12
 PassengerDefaultRuby /usr/local/rvm/gems/ruby-2.7.2/wrappers/ruby

Lưu cấu hình và thoát.

Tiếp theo, khởi động lại dịch vụ httpd để áp dụng cấu hình mới.

sudo systemctl restart httpd

data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22280%22%3E%3C/svg%3E


Sau đó quay lại shell trước đó, rồi nhấn 'Enter' để tiếp tục.

Sau đó, trình cài đặt sẽ kiểm tra cài đặt mô-đun apache và đảm bảo bạn không gặp bất kỳ lỗi nào.

Nếu bạn không gặp bất kỳ lỗi nào, bạn sẽ thấy đầu ra tương tự như bên dưới.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22235%22%3E%3C/svg%3E


Quá trình cài đặt Passenger và mô-đun Apache 2 của nó đã hoàn tất. Và bạn đã sẵn sàng thiết lập máy chủ ảo httpd cho Redmine.

Cấu hình httpd cho Redmine​

Trong bước này, bạn sẽ tạo cấu hình máy chủ ảo httpd mới cho cài đặt Redmine của mình.

1. Tạo cấu hình máy chủ ảo mới '/etc/httpd/conf.d/redmine.conf' bằng trình chỉnh sửa nano.

nano /etc/httpd/conf.d/redmine.conf

Sao chép và dán cấu hình sau và đảm bảo thay đổi tên miền bằng tên miền của bạn.

PassengerRuby /usr/local/rvm/gems/ruby-2.7.2/wrappers/ruby


 ServerName redmine.example.io
 DocumentRoot "/var/www/redmine/public" 

 ErrorLog logs/redmine_error_log
 LogLevel warn

 
 Options Indexes ExecCGI FollowSymLinks
 Require all granted
 AllowOverride all

Lưu cấu hình và thoát.

Đối với Redmine HTTPS cấu hình, sao chép và dán cấu hình sau. Và hãy đảm bảo thay đổi tên miền và đường dẫn SSL bằng thông tin chi tiết của bạn. Ngoài ra, đừng quên bật mô-đun Apache mod_ssl để HTTPS hoạt động trên hệ thống của bạn.

PassengerRuby /usr/local/rvm/gems/ruby-2.7.2/wrappers/ruby



 ServerName redmine.example.io
 Redirect permanent / https://redmine.example.io/




 ServerName redmine.example.io

 Protocols h2 http/1.1

 
 Redirect permanent / https://redmine.example.io/
 

 DocumentRoot "/var/www/redmine/public" 
 
 ErrorLog /var/log/httpd/redmine.example.io-error.log
 CustomLog /var/log/httpd/redmine.example.io-access.log combined

 SSLEngine On
 SSLCertificateFile /etc/letsencrypt/live/redmine.example.io/fullchain.pem
 SSLCertificateKeyFile /etc/letsencrypt/live/redmine.example.io/privkey.pem

 
 Options Indexes ExecCGI FollowSymLinks
 Require all granted
 AllowOverride all

2. Tiếp theo, hãy xác minh cấu hình httpd và đảm bảo không có lỗi. Sau đó khởi động lại dịch vụ httpd để áp dụng cấu hình máy chủ ảo mới.

apachectl configtest
sudo systemctl restart httpd

Bây giờ bạn đã sẵn sàng truy cập cài đặt Redmine của mình.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22240%22%3E%3C/svg%3E

Xác minh cài đặt Redmine​

Mở trình duyệt web của bạn và nhập tên miền của cài đặt Redmine của bạn với đường dẫn '/login' trên thanh địa chỉ.

https://redmine.example.io/login

1. Trên trang đăng nhập Redmine, nhập người dùng mặc định 'admin' và mật khẩu 'admin', sau đó nhấp vào nút 'Đăng nhập'.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22258%22%3E%3C/svg%3E


2. Bây giờ bạn phải đặt lại mật khẩu quản trị viên mặc định.

Nhập mật khẩu cũ là 'admin', rồi nhập mật khẩu mạnh mới, sau đó nhấp vào 'Áp dụng'.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22242%22%3E%3C/svg%3E


3. Và bạn sẽ thấy thông tin chi tiết về tài khoản của mình.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22385%22%3E%3C/svg%3E


Chỉnh sửa tất cả thông tin bằng thông tin chi tiết của bạn hoặc để nguyên mặc định, sau đó nhấp vào nút 'Lưu'.

4. Và bạn sẽ thấy trang quản trị Redmine như bên dưới.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22386%22%3E%3C/svg%3E


Khi cài đặt lần đầu, bạn phải tải ngôn ngữ mặc định cho cài đặt Redmine của mình.

Chọn ngôn ngữ của bạn và nhấp vào nút 'Tải cấu hình mặc định'.

5. Trên menu bên trái, nhấp vào menu 'Người dùng' để xem tất cả người dùng đã đăng ký trên Redmine của bạn.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22312%22%3E%3C/svg%3E


6. Bây giờ hãy chuyển đến menu 'Thông tin' để xem tất cả thông tin chi tiết về cài đặt Redmine của bạn.

Dưới đây là kết quả tương tự mà bạn sẽ nhận được.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22341%22%3E%3C/svg%3E


Như bạn thấy, quá trình cài đặt Redmine đã hoàn tất. Bạn vừa cài đặt Redmine phiên bản 4.2.3 ổn định với Ruby 2.7 và cơ sở dữ liệu PostgreSQL trên môi trường sản xuất.

Kết luận​

Xin chúc mừng! Bạn đã học cách cài đặt Redmine với cơ sở dữ liệu PostgreSQL và máy chủ web Apache/httpd trên hệ thống Rocky Linux. Ngoài ra, bạn đã học cách cài đặt Phusion Passenger và cách tích hợp nó với máy chủ web Apache.

Đối với bước tiếp theo, bạn có thể thêm các plugin bổ sung vào cài đặt Redmine của mình và thêm máy chủ SMTP, v.v.