Hướng dẫn cài đặt Redmine trên Rocky Linux

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

Redmine rất linh hoạt và có thể được sử dụng cho các loại tổ chức và dự án khác nhau, từ tổ chức nhỏ, vừa đến 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 đề riêng, v.v. 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à 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 mọi hệ điều hành, chẳng hạn như Linux, Windows hoặc macOS. Nó hỗ trợ các cơ sở dữ liệu khác nhau, bao gồm PostgreSQL, MySQL và SQLite (tiêu chuẩn).

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

• Hỗ trợ nhiều dự án
• Mỗi dự án Wiki và Diễn đàn
• Quản lý tài liệu và tập tin
• Tin tức, 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ân vân

Đ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ụ theo dõi vấn đề và quản lý dự án 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 (Osidian xanh)
• Địa chỉ IP:  192.168.1.10
• Đặc quyền gốc
• 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 (Trình quản lý phiên bản Ruby)
• Thiết lập cơ sở dữ liệu PostgreSQL
• Cài đặt hành khách
• 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ắt đầu sử dụng hướng dẫn này, bạn nên hoàn tất quá trình cài đặt PostgreSQL trên hệ thống Rocky Linux.

Cài đặt phụ thuộc

Lúc đầu, bạn phải cài đặt các phần phụ thuộc sau. Tất cả các gói bên dưới đều cần thiết để cài đặt Redmine và đảm bảo thực thi tất cả các lệnh bên dưới bằng đặc quyền sudo hoặc root.

1. Thêm kho lưu trữ EPEL (Gói bổ sung dành 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 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

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

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

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ờ cài đặt phiên bản ổn định 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

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

rvm reload
rvm requirements run

Nếu tất cả quá 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.

Bây giờ hãy kiểm tra phiên bản Ruby có sẵn 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 một kết quả tương tự như dưới đây.

Chỉ có một phiên bản Ruby được cài đặt trên hệ thống của bạn,  Ruby 2.7.2 . Và nó hiệ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 để cài đặt Redmine.

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

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

Sau đó, bạn sẽ tạo cơ sở dữ liệu và người dùng PostgreSQL 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à đả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 trình bao PostgreSQL.

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

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ó sẵn 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 cấu hình sau vào nó. Và đả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 định cấu hình cơ sở dữ liệu cho Redmine, bạn sẽ cài đặt một số phần phụ thuộc của Ruby. Bạn phải chạy các lệnh sau trên thư mục cài đặt Redmine ‘ /var/www/redmine ‘.

Đầu tiên, cài đặt gói bằng lệnh Ruby gem bên dưới.

gem install bundler

Bây giờ hãy thực hiện lệnh ‘gói’ bên dưới để định 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'

Bây giờ cài đặt các gói phụ thuộc Ruby cho Redmine bằng lệnh bó 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 chút 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 hoàn tất quá trình cài đặt tất cả các phần phụ thuộc của Ruby, 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

5. Sau đó, 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

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

Cài đặt và cấu hình hành khách

Hành khách hoặc Phusion Hành khách là một 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 cho 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 phía sau máy chủ web hành khách và httpd.

Hành khách 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

2. Sau khi quá trình 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ắp làm và nhấn ‘ Enter ‘ khi bạn đọc tất cả các điểm về quá trình cài đặt.

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

Bây giờ trình cài đặt sẽ 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.

Mở shell thiết bị đầu cuối 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 chỉnh sửa nano.

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

Dán cấu hình hiển thị 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
   <IfModule mod_passenger.c>
     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
   </IfModule>

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

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 quá trình 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 kết quả tương tự như bên dưới.

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.

Định 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 quá trình 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

<VirtualHost *:80>
    ServerName redmine.example.io
    DocumentRoot "/var/www/redmine/public" 

    ErrorLog logs/redmine_error_log
    LogLevel warn

    <Directory "/var/www/redmine/public">
        Options Indexes ExecCGI FollowSymLinks
        Require all granted
        AllowOverride all
    </Directory>
</VirtualHost> 

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

Đối với cấu hình HTTPS Redmine, hãy sao chép và dán cấu hình sau. Và đả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 kích hoạt mô-đun mod_ssl của Apache để HTTPS hoạt động trên hệ thống của bạn.

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

<VirtualHost *:80>

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

</VirtualHost>

<VirtualHost *:443>
  ServerName redmine.example.io

  Protocols h2 http/1.1

  <If "%{HTTP_HOST} == 'www.redmine.example.io'">
    Redirect permanent / https://redmine.example.io/
  </If>

  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

  <Directory /var/www/redmine/public>
    Options Indexes ExecCGI FollowSymLinks
    Require all granted
    AllowOverride all
  </Directory>

</VirtualHost>

2. Tiếp theo, 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.

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ài đặt Redmine của bạn với đường dẫn  ‘/login ‘ trên thanh địa chỉ.

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 ”.

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ũ “ admin ” và nhập mật khẩu mạnh mới, sau đó nhấp vào “ Apply ”.

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

Chỉnh sửa tất cả thông tin cùng với chi tiết của bạn hoặc chỉ để 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.

Ở lần cài đặt đầu tiên, bạn phải tải ngôn ngữ mặc định cho quá trình 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.

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à đầu ra tương tự bạn sẽ nhận được.

Như bạn có thể 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.

Phần kết luận

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.