Cách cài đặt và cấu hình redmine trên Ubuntu 18.04

Redmine là một trong những công cụ phần mềm theo dõi vấn đề và quản lý dự án nguồn mở phổ biến nhất. Nó là nền tảng chéo và cơ sở dữ liệu chéo và được xây dựng dựa trên khung Ruby on Rails.

Redmine bao gồm hỗ trợ cho nhiều dự án, wiki, hệ thống theo dõi vấn đề, diễn đàn, lịch, thông báo email, và nhiều hơn nữa.

Hướng dẫn này mô tả cách cài đặt và định cấu hình phiên bản Redmine mới nhất trên máy chủ Ubuntu 18.04 bằng cách sử dụng MySQL làm cơ sở dữ liệu phụ trợ và Hành khách + Nginx làm máy chủ ứng dụng Ruby.

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

Hãy chắc chắn rằng bạn đã đáp ứng các điều kiện tiên quyết sau đây trước khi tiếp tục với hướng dẫn này:

• Bạn có một tên miền trỏ đến IP công cộng của máy chủ của bạn. Trong hướng dẫn này, chúng tôi sẽ sử dụng example.com . Bạn đã đăng nhập với tư cách là người dùng có quyền sudo. Bạn đã cài đặt Nginx bằng cách làm theo các hướng dẫn sau. Bạn đã cài đặt chứng chỉ SSL cho tên miền của mình. Bạn có thể cài đặt chứng chỉ SSL Encrypt SSL miễn phí bằng cách làm theo các hướng dẫn sau.

Tạo cơ sở dữ liệu MySQL

Redmine hỗ trợ MySQL / MariaDB, Microsoft SQL Server, SQLite 3 và PostgreSQL. Trong hướng dẫn này, chúng tôi sẽ sử dụng MySQL làm cơ sở dữ liệu.

Đăng nhập vào vỏ MySQL bằng cách gõ lệnh sau:

sudo mysql

Từ trong shell của MySQL, hãy chạy câu lệnh SQL sau để tạo cơ sở dữ liệu mới:

CREATE DATABASE redmine CHARACTER SET utf8mb4;

Tiếp theo, tạo tài khoản người dùng MySQL và cấp quyền truy cập vào cơ sở dữ liệu:

GRANT ALL ON redmine.* TO 'redmine'@'localhost' IDENTIFIED BY 'change-with-strong-password'; Đảm bảo bạn thay change-with-strong-password thay change-with-strong-password mạnh.

Sau khi hoàn tất, thoát khỏi bảng điều khiển mysql bằng cách gõ:

EXIT;

Cài đặt Ruby

Cách dễ nhất để cài đặt Ruby trên hệ thống Ubuntu của bạn là thông qua trình quản lý gói apt . Tại thời điểm viết bài, phiên bản trong kho Ubuntu là 2.5.1, đây là phiên bản ổn định mới nhất của Ruby.

Cài đặt Ruby bằng cách gõ:

sudo apt install ruby-full

Cài đặt hành khách và Nginx

Hành khách là một máy chủ ứng dụng web nhanh và nhẹ dành cho Ruby, Node.js và Python có thể được tích hợp với Apache và Nginx. Chúng tôi sẽ cài đặt Hành khách như một mô-đun Nginx.

Hãy chắc chắn rằng bạn đã làm theo các điều kiện tiên quyết và cài đặt Nginx trước khi tiếp tục các bước sau.

Bắt đầu bằng cách cài đặt các gói cần thiết:

sudo apt install dirmngr gnupg apt-transport-https ca-certificates

Nhập khóa GPG của kho lưu trữ và kích hoạt kho lưu trữ Phusionpasbah:

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 bionic main'

Khi kho apt được bật, hãy cập nhật danh sách các gói và cài đặt mô-đun Nginx của Hành khách với:

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

Cài đặt Redmine trên Ubuntu

Chúng tôi sẽ bắt đầu bằng cách cài đặt các phụ thuộc cần thiết để xây dựng Redmine:

sudo apt install build-essential libmysqlclient-dev imagemagick libmagickwand-dev

Tại thời điểm viết bài viết này, phiên bản ổn định mới nhất của Redmine là phiên bản 4.0.0.

Trước khi tiếp tục bước tiếp theo, bạn nên kiểm tra trang tải xuống Redmine để xem có phiên bản mới hơn không.

1. Đang tải xuống Redmine

Tải xuống kho lưu trữ Redmine bằng lệnh curl sau:

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

Khi quá trình tải xuống hoàn tất, giải nén tệp lưu trữ và chuyển nó vào thư mục /opt :

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

2. Cấu hình cơ sở dữ liệu Redmine

Bắt đầu bằng cách sao chép tệp cấu hình ví dụ Redmine:

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

Mở tệp bằng trình soạn thảo văn bản của bạn:

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

Tìm kiếm phần production và nhập cơ sở dữ liệu MySQL và thông tin người dùng chúng tôi đã tạo trước đây:

/opt/redmine/config/database.yml

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

Sau khi hoàn tất, lưu tệp và thoát khỏi trình chỉnh sửa.

3. Cài đặt phụ thuộc Ruby

Điều hướng đến thư mục redmine và cài đặt gói và các phụ thuộc Ruby khác:

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

4. Tạo khóa và di chuyển cơ sở dữ liệu

Chạy lệnh sau để tạo khóa và di chuyển cơ sở dữ liệu:

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

5. Đặt quyền chính xác

Nginx chạy như người dùng và nhóm www-data . Đặt quyền chính xác bằng cách ban hành lệnh chown sau:

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

Cấu hình Nginx

Đến bây giờ, bạn đã có Nginx với chứng chỉ SSL được cài đặt trên hệ thống của bạn, nếu không kiểm tra các điều kiện tiên quyết cho hướng dẫn này.

Mở trình soạn thảo văn bản của bạn và tạo tệp khối máy chủ Nginx sau:

sudo nano /etc/nginx/sites-available/example.com /etc/nginx/sites-av 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; } Đừng quên thay thế example.com bằng tên miền Redmine của bạn và đặt đường dẫn chính xác đến các tệp chứng chỉ SSL. Tất cả các yêu cầu HTTP sẽ được chuyển hướng đến HTTPS. Các đoạn được sử dụng trong cấu hình này được tạo trong hướng dẫn này.

Kích hoạt khối máy chủ bằng cách tạo một liên kết tượng trưng đến thư mục sites-enabled :

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

Trước khi khởi động lại dịch vụ Nginx, hãy kiểm tra để chắc chắn rằng không có lỗi cú pháp:

sudo nginx -t

Nếu không có lỗi, đầu ra sẽ trông như thế này:

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

Cuối cùng, khởi động lại dịch vụ Nginx bằng cách gõ:

sudo systemctl restart nginx

Truy cập Redmine

Mở trình duyệt của bạn, nhập tên miền của bạn và giả sử cài đặt thành công, một màn hình tương tự như sau sẽ xuất hiện:

Khi bạn thay đổi mật khẩu, bạn sẽ được chuyển hướng đến trang tài khoản người dùng.

Phần kết luận

Bạn đã cài đặt thành công Redmine trên hệ thống Ubuntu của bạn. Bây giờ bạn nên kiểm tra Tài liệu Redmine và tìm hiểu thêm về cách định cấu hình và sử dụng Redmine.

ubfox redmine ruby ​​mysql nginx